Property change notification
A Property Change notification is emitted by the API to report changes to the properties of a managed object where the data model description indicates that modification notification support (qualifier "pc") is available for that property.
In addition to the common fields, the following are also included:
Field name | Type | Description |
---|---|---|
property-names | Array of string | An array of the names of the properties for which change reports are included in this event object. |
change-reports | Array of objects | An array of nested change-report objects, the format of which is described in the next table. The order in which these objects appear in this array reflects the temporal order in which the changes occurred. |
Each nested change-report object has the following fields and values:
Field name | Type | Description |
---|---|---|
property-name | String | The name of the property (as specified in the object's data model) that has changed. |
old-value | Based on model | If the property is not a container-type or write-only property, this field contains the old
(previous) value of the property for the object. The value of this field will be of the data type
indicated for this property in the object's data model. If the property is a container-type property (i.e. marked with the (c) qualifier), this field does not provide the complete previous value. Rather, it provides an array of entries that have been removed from the value of the container property. The value of these entries will be of the data type indicated for the property in the object's data model. If no entries have been removed, null is provided. If the property is a write-only property (i.e. marked with the (wo) qualifier), this field does not provide the value of the property. Rather, this field always contains null. This will be null for initial events. |
new-value | Based on model | If the property is not a container-type or write-only property, this field contains the new
(current) value of the property for the object. The value of this field will be of the data type
indicated for this property in the object's data model. If the property is a container-type property (i.e. marked with the (c) qualifier), this field does not provide the complete new value. Rather, it provides an array of entries that have been added to the value of the container property. The value of these entries will be of the data type indicated for the property in the object's data model. If no entries have been added, null is provided. If the property is a write-only property (i.e. marked with the (wo) qualifier), this field does not provide the value of the property. Rather, this field always contains null. |