History entries

The XDM Object History feature records all actions that were performed on an XDM object, the XDM List History feature records all actions that were performed on a last of XDM objects. These actions include CREATE, UPDATE and DELETE actions.

For more information of the concept of the history in XDM refer to the history concepts.

Properties

The table below documents the available properties for histories. The 'name' column displays the property name as it can be used in Groovy and Java Scripts.

Name	Type	Default	Description
Name displayName	String	n/a	The display name of the object.
object object	Object	n/a	A reference to the object with the state from the history. This affects all the properties and rules of the object.
Operation operation	Enum	n/a	The type of change made at the respective point in time. The following change types are possible: CREATE (CREATE) The object was created. DELETE (DELETE) The object has been deleted. This change type is only visible in the list history since deleted objects are not visible in the object list. UPDATE (UPDATE) The object’s properties were updated. If the object has rules, this change may also indicate the creation, update, or deletion of a rule.
Timestamp timestamp	Timestamp	n/a	The time at which the change was made.
User user	String	n/a	The user who made the change.

Name

Type

Default

Description

Name

displayName

String

n/a

The display name of the object.

object

object

Object

n/a

A reference to the object with the state from the history. This affects all the properties and rules of the object.

Operation

operation

Enum

n/a

The type of change made at the respective point in time. The following change types are possible:

CREATE (CREATE): The object was created.
DELETE (DELETE): The object has been deleted. This change type is only visible in the list history since deleted objects are not visible in the object list.
UPDATE (UPDATE): The object’s properties were updated. If the object has rules, this change may also indicate the creation, update, or deletion of a rule.

Timestamp

timestamp

Timestamp

n/a

The time at which the change was made.

User

user

String

n/a

The user who made the change.

Actions

The available actions are described below. Some actions apply to the list, while others are specific to selected histories.

Object Actions

The following actions are available on specific histories. In order to execute the action, the user must possess the necessary permissions for the object. The permissions required for each action are described individually. If the user does not have these permissions, the action will be disabled and the tooltip will provide the exact reason for the deactivation.

Compare to latest
Restore

Shows the differences between the current object, and the chosen object version in the history.

The following permissions are required:

READ

Generates a YAML file of the chosen version from the history.

Restore a deleted object:

If a deleted object is restored, the original object will not be recreated. Instead, a new object with the property values of the deleted object is created. When an object is deleted, all permissions are also deleted. Therefore, only an admin user can restore deleted objects. The admin user is set as owner of the restored object and all permissions must be added to the newly created object.

Only the last version of a deleted object can be restored, older version can not be restored.

The following permissions are required:

READ
WRITE