@cap-js/change-tracking 2.0.0-beta.3 → 2.0.0-beta.5

package/CHANGELOG.md

@@ -4,7 +4,7 @@ All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 The format is based on [Keep a Changelog](http://keepachangelog.com/).
 
-## Version 2.0.0-beta.4 - tbd
+## Version 2.0.0-beta.6 - tbd
 
 ### Added
 
@@ -12,6 +12,21 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/).
 
 ### Changed
 
+## Version 2.0.0-beta.5 - 17.03.26
+
+### Added
+- Support dynamic localized label lookup, meaning if for example a property is change tracked and its change tracking label (@changelog : [<association>.<localized_prop>]) points to one localized property from its code list entity, the label is dynamically fetched when the change is read based on the users locale.
+
+### Fixed
+- Postgres considers `disable*Tracking` for children changes
+- Human-readable `@changelog` annotation supports combination of direct entity elements and association elements
+
+## Version 2.0.0-beta.4 - 16.03.26
+
+### Added
+
+- Tracked Date, DateTime, Time and Timestamp properties are now correctly formatted again.
+- If a tracked property is annotated with `@Common.Timezone` the changelog now considers the Timezone as well.
 
 ## Version 2.0.0-beta.3 - 13.03.26
 

package/README.md

@@ -177,12 +177,44 @@ customer @changelog: [customer.name];
 
 <img width="1300" alt="change-history-value-hr" src="_assets/changes-value-hr-wbox.png">
 
+#### Localized values
+If a human-readable value is annotated for the changelog, it will be localized.
+
+```cds
+extend Incidents with elements {
+  status: Association to one Status @changelog: [status.descr];
+}
+
+entity Status {
+  key code: String(1);
+      descr: localized String(20);
+}
+```
+
+By default the value label stored for the change is localized in the language of the user who caused the change. Meaning if a German speaking user changes the status, the human-readable value would be by default in German.
+
+In cases, like above, where the human-readable value only consists of one field, targets a localized property and goes along the (un-)managed association, a dynamic human-readable value is used, meaning if an English-speaking user looks at the changes, the value label will be shown in English, for a French-speaking user in French and so on.
+
 ### Tracing any kind of change
 
 Change tracking is implemented with Database triggers and supports HANA Cloud, SQLite, Postgres and H2.
 
 Leveraging database triggers means any change will be tracked no matter how it is represented in the service. Thus tracking changes made via unions, or via views with joins will still work.
 
+#### Tracking datetime fields with a fixed time zone
+
+The plugin supports tracking datetime field changes when the field has a time zone annotated.
+
+```cds
+extend Incidents with elements {
+  closedAt : DateTime @changelog @Common.Timezone : 'Europe/Berlin';
+  openedAt : DateTime @changelog @Common.Timezone : openedTimeZone;
+  openedTimeZone : String @Common.IsTimezone;
+}
+```
+
+In both cases the plugin will show the annotated time zone for change values in changes for the two fields. In the second case the time zone is dynamically fetched and modifications to the time zone field will also reflect in the change records for that field.
+
 ## Advanced Options
 
 ### Altered table view

package/cds-plugin.js

@@ -1,6 +1,6 @@
 const cds = require('@sap/cds');
 
-const { enhanceModel } = require('./lib/model-enhancer.js');
+const { enhanceModel } = require('./lib/csn-enhancements');
 const { registerSessionVariableHandlers } = require('./lib/skipHandlers.js');
 const { deploySQLiteTriggers } = require('./lib/sqlite/register.js');
 const { registerPostgresCompilerHook, deployPostgresLabels } = require('./lib/postgres/register.js');

package/index.cds

@@ -42,9 +42,9 @@ view ChangeView as
     on  modificationI18n.ID     = change.modification
     and modificationI18n.locale = $user.locale
   {
-    key change.ID                                     @UI.Hidden,
-        change.parent                  : redirected to ChangeView,
-        change.children                : redirected to ChangeView,
+    key change.ID                                               @UI.Hidden,
+        change.parent                            : redirected to ChangeView,
+        change.children                          : redirected to ChangeView,
         change.attribute,
         change.valueChangedFrom,
         change.valueChangedTo,
@@ -63,7 +63,7 @@ view ChangeView as
                   ID     = change.attribute
               and locale = 'en'
           ), change.attribute
-        )    as attributeLabel         : String(15)   @title: '{i18n>Changes.attribute}',
+        )    as attributeLabel                   : String(15)   @title: '{i18n>Changes.attribute}',
         COALESCE(
           entityI18n.text, (
             select text from i18nKeys
@@ -71,7 +71,7 @@ view ChangeView as
                   ID     = change.entity
               and locale = 'en'
           ), change.entity
-        )    as entityLabel            : String(24)   @title: '{i18n>Changes.entity}',
+        )    as entityLabel                      : String(24)   @title: '{i18n>Changes.entity}',
         COALESCE(
           modificationI18n.text, (
             select text from i18nKeys
@@ -79,24 +79,152 @@ view ChangeView as
                   ID     = change.modification
               and locale = 'en'
           ), change.modification
-        )    as modificationLabel      : String(16)   @title: '{i18n>Changes.modification}',
+        )    as modificationLabel                : String(16)   @title: '{i18n>Changes.modification}',
         COALESCE(
           change.valueChangedFromLabel, change.valueChangedFrom
-        )    as valueChangedFromLabel  : String(5000) @(
-                                           title: '{i18n>Changes.valueChangedFrom}',
-                                           UI.MultiLineText
-                                         ),
+        )    as valueChangedFromLabel            : String(5000) @(
+                                                     title: '{i18n>Changes.valueChangedFrom}',
+                                                     UI.MultiLineText
+                                                   ),
+        (
+          case
+            when valueDataType = 'cds.DateTime'
+                 then COALESCE(
+                        change.valueChangedFromLabel, change.valueChangedFrom
+                      )
+            else null
+          end
+        )    as valueChangedFromLabelDateTime    : DateTime     @(title: '{i18n>Changes.valueChangedFrom}',
+                                                   ),
+        (
+          case
+            when valueDataType = 'cds.DateTime' or valueDataType = 'cds.Timestamp'
+                 then COALESCE(
+                        change.valueChangedFromLabel, change.valueChangedFrom
+                      )
+            else null
+          end
+        )    as valueChangedFromLabelDateTimeWTZ : DateTime     @(
+                                                     title          : '{i18n>Changes.valueChangedFrom}',
+                                                     Common.Timezone: valueTimeZone
+                                                   ),
+        (
+          case
+            when valueDataType = 'cds.Time'
+                 then COALESCE(
+                        change.valueChangedFromLabel, change.valueChangedFrom
+                      )
+            else null
+          end
+        )    as valueChangedFromLabelTime        : Time         @(title: '{i18n>Changes.valueChangedFrom}',
+                                                   ),
+        (
+          case
+            when valueDataType = 'cds.Date'
+                 then COALESCE(
+                        change.valueChangedFromLabel, change.valueChangedFrom
+                      )
+            else null
+          end
+        )    as valueChangedFromLabelDate        : Date         @(title: '{i18n>Changes.valueChangedFrom}',
+                                                   ),
+        (
+          case
+            when valueDataType = 'cds.Timestamp'
+                 then COALESCE(
+                        change.valueChangedFromLabel, change.valueChangedFrom
+                      )
+            else null
+          end
+        )    as valueChangedFromLabelTimestamp   : Timestamp    @(title: '{i18n>Changes.valueChangedFrom}',
+                                                   ),
+        (
+          case
+            when valueDataType = 'cds.Decimal'
+                 then COALESCE(
+                        change.valueChangedFromLabel, change.valueChangedFrom
+                      )
+            else null
+          end
+        )    as valueChangedFromLabelDecimal     : Decimal      @(title: '{i18n>Changes.valueChangedFrom}',
+                                                   ),
         COALESCE(
           change.valueChangedToLabel, change.valueChangedTo
-        )    as valueChangedToLabel    : String(5000) @(
-                                           title: '{i18n>Changes.valueChangedTo}',
-                                           UI.MultiLineText
-                                         ),
+        )    as valueChangedToLabel              : String(5000) @(
+                                                     title: '{i18n>Changes.valueChangedTo}',
+                                                     UI.MultiLineText
+                                                   ),
+        (
+          case
+            when valueDataType = 'cds.DateTime'
+                 then COALESCE(
+                        change.valueChangedToLabel, change.valueChangedTo
+                      )
+            else null
+          end
+        )    as valueChangedToLabelDateTime      : DateTime     @(title: '{i18n>Changes.valueChangedTo}',
+                                                   ),
+        (
+          case
+            when valueDataType = 'cds.DateTime' or valueDataType = 'cds.Timestamp'
+                 then COALESCE(
+                        change.valueChangedFromLabel, change.valueChangedTo
+                      )
+            else null
+          end
+        )    as valueChangedToLabelDateTimeWTZ   : DateTime     @(
+                                                     title          : '{i18n>Changes.valueChangedTo}',
+                                                     Common.Timezone: valueTimeZone
+                                                   ),
+        (
+          case
+            when valueDataType = 'cds.Time'
+                 then COALESCE(
+                        change.valueChangedToLabel, change.valueChangedTo
+                      )
+            else null
+          end
+        )    as valueChangedToLabelTime          : Time         @(title: '{i18n>Changes.valueChangedTo}',
+                                                   ),
+        (
+          case
+            when valueDataType = 'cds.Date'
+                 then COALESCE(
+                        change.valueChangedToLabel, change.valueChangedTo
+                      )
+            else null
+          end
+        )    as valueChangedToLabelDate          : Date         @(title: '{i18n>Changes.valueChangedTo}',
+                                                   ),
+        (
+          case
+            when valueDataType = 'cds.Timestamp'
+                 then COALESCE(
+                        change.valueChangedToLabel, change.valueChangedTo
+                      )
+            else null
+          end
+        )    as valueChangedToLabelTimestamp     : Timestamp    @(title: '{i18n>Changes.valueChangedTo}',
+                                                   ),
+        (
+          case
+            when valueDataType = 'cds.Decimal'
+                 then COALESCE(
+                        change.valueChangedToLabel, change.valueChangedTo
+                      )
+            else null
+          end
+        )    as valueChangedToLabelDecimal       : Decimal      @(title: '{i18n>Changes.valueChangedTo}',
+                                                   ),
+        null as valueTimeZone                    : String       @(
+                                                     UI.Hidden,
+                                                     Common.IsTimezone
+                                                   ),
         // For the hierarchy
-        null as LimitedDescendantCount : Int16        @UI.Hidden,
-        null as DistanceFromRoot       : Int16        @UI.Hidden,
-        null as DrillState             : String       @UI.Hidden,
-        null as LimitedRank            : Int16        @UI.Hidden,
+        null as LimitedDescendantCount           : Int16        @UI.Hidden,
+        null as DistanceFromRoot                 : Int16        @UI.Hidden,
+        null as DrillState                       : String       @UI.Hidden,
+        null as LimitedRank                      : Int16        @UI.Hidden,
   };
 
 entity i18nKeys {
@@ -105,7 +233,7 @@ entity i18nKeys {
       text   : String(5000);
 }
 
-// Dummy table necessary for HANA triggers
+// Dummy table necessary for HANA triggers because DUMMY cannot be used in HDI
 @cds.persistence.skip
 entity CHANGE_TRACKING_DUMMY {
   key X : String(5);
@@ -174,11 +302,15 @@ annotate ChangeView with @(UI: {
       @UI.Importance: #Medium
     },
     {
-      Value         : valueChangedToLabel,
+      $Type         : 'UI.DataFieldForAnnotation',
+      Target        : '@UI.FieldGroup#valueChangedTo',
+      Label         : '{i18n>Changes.valueChangedTo}',
       @UI.Importance: #High
     },
     {
-      Value         : valueChangedFromLabel,
+      $Type         : 'UI.DataFieldForAnnotation',
+      Target        : '@UI.FieldGroup#valueChangedFrom',
+      Label         : '{i18n>Changes.valueChangedFrom}',
       @UI.Importance: #High
     },
     {
@@ -191,13 +323,103 @@ annotate ChangeView with @(UI: {
     },
   ],
   DeleteHidden                        : true,
+  FieldGroup #valueChangedFrom        : {
+    Label: '{i18n>Changes.valueChangedFrom}',
+    Data : [
+      {
+        Value     : valueChangedFromLabel,
+        @UI.Hidden: ($self.valueDataType = 'cds.Decimal'
+        or           $self.valueDataType = 'cds.DateTime'
+        or           $self.valueDataType = 'cds.Date'
+        or           $self.valueDataType = 'cds.Time'
+        or           $self.valueDataType = 'cds.Timestamp')
+      },
+      {
+        Value     : valueChangedFromLabelDateTime,
+        @UI.Hidden: ($self.valueDataType != 'cds.DateTime'
+        or           $self.valueTimeZone != null)
+      },
+      {
+        Value     : valueChangedFromLabelDateTimeWTZ,
+        @UI.Hidden: ($self.valueDataType != 'cds.DateTime'
+        or           $self.valueTimeZone =  null)
+      },
+      {
+        Value     : valueChangedFromLabelDate,
+        @UI.Hidden: ($self.valueDataType != 'cds.Date')
+      },
+      {
+        Value     : valueChangedFromLabelTime,
+        @UI.Hidden: ($self.valueDataType != 'cds.Time')
+      },
+      {
+        Value     : valueChangedFromLabelTimestamp,
+        @UI.Hidden: ($self.valueDataType != 'cds.Timestamp')
+      },
+      {
+        Value     : valueChangedFromLabelDecimal,
+        @UI.Hidden: ($self.valueDataType != 'cds.Decimal')
+      }
+    ]
+  },
+  FieldGroup #valueChangedTo          : {
+    Label: '{i18n>Changes.valueChangedTo}',
+    Data : [
+      {
+        Value     : valueChangedToLabel,
+        @UI.Hidden: ($self.valueDataType = 'cds.Decimal'
+        or           $self.valueDataType = 'cds.DateTime'
+        or           $self.valueDataType = 'cds.Date'
+        or           $self.valueDataType = 'cds.Time'
+        or           $self.valueDataType = 'cds.Timestamp')
+      },
+      {
+        Value     : valueChangedToLabelDateTime,
+        @UI.Hidden: ($self.valueDataType != 'cds.DateTime'
+        or           $self.valueTimeZone != null)
+      },
+      {
+        Value     : valueChangedToLabelDateTimeWTZ,
+        @UI.Hidden: ($self.valueDataType != 'cds.DateTime'
+        or           $self.valueTimeZone =  null)
+      },
+      {
+        Value     : valueChangedToLabelDate,
+        @UI.Hidden: ($self.valueDataType != 'cds.Date')
+      },
+      {
+        Value     : valueChangedToLabelTime,
+        @UI.Hidden: ($self.valueDataType != 'cds.Time')
+      },
+      {
+        Value     : valueChangedToLabelTimestamp,
+        @UI.Hidden: ($self.valueDataType != 'cds.Timestamp')
+      },
+      {
+        Value     : valueChangedToLabelDecimal,
+        @UI.Hidden: ($self.valueDataType != 'cds.Decimal')
+      }
+    ]
+  }
 }) {
-  valueChangedFrom @UI.Hidden;
-  valueChangedTo   @UI.Hidden;
-  parent           @UI.Hidden;
-  entityKey        @UI.Hidden;
-  entity           @UI.Hidden;
-  attribute        @UI.Hidden;
+  valueChangedFrom                  @UI.Hidden;
+  valueChangedFromLabelDate         @UI.AdaptationHidden  @UI.Hidden: ($self.valueDataType != 'cds.Date');
+  valueChangedFromLabelDateTime     @UI.AdaptationHidden  @UI.Hidden: ($self.valueDataType != 'cds.DateTime');
+  valueChangedFromLabelDateTimeWTZ  @UI.AdaptationHidden  @UI.Hidden: ($self.valueDataType != 'cds.DateTime');
+  valueChangedFromLabelTime         @UI.AdaptationHidden  @UI.Hidden: ($self.valueDataType != 'cds.Time');
+  valueChangedFromLabelTimestamp    @UI.AdaptationHidden  @UI.Hidden: ($self.valueDataType != 'cds.Timestamp');
+  valueChangedFromLabelDecimal      @UI.AdaptationHidden  @UI.Hidden: ($self.valueDataType != 'cds.Decimal');
+  valueChangedTo                    @UI.Hidden;
+  valueChangedToLabelDate           @UI.AdaptationHidden  @UI.Hidden: ($self.valueDataType != 'cds.Date');
+  valueChangedToLabelDateTime       @UI.AdaptationHidden  @UI.Hidden: ($self.valueDataType != 'cds.DateTime');
+  valueChangedToLabelDateTimeWTZ    @UI.AdaptationHidden  @UI.Hidden: ($self.valueDataType != 'cds.DateTime');
+  valueChangedToLabelTime           @UI.AdaptationHidden  @UI.Hidden: ($self.valueDataType != 'cds.Time');
+  valueChangedToLabelTimestamp      @UI.AdaptationHidden  @UI.Hidden: ($self.valueDataType != 'cds.Timestamp');
+  valueChangedToLabelDecimal        @UI.AdaptationHidden  @UI.Hidden: ($self.valueDataType != 'cds.Decimal');
+  parent                            @UI.Hidden;
+  entityKey                         @UI.Hidden;
+  entity                            @UI.Hidden;
+  attribute                         @UI.Hidden;
 };
 
 annotate ChangeView with @(
@@ -218,14 +440,40 @@ annotate ChangeView with @(
     'LimitedDescendantCount',
     'DistanceFromRoot',
     'DrillState',
-    'LimitedRank'
+    'LimitedRank',
+    valueChangedFromLabelDate,
+    valueChangedFromLabelDateTime,
+    valueChangedFromLabelDateTimeWTZ,
+    valueChangedFromLabelTime,
+    valueChangedFromLabelTimestamp,
+    valueChangedFromLabelDecimal,
+    valueChangedToLabelDate,
+    valueChangedToLabelDateTime,
+    valueChangedToLabelDateTimeWTZ,
+    valueChangedToLabelTime,
+    valueChangedToLabelTimestamp,
+    valueChangedToLabelDecimal,
+    valueTimeZone
   ],
   // Disallow sorting on these properties from Fiori UIs
   Capabilities.SortRestrictions.NonSortableProperties    : [
     'LimitedDescendantCount',
     'DistanceFromRoot',
     'DrillState',
-    'LimitedRank'
+    'LimitedRank',
+    valueChangedFromLabelDate,
+    valueChangedFromLabelDateTime,
+    valueChangedFromLabelDateTimeWTZ,
+    valueChangedFromLabelTime,
+    valueChangedFromLabelTimestamp,
+    valueChangedFromLabelDecimal,
+    valueChangedToLabelDate,
+    valueChangedToLabelDateTime,
+    valueChangedToLabelDateTimeWTZ,
+    valueChangedToLabelTime,
+    valueChangedToLabelTimestamp,
+    valueChangedToLabelDecimal,
+    valueTimeZone
   ],
 );
 

package/lib/csn-enhancements/annotations.js

@@ -0,0 +1,77 @@
+const cds = require('@sap/cds');
+const LOG = cds.log('change-tracking');
+const DEBUG = cds.debug('change-tracking');
+
+/**
+ * Add side effects annotations for actions to refresh the changes association.
+ */
+function addSideEffects(actions, entityName, hierarchyMap, model) {
+	const isRootEntity = !hierarchyMap.has(entityName);
+
+	// If not a root entity, find the parent association name
+	let parentAssociationName = null;
+	if (!isRootEntity) {
+		const parentEntityName = hierarchyMap.get(entityName);
+		const parentEntity = model.definitions[parentEntityName];
+		if (parentEntity?.elements) {
+			// Find the composition element in the parent that points to this entity
+			for (const [elemName, elem] of Object.entries(parentEntity.elements)) {
+				if (elem.type === 'cds.Composition' && elem.target === entityName) {
+					parentAssociationName = elemName;
+					break;
+				}
+			}
+		}
+	}
+
+	for (const se of Object.values(actions)) {
+		const target = isRootEntity ? 'TargetProperties' : 'TargetEntities';
+		const sideEffectAttr = se[`@Common.SideEffects.${target}`];
+		const property = isRootEntity ? 'changes' : { '=': `${parentAssociationName}.changes` };
+		if (sideEffectAttr?.length >= 0) {
+			sideEffectAttr.findIndex((item) => (item['='] ? item['='] : item) === (property['='] ? property['='] : property)) === -1 && sideEffectAttr.push(property);
+		} else {
+			se[`@Common.SideEffects.${target}`] = [property];
+		}
+	}
+}
+
+function addUIFacet(entity, m) {
+	const { 'sap.changelog.aspect': aspect } = m.definitions;
+	const {
+		'@UI.Facets': [facet],
+		elements: { changes }
+	} = aspect;
+	if (entity['@changelog.disable_facet'] !== undefined) {
+		LOG.warn(
+			`@changelog.disable_facet is deprecated! You can just define your own Facet for the changes association or annotate the changes association on ${entity.name} with not readable via @Capabilities.NavigationRestrictions.RestrictedProperties`
+		);
+	}
+
+	let facets = entity['@UI.Facets'];
+
+	if (!facets) {
+		DEBUG?.(`${entity.name} does not have a @UI.Facets annotation and thus the change tracking section is not added.`);
+	}
+	// Add UI.Facet for Change History List
+	if (
+		facets &&
+		!entity['@changelog.disable_facet'] &&
+		!hasFacetForComp(changes, entity['@UI.Facets']) &&
+		!entity['@Capabilities.NavigationRestrictions.RestrictedProperties']?.some((restriction) => restriction.NavigationProperty?.['='] === 'changes' && restriction.ReadRestrictions?.Readable === false)
+	) {
+		facets.push(facet);
+	}
+}
+
+/**
+ * Check if a facet already exists for the changes composition.
+ */
+function hasFacetForComp(comp, facets) {
+	return facets.some((f) => f.Target === `${comp.name}/@UI.LineItem` || (f.Facets && hasFacetForComp(comp, f.Facets)));
+}
+
+module.exports = {
+	addSideEffects,
+	addUIFacet
+};

package/lib/csn-enhancements/dynamicLocalization.js

@@ -0,0 +1,106 @@
+const cds = require('@sap/cds');
+const { isChangeTracked, getBaseEntity, getBaseElement } = require('../utils/entity-collector');
+const DEBUG = cds.debug('change-tracking');
+
+/**
+ * Dynamic localization, primarily for code list scenarios, where a status field is change tracked but its localized label should be shown.
+ * @param {*} serviceName
+ * @param {*} m
+ */
+function collectTrackedPropertiesWithDynamicLocalization(serviceName, m) {
+	const dynamicLocalizationProperties = [];
+	for (const name in m.definitions) {
+		if (!name.startsWith(serviceName) || m.definitions[name].kind !== 'entity' || !isChangeTracked(m.definitions[name])) {
+			continue;
+		}
+		const entity = m.definitions[name];
+		const base = getBaseEntity(entity, m);
+		if (!base) continue;
+		for (const ele in entity.elements) {
+			const element = entity.elements[ele];
+			if (!Array.isArray(element['@changelog']) || element['@changelog'].length !== 1 || !element['@changelog'][0]?.['='] || element._foreignKey4) {
+				continue;
+			}
+			const segments = element['@changelog'][0]['='].split('.');
+			const baseEleInfo = getBaseElement(ele, entity, m);
+			const basePropertyName = baseEleInfo?.baseElement ?? ele;
+			// Managed association target or as fallback unmanaged association target
+			const target = element.target ?? m.definitions[base.baseRef ?? name].elements[segments[0]].target;
+			const basePropertyInUnmanagedOnCondition = m.definitions[base.baseRef ?? name].elements[segments[0]].on?.some((r) => r.ref && r.ref[0] === basePropertyName);
+			const isLocalizedField = m.definitions[target].elements?.[segments[1]]?.localized;
+			const amountOfKeys = Object.keys(m.definitions[target].elements).filter((e) => m.definitions[target].elements[e].key).length;
+			if (!target || (segments[0] !== basePropertyName && !basePropertyInUnmanagedOnCondition) || segments.length !== 2 || !isLocalizedField || amountOfKeys > 1) {
+				DEBUG &&
+					DEBUG(
+						`Dynamic localization lookup is not performed on ${ele} of ${name} for the path "${element['@changelog'][0]['=']}". Only paths which follow the properties association, which only navigate one level deep and where the last property is localized are supported.`
+					);
+				continue;
+			}
+
+			if (!dynamicLocalizationProperties.some((prop) => prop.property === basePropertyName && prop.entity === base.baseRef)) {
+				dynamicLocalizationProperties.push({
+					property: basePropertyName,
+					entity: base.baseRef,
+					dynamicLabel: SELECT.from(target + '.texts')
+						.alias('localizationSubSelect')
+						.where('1 = 1')
+						.columns(segments[1])
+				});
+			}
+			DEBUG && DEBUG(`${ele} of ${name} is change tracked and its logs are visualized using a dynamic localized label lookup targeting ${target + '.texts'} for the label ${segments[1]}.`);
+		}
+	}
+	return dynamicLocalizationProperties;
+}
+
+function enhanceChangeViewWithLocalization(serviceName, changeViewName, m) {
+	const changeView = m.definitions[changeViewName];
+	if (changeView['@changelog.internal.localizationEnhanced']) return;
+	DEBUG && DEBUG(`Enhance change view ${changeViewName} with dynamic localization setup.`);
+	const localizationProperties = collectTrackedPropertiesWithDynamicLocalization(serviceName, m);
+	if (!localizationProperties.length) return;
+	const changeViewCqn = changeView.projection ?? changeView.query.SELECT;
+	changeViewCqn.columns ??= ['*'];
+	changeViewCqn.from.as ??= 'change';
+	let valueChangedFromLabel = changeViewCqn.columns.find((c) => c.as && c.as === 'valueChangedFromLabel');
+	if (!valueChangedFromLabel) {
+		changeViewCqn.columns.push({
+			cast: { type: 'cds.String' },
+			xpr: [{ ref: ['valueChangedFromLabel'] }],
+			as: 'valueChangedFromLabel'
+		});
+		valueChangedFromLabel = changeViewCqn.columns.at(-1);
+	}
+	let valueChangedToLabel = changeViewCqn.columns.find((c) => c.as && c.as === 'valueChangedToLabel');
+	if (!valueChangedToLabel) {
+		changeViewCqn.columns.push({
+			cast: { type: 'cds.String' },
+			xpr: [{ ref: ['valueChangedToLabel'] }],
+			as: 'valueChangedToLabel'
+		});
+		valueChangedToLabel = changeViewCqn.columns.at(-1);
+	}
+	const originalValueChangedFrom = valueChangedFromLabel.xpr;
+	const originalValueChangedTo = valueChangedToLabel.xpr;
+	valueChangedFromLabel.xpr = ['case'];
+	valueChangedToLabel.xpr = ['case'];
+	for (const localizationProp of localizationProperties) {
+		valueChangedFromLabel.xpr.push('when', { ref: ['attribute'] }, '=', { val: localizationProp.property }, 'and', { ref: ['entity'] }, '=', { val: localizationProp.entity }, 'then');
+		const subSelect = structuredClone(localizationProp.dynamicLabel);
+		const keys = Object.keys(m.definitions[localizationProp.dynamicLabel.SELECT.from.ref[0]].elements).filter((e) => e !== 'locale' && m.definitions[localizationProp.dynamicLabel.SELECT.from.ref[0]].elements[e].key);
+		subSelect.SELECT.where = [{ ref: [changeViewCqn.from.as, 'valueChangedFrom'] }, '=', { ref: ['localizationSubSelect', keys[0]] }, 'and', { ref: ['localizationSubSelect', 'locale'] }, '=', { ref: ['$user', 'locale'] }];
+		valueChangedFromLabel.xpr.push({ func: 'COALESCE', args: [subSelect, { xpr: originalValueChangedFrom }] });
+
+		valueChangedToLabel.xpr.push('when', { ref: ['attribute'] }, '=', { val: localizationProp.property }, 'and', { ref: ['entity'] }, '=', { val: localizationProp.entity }, 'then');
+		const subSelect2 = structuredClone(localizationProp.dynamicLabel);
+		subSelect2.SELECT.where = [{ ref: [changeViewCqn.from.as, 'valueChangedTo'] }, '=', { ref: ['localizationSubSelect', keys[0]] }, 'and', { ref: ['localizationSubSelect', 'locale'] }, '=', { ref: ['$user', 'locale'] }];
+		valueChangedToLabel.xpr.push({ func: 'COALESCE', args: [subSelect2, { xpr: originalValueChangedTo }] });
+	}
+	valueChangedFromLabel.xpr.push('else', { xpr: originalValueChangedFrom }, 'end');
+	valueChangedToLabel.xpr.push('else', { xpr: originalValueChangedTo }, 'end');
+	changeView['@changelog.internal.localizationEnhanced'] = true;
+}
+
+module.exports = {
+	enhanceChangeViewWithLocalization
+};

package/lib/{model-enhancer.js → csn-enhancements/index.js}

@@ -1,42 +1,10 @@
 const cds = require('@sap/cds');
-const LOG = cds.log('change-tracking');
 const DEBUG = cds.debug('change-tracking');
 
-const { isChangeTracked, getBaseEntity, analyzeCompositions, getService } = require('./utils/entity-collector.js');
-
-/**
- * Add side effects annotations for actions to refresh the changes association.
- */
-function addSideEffects(actions, entityName, hierarchyMap, model) {
-	const isRootEntity = !hierarchyMap.has(entityName);
-
-	// If not a root entity, find the parent association name
-	let parentAssociationName = null;
-	if (!isRootEntity) {
-		const parentEntityName = hierarchyMap.get(entityName);
-		const parentEntity = model.definitions[parentEntityName];
-		if (parentEntity?.elements) {
-			// Find the composition element in the parent that points to this entity
-			for (const [elemName, elem] of Object.entries(parentEntity.elements)) {
-				if (elem.type === 'cds.Composition' && elem.target === entityName) {
-					parentAssociationName = elemName;
-					break;
-				}
-			}
-		}
-	}
-
-	for (const se of Object.values(actions)) {
-		const target = isRootEntity ? 'TargetProperties' : 'TargetEntities';
-		const sideEffectAttr = se[`@Common.SideEffects.${target}`];
-		const property = isRootEntity ? 'changes' : { '=': `${parentAssociationName}.changes` };
-		if (sideEffectAttr?.length >= 0) {
-			sideEffectAttr.findIndex((item) => (item['='] ? item['='] : item) === (property['='] ? property['='] : property)) === -1 && sideEffectAttr.push(property);
-		} else {
-			se[`@Common.SideEffects.${target}`] = [property];
-		}
-	}
-}
+const { isChangeTracked, getBaseEntity, analyzeCompositions, getService } = require('../utils/entity-collector.js');
+const { addSideEffects, addUIFacet } = require('./annotations.js');
+const { enhanceChangeViewWithTimeZones } = require('./timezoneProperties.js');
+const { enhanceChangeViewWithLocalization } = require('./dynamicLocalization.js');
 
 /**
  * Returns a CQN expression for the composite key of an entity.
@@ -82,13 +50,6 @@ function _replaceTablePlaceholders(on, tableName) {
 	});
 }
 
-/**
- * Check if a facet already exists for the changes composition.
- */
-function hasFacetForComp(comp, facets) {
-	return facets.some((f) => f.Target === `${comp.name}/@UI.LineItem` || (f.Facets && hasFacetForComp(comp, f.Facets)));
-}
-
 /**
  * Enhance the CDS model with change tracking associations, facets, and side effects.
  * Returns the updated hierarchyMap and collectedEntities for use by trigger generation.
@@ -107,7 +68,6 @@ function enhanceModel(m) {
 	const { 'sap.changelog.aspect': aspect } = m.definitions;
 	if (!aspect) return; // some other model
 	const {
-		'@UI.Facets': [facet],
 		elements: { changes }
 	} = aspect;
 
@@ -143,6 +103,7 @@ function enhanceModel(m) {
 			m.definitions['sap.changelog.ChangeView'].elements[parents.join('_') + '_' + 'entityKey'] = structuredClone(m.definitions['sap.changelog.ChangeView'].elements.entityKey);
 			m.definitions['sap.changelog.ChangeView'].elements[parents.join('_') + '_' + 'entity'] = structuredClone(m.definitions['sap.changelog.ChangeView'].elements.entity);
 		}
+		enhanceChangeViewWithTimeZones(m.definitions['sap.changelog.ChangeView'], m);
 	}
 	for (let name in m.definitions) {
 		const entity = m.definitions[name];
@@ -213,6 +174,7 @@ function enhanceModel(m) {
 							}
 						}
 					}
+					enhanceChangeViewWithLocalization(serviceName, `${serviceName}.ChangeView`, m);
 				}
 
 				DEBUG?.(
@@ -228,35 +190,12 @@ function enhanceModel(m) {
 					(query.columns ??= ['*']).push({ as: 'changes', cast: assoc });
 					entity.elements.changes = assoc;
 				}
-
-				if (entity['@changelog.disable_facet'] !== undefined) {
-					LOG.warn(
-						`@changelog.disable_facet is deprecated! You can just define your own Facet for the changes association or annotate the changes association on ${entity.name} with not readable via @Capabilities.NavigationRestrictions.RestrictedProperties`
-					);
-				}
-
-				let facets = entity['@UI.Facets'];
-
-				if (!facets) {
-					DEBUG?.(`${entity.name} does not have a @UI.Facets annotation and thus the change tracking section is not added.`);
-				}
-				// Add UI.Facet for Change History List
-				if (
-					facets &&
-					!entity['@changelog.disable_facet'] &&
-					!hasFacetForComp(changes, entity['@UI.Facets']) &&
-					!entity['@Capabilities.NavigationRestrictions.RestrictedProperties']?.some((restriction) => restriction.NavigationProperty?.['='] === 'changes' && restriction.ReadRestrictions?.Readable === false)
-				) {
-					facets.push(facet);
-				}
+				addUIFacet(entity, m);
 			}
 
 			if (entity.actions) {
-				const baseInfo = getBaseEntity(entity, m);
-				if (baseInfo) {
-					const { baseRef: dbEntityName } = baseInfo;
-					addSideEffects(entity.actions, dbEntityName, hierarchyMap, m);
-				}
+				const { baseRef: dbEntityName } = baseInfo;
+				addSideEffects(entity.actions, dbEntityName, hierarchyMap, m);
 			}
 		}
 	}

package/lib/csn-enhancements/timezoneProperties.js

@@ -0,0 +1,81 @@
+const cds = require('@sap/cds');
+const { compositeKeyExpr: compositeKeyExprSqlite } = require('../sqlite/sql-expressions');
+const { compositeKeyExpr: compositeKeyExprHANA } = require('../hana/sql-expressions');
+const { compositeKeyExpr: compositeKeyExprPG } = require('../postgres/sql-expressions');
+const { isChangeTracked } = require('../utils/entity-collector');
+
+function collectTrackedPropertiesWithTimezone(m) {
+	const timezoneProperties = [];
+	for (const name in m.definitions) {
+		const entity = m.definitions[name];
+		if (entity.kind !== 'entity' || entity.query || entity.projection || !isChangeTracked(entity)) {
+			continue;
+		}
+		for (const ele in entity.elements) {
+			const element = entity.elements[ele];
+			if (!element['@Common.Timezone'] || element._foreignKey4) {
+				continue;
+			}
+			timezoneProperties.push({
+				property: ele,
+				entity: name,
+				timezone: element['@Common.Timezone']?.['=']
+					? // Where condition is replaced when select is inserted into ChangeView
+						SELECT.from(name).alias('timezoneSubSelect').where('1 = 1').columns(element['@Common.Timezone']['='])
+					: element['@Common.Timezone']
+			});
+		}
+	}
+	return timezoneProperties;
+}
+
+function isDeploy2Check(target) {
+	try {
+		cds.build?.register(target, class ABC extends cds.build.Plugin {});
+	} catch (err) {
+		if (err.message.match(/already registered/)) {
+			return true;
+		}
+	}
+	return false;
+}
+
+function enhanceChangeViewWithTimeZones(changeView, m) {
+	const compositeKeyExpr =
+		isDeploy2Check('hana') && m.meta.creator.match(/v6/)
+			? compositeKeyExprHANA
+			: isDeploy2Check('postgres') && m.meta.creator.match(/v6/)
+				? compositeKeyExprPG
+				: cds.env.requires?.db.kind === 'sqlite' && !cds.build
+					? compositeKeyExprSqlite
+					: cds.env.requires?.db.kind === 'postgres' && (!cds.build || cds.env.profiles.includes('pg'))
+						? compositeKeyExprPG
+						: compositeKeyExprHANA;
+	const timezoneProperties = collectTrackedPropertiesWithTimezone(m);
+	const timezoneColumn = changeView.query.SELECT.columns.find((c) => c.as && c.as === 'valueTimeZone');
+	if (timezoneProperties.length === 0) return;
+	delete timezoneColumn.val;
+	timezoneColumn.xpr = ['case'];
+	for (const timezoneProp of timezoneProperties) {
+		timezoneColumn.xpr.push('when', { ref: ['attribute'] }, '=', { val: timezoneProp.property }, 'and', { ref: ['entity'] }, '=', { val: timezoneProp.entity }, 'then');
+		if (timezoneProp.timezone.SELECT) {
+			const subSelect = structuredClone(timezoneProp.timezone);
+			const keys = Object.keys(m.definitions[timezoneProp.entity].elements).filter((e) => m.definitions[timezoneProp.entity].elements[e].key);
+			subSelect.SELECT.where = [
+				{ ref: ['change', 'entityKey'] },
+				'=',
+				// REVISIT: once HIERARCHY_COMPOSITE_ID is available on all DBs, use native CQN
+				compositeKeyExpr(keys)
+			];
+			timezoneColumn.xpr.push(subSelect);
+		} else {
+			timezoneColumn.xpr.push({ val: timezoneProp.timezone });
+		}
+	}
+	timezoneColumn.xpr.push('else', { val: null }, 'end');
+}
+
+module.exports = {
+	collectTrackedPropertiesWithTimezone,
+	enhanceChangeViewWithTimeZones
+};

package/lib/h2/java-codegen.js

@@ -18,7 +18,7 @@ function _toSQL(query, model) {
 	return cqn2sql.SELECT(sqlCQN);
 }
 
-function handleAssocLookup(column, refRow, model) {
+function handleAssocLookup(column, assocPaths, refRow, model) {
 	let bindings = [];
 	let where = {};
 
@@ -36,11 +36,11 @@ function handleAssocLookup(column, refRow, model) {
 		bindings = column.on.map((assoc) => `${refRow}.getString("${assoc}")`);
 	}
 
-	const alt = column.alt.map((s) => s.split('.').slice(1).join('.'));
+	const alt = assocPaths.map((s) => s.split('.').slice(1).join('.'));
 	const columns = alt.length === 1 ? alt[0] : utils.buildConcatXpr(alt);
 
 	// Check if target entity has localized data
-	const localizedInfo = utils.getLocalizedLookupInfo(column.target, column.alt, model);
+	const localizedInfo = utils.getLocalizedLookupInfo(column.target, assocPaths, model);
 
 	if (localizedInfo) {
 		// Build locale-aware lookup: try .texts table first, fall back to base entity
@@ -676,12 +676,40 @@ function _prepareValueExpression(col, rowVar) {
 
 // Returns label expression for a column
 function _prepareLabelExpression(col, rowVar, model) {
-	if (col.target && col.alt) {
-		const { sql, bindings } = handleAssocLookup(col, rowVar, model);
-		return { sqlExpr: sql, bindings: bindings };
+	if (!col.alt || col.alt.length === 0) {
+		return { sqlExpr: 'NULL', bindings: [] };
 	}
-	// No label for scalars or associations without @changelog override
-	return { sqlExpr: 'NULL', bindings: [] };
+
+	const sqlParts = [];
+	const allBindings = [];
+	let assocBatch = [];
+
+	const flushAssocBatch = () => {
+		if (assocBatch.length > 0) {
+			const { sql, bindings } = handleAssocLookup(col, assocBatch, rowVar, model);
+			sqlParts.push(sql);
+			allBindings.push(...bindings);
+			assocBatch = [];
+		}
+	};
+
+	for (const entry of col.alt) {
+		if (entry.source === 'assoc') {
+			assocBatch.push(entry.path);
+		} else {
+			flushAssocBatch();
+			sqlParts.push('?');
+			allBindings.push(`${rowVar}.getString("${entry.path}")`);
+		}
+	}
+	flushAssocBatch();
+
+	if (sqlParts.length === 0) {
+		return { sqlExpr: 'NULL', bindings: [] };
+	}
+
+	const sqlExpr = sqlParts.length === 1 ? sqlParts[0] : sqlParts.join(" || ', ' || ");
+	return { sqlExpr, bindings: allBindings };
 }
 
 function _wrapInTryCatch(sql, bindings) {

package/lib/hana/register.js

@@ -42,6 +42,16 @@ function registerHDICompilerHook() {
 		ret.definitions = ret.definitions.concat(triggers).concat(data);
 		return ret;
 	};
+
+	// REVISIT: Remove once time casting is fixed in cds-dbs
+	cds.on('serving', async () => {
+		if (cds.env.requires?.db.kind !== 'hana') return;
+		const db = await cds.connect.to('db');
+		db.before('*', () => {
+			// to_time conversion is necessary else HANA tries to convert to timestamp implicitly causing an SQL crash
+			db.class.CQN2SQL.OutputConverters.Time = (e) => `to_char(to_time(${e}), 'HH24:MI:SS')`;
+		});
+	});
 }
 
 module.exports = { registerHDICompilerHook };

package/lib/hana/sql-expressions.js

@@ -100,14 +100,9 @@ function getWhereCondition(col, modification) {
 }
 
 /**
- * Returns SQL expression for a column's label (looked-up value for associations)
+ * Builds scalar subselect for association label lookup with locale awareness
  */
-function getLabelExpr(col, refRow, model) {
-	if (!(col.target && col.alt)) {
-		return `NULL`;
-	}
-
-	// Builds inline SELECT expression for association label lookup with locale support
+function buildAssocLookup(col, assocPaths, refRow, model) {
 	let where = {};
 	if (col.foreignKeys) {
 		where = col.foreignKeys.reduce((acc, k) => {
@@ -121,11 +116,11 @@ function getLabelExpr(col, refRow, model) {
 		}, {});
 	}
 
-	const alt = col.alt.map((s) => s.split('.').slice(1).join('.'));
+	const alt = assocPaths.map((s) => s.split('.').slice(1).join('.'));
 	const columns = alt.length === 1 ? alt[0] : utils.buildConcatXpr(alt);
 
 	// Check for localization
-	const localizedInfo = utils.getLocalizedLookupInfo(col.target, col.alt, model);
+	const localizedInfo = utils.getLocalizedLookupInfo(col.target, assocPaths, model);
 	if (localizedInfo) {
 		const textsWhere = { ...where, locale: { func: 'SESSION_CONTEXT', args: [{ val: 'LOCALE' }] } };
 		const textsQuery = SELECT.one.from(localizedInfo.textsEntity).columns(columns).where(textsWhere);
@@ -137,6 +132,35 @@ function getLabelExpr(col, refRow, model) {
 	return `(${toSQL(query, model)})`;
 }
 
+/**
+ * Returns SQL expression for a column's label (looked-up value for associations)
+ */
+function getLabelExpr(col, refRow, model) {
+	if (!col.alt || col.alt.length === 0) return `NULL`;
+
+	const parts = [];
+	let assocBatch = [];
+
+	const flushAssocBatch = () => {
+		if (assocBatch.length > 0) {
+			parts.push(buildAssocLookup(col, assocBatch, refRow, model));
+			assocBatch = [];
+		}
+	};
+
+	for (const entry of col.alt) {
+		if (entry.source === 'assoc') {
+			assocBatch.push(entry.path);
+		} else {
+			flushAssocBatch();
+			parts.push(`TO_NVARCHAR(:${refRow}.${entry.path})`);
+		}
+	}
+	flushAssocBatch();
+
+	return parts.length === 0 ? `NULL` : parts.join(" || ', ' || ");
+}
+
 /**
  * Builds SQL expression for objectID (entity display name)
  * Uses @changelog annotation fields, falling back to entity name

package/lib/postgres/register.js

@@ -26,6 +26,18 @@ function registerPostgresCompilerHook() {
 
 		return ddl;
 	});
+
+	// REVISIT: Remove once time casting is fixed in cds-dbs
+	cds.on('serving', async () => {
+		if (cds.env.requires?.db.kind !== 'postgres') return;
+		const db = await cds.connect.to('db');
+		db.before('*', () => {
+			db.class.CQN2SQL.OutputConverters.Date = (e) => `to_date(${e}::text, 'YYYY-MM-DD')`;
+			db.class.CQN2SQL.OutputConverters.Time = (e) => `to_timestamp(${e}::text, 'HH24:MI:SS')::TIME`;
+			db.class.CQN2SQL.OutputConverters.DateTime = (e) => `to_timestamp(${e}::text, 'YYYY-MM-DD"T"HH24:MI:SS"Z"')::timestamp`;
+			db.class.CQN2SQL.OutputConverters.Timestamp = (e) => `to_timestamp(${e}::text, 'YYYY-MM-DD"T"HH24:MI:SS.US"Z"')::timestamp`;
+		});
+	});
 }
 
 async function deployPostgresLabels() {

package/lib/postgres/sql-expressions.js

@@ -84,9 +84,13 @@ function getWhereCondition(col, modification) {
 }
 
 /**
- * Builds scalar subselect for association label lookup with locale support
+ * Builds scalar subselect for association label lookup with locale support.
+ * @param {Object} column Column entry with target, foreignKeys/on, etc.
+ * @param {string[]} assocPaths Array of association paths (format: "assocName.field")
+ * @param {string} refRow Trigger row reference ('NEW' or 'OLD')
+ * @param {*} model CSN model
  */
-function buildAssocLookup(column, refRow, model) {
+function buildAssocLookup(column, assocPaths, refRow, model) {
 	let where = {};
 	if (column.foreignKeys) {
 		where = column.foreignKeys.reduce((acc, k) => {
@@ -100,11 +104,11 @@ function buildAssocLookup(column, refRow, model) {
 		}, {});
 	}
 
-	const alt = column.alt.map((s) => s.split('.').slice(1).join('.'));
+	const alt = assocPaths.map((s) => s.split('.').slice(1).join('.'));
 	const columns = alt.length === 1 ? alt[0] : utils.buildConcatXpr(alt);
 
 	// Check for localization
-	const localizedInfo = utils.getLocalizedLookupInfo(column.target, column.alt, model);
+	const localizedInfo = utils.getLocalizedLookupInfo(column.target, assocPaths, model);
 	if (localizedInfo) {
 		const textsWhere = { ...where, locale: { func: 'current_setting', args: [{ val: 'cap.locale' }, { val: true }] } };
 		const textsQuery = SELECT.one.from(localizedInfo.textsEntity).columns(columns).where(textsWhere);
@@ -117,13 +121,34 @@ function buildAssocLookup(column, refRow, model) {
 }
 
 /**
- * Returns SQL expression for a column's label (looked-up value for associations)
+ * Returns SQL expression for a column's label (looked-up value for associations).
+ * Iterates over col.alt entries in order, grouping consecutive association paths
+ * into a single subquery and emitting local references inline from the trigger row.
  */
 function getLabelExpr(col, refRow, model) {
-	if (col.target && col.alt) {
-		return buildAssocLookup(col, refRow, model);
+	if (!col.alt || col.alt.length === 0) return 'NULL';
+
+	const parts = [];
+	let assocBatch = [];
+
+	const flushAssocBatch = () => {
+		if (assocBatch.length > 0) {
+			parts.push(buildAssocLookup(col, assocBatch, refRow, model));
+			assocBatch = [];
+		}
+	};
+
+	for (const entry of col.alt) {
+		if (entry.source === 'assoc') {
+			assocBatch.push(entry.path);
+		} else {
+			flushAssocBatch();
+			parts.push(`${refRow}.${entry.path}::TEXT`);
+		}
 	}
-	return 'NULL';
+	flushAssocBatch();
+
+	return parts.length === 0 ? 'NULL' : parts.join(" || ', ' || ");
 }
 
 /**

package/lib/postgres/triggers.js

@@ -1,7 +1,9 @@
+const cds = require('@sap/cds');
 const utils = require('../utils/change-tracking.js');
 const { getCompositionParentInfo, getGrandParentCompositionInfo } = require('../utils/composition-helpers.js');
 const { getSkipCheckCondition, compositeKeyExpr, buildObjectIDAssignment, buildInsertBlock, extractTrackedDbColumns } = require('./sql-expressions.js');
 const { buildCompositionParentBlock } = require('./composition.js');
+const config = cds.env.requires['change-tracking'];
 
 /**
  * Generates the PL/pgSQL function body for the main change tracking trigger
@@ -18,9 +20,9 @@ function buildFunctionBody(entity, columns, objectIDs, rootEntity, rootObjectIDs
 	const deleteBlock = columns.length > 0 ? buildInsertBlock(columns, 'delete', entity, model, hasCompositionParent) : '';
 
 	// Build composition parent blocks if needed
-	const createParentBlock = compositionParentInfo ? buildCompositionParentBlock(compositionParentInfo, rootObjectIDs, 'create', model, grandParentCompositionInfo) : '';
-	const updateParentBlock = compositionParentInfo ? buildCompositionParentBlock(compositionParentInfo, rootObjectIDs, 'update', model, grandParentCompositionInfo) : '';
-	const deleteParentBlock = compositionParentInfo ? buildCompositionParentBlock(compositionParentInfo, rootObjectIDs, 'delete', model, grandParentCompositionInfo) : '';
+	const createParentBlock = compositionParentInfo && !config?.disableCreateTracking ? buildCompositionParentBlock(compositionParentInfo, rootObjectIDs, 'create', model, grandParentCompositionInfo) : '';
+	const updateParentBlock = compositionParentInfo && !config?.disableUpdateTracking ? buildCompositionParentBlock(compositionParentInfo, rootObjectIDs, 'update', model, grandParentCompositionInfo) : '';
+	const deleteParentBlock = compositionParentInfo && !config?.disableDeleteTracking ? buildCompositionParentBlock(compositionParentInfo, rootObjectIDs, 'delete', model, grandParentCompositionInfo) : '';
 
 	return `
         DECLARE

package/lib/sqlite/sql-expressions.js

@@ -95,7 +95,7 @@ function getWhereCondition(col, modification) {
 /**
  * Builds scalar subselect for association label lookup with locale awareness
  */
-function buildAssocLookup(column, refRow, entityKey, model) {
+function buildAssocLookup(column, assocPaths, refRow, entityKey, model) {
 	const where = column.foreignKeys
 		? column.foreignKeys.reduce((acc, k) => {
 				acc[k] = { val: `${refRow}.${column.name}_${k}` };
@@ -107,12 +107,12 @@ function buildAssocLookup(column, refRow, entityKey, model) {
 				return acc;
 			}, {});
 
-	// Drop the first part of column.alt (association name)
-	const alt = column.alt.map((s) => s.split('.').slice(1).join('.'));
+	// Drop the first part of each path (association name)
+	const alt = assocPaths.map((s) => s.split('.').slice(1).join('.'));
 	const columns = alt.length === 1 ? alt[0] : utils.buildConcatXpr(alt);
 
 	// Check for localization
-	const localizedInfo = utils.getLocalizedLookupInfo(column.target, column.alt, model);
+	const localizedInfo = utils.getLocalizedLookupInfo(column.target, assocPaths, model);
 	if (localizedInfo) {
 		const textsWhere = { ...where, locale: { func: 'session_context', args: [{ val: '$user.locale' }] } };
 		const textsQuery = SELECT.one.from(localizedInfo.textsEntity).columns(columns).where(textsWhere);
@@ -128,10 +128,30 @@ function buildAssocLookup(column, refRow, entityKey, model) {
  * Returns SQL expression for a column's label (looked-up value for associations)
  */
 function getLabelExpr(col, refRow, entityKey, model) {
-	if (col.target && col.alt) {
-		return buildAssocLookup(col, refRow, entityKey, model);
+	if (!col.alt || col.alt.length === 0) return 'NULL';
+
+	const parts = [];
+	let assocBatch = [];
+
+	const flushAssocBatch = () => {
+		if (assocBatch.length > 0) {
+			parts.push(buildAssocLookup(col, assocBatch, refRow, entityKey, model));
+			assocBatch = [];
+		}
+	};
+
+	for (const entry of col.alt) {
+		if (entry.source === 'assoc') {
+			assocBatch.push(entry.path);
+		} else {
+			// local field: flush any pending association batch first, then emit local ref
+			flushAssocBatch();
+			parts.push(`${refRow}.${entry.path}`);
+		}
 	}
-	return 'NULL';
+	flushAssocBatch();
+
+	return parts.length === 0 ? 'NULL' : parts.join(" || ', ' || ");
 }
 
 /**

package/lib/utils/change-tracking.js

@@ -173,7 +173,9 @@ function extractTrackedColumns(entity, model = cds.context?.model ?? cds.model,
 				const changelogPaths = changelogAnnotation.map((c) => c['=']);
 				for (const path of changelogPaths) {
 					const p = validateChangelogPath(entity, path, model);
-					if (p) alt.push(p);
+					if (!p) continue;
+					if (p.includes('.')) alt.push({ path: p, source: 'assoc' });
+					else alt.push({ path: p, source: 'local' });
 				}
 				if (alt.length > 0) entry.alt = alt;
 			}
@@ -352,6 +354,7 @@ function getCompositionParentBinding(targetEntity, rootEntity) {
 }
 
 function getLocalizedLookupInfo(targetEntityName, altFields, model = cds.context?.model ?? cds.model) {
+	if (!altFields || altFields.length === 0) return null;
 	const targetEntity = model.definitions[targetEntityName];
 	if (!targetEntity) return null;
 

package/lib/utils/entity-collector.js

@@ -227,6 +227,25 @@ function getBaseEntity(entity, model) {
 	}
 }
 
+function getBaseElement(element, entity, model) {
+	const cqn = entity.projection ?? entity.query?.SELECT;
+	if (!cqn) return null;
+	element = cqn.columns?.find((c) => c.as === element && c.ref)?.ref?.[0] ?? element;
+
+	const baseRef = cqn.from?.ref?.[0];
+	if (!baseRef || !model) return null;
+
+	const baseEntity = model.definitions[baseRef];
+	if (!baseEntity) return null;
+	const baseCQN = baseEntity.projection ?? baseEntity.query?.SELECT ?? baseEntity.query?.SET;
+	// If base entity is also a projection, recurse
+	if (baseCQN) {
+		return getBaseElement(element, baseEntity, model);
+	} else {
+		return { baseRef, baseElement: element };
+	}
+}
+
 // Analyze composition hierarchy in CSN
 function analyzeCompositions(csn) {
 	// First pass: build child -> { parent, compositionField } map
@@ -318,5 +337,6 @@ module.exports = {
 	getBaseEntity,
 	analyzeCompositions,
 	getService,
-	collectEntities
+	collectEntities,
+	getBaseElement
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cap-js/change-tracking",
-	"version": "2.0.0-beta.3",
+	"version": "2.0.0-beta.5",
 	"publishConfig": {
 		"access": "public",
 		"tag": "beta"