Home > @i2analyze/notebook-sdk > chart > IChartChangeMinor > recordChanges

chart.IChartChangeMinor.recordChanges property

Gets granular change details for records that changed in this chart update.

Signature:

readonly recordChanges?: data.IKeyedReadOnlyCollection<records.AnalyzeRecordId, IRecordChanges>;

Returns: data.IKeyedReadOnlyCollection<records.AnalyzeRecordId, IRecordChanges>

Introduced: version 1.9

Remarks

This optional field provides property-level change tracking for records. When populated, it contains an entry for each record that changed, with detailed information about: - Which properties were added, removed, or changed - Which notes were added, changed, or removed - Which source references were added, changed, or removed * *Usage Pattern:*

// New opt-in granularity
change.recordChanges?.forEach((recordId, changes) => {
  if (changes.properties?.changed.size > 0) {
    console.log('Properties changed for', recordId);
  }
});

Known Limitations: Changes to unfetched properties are not reported here. - Security dimension changes are not included. - If a record appears in records.changed but has no corresponding entry in recordChanges, or if the entry shows empty sets for all categories, this may indicate unfetched property changes or security-only edits.