История изменений

История изменений – список изменений сущности или пользователя. Просмотреть список изменений для каждой сущности можно в секции История изменений, а также с помощью соответствующих запросов REST API для объекта, связи и пользователя.

Модель истории изменений

Во внутреннем представлении системы, каждое изменение представлено в виде предыдущего значения (oldBody) и нового значения (newBody) измененного поля.

Таблица ниже содержит описание всех полей внутреннего представления изменений сущностей в системе:

Поле	Тип	Описание
entityId	String	Идентификатор измененной сущности.
entityType	Integer	Тип измененной сущности. Подробная информация о типах доступна в статье Типы сущностей.
kind	Integer	Тип изменения. Подробная информация о типах доступна в статье Типы сущностей.
newBody	Object	Новое значение измененного поля сущности.
oldBody	Object	Предыдущее значение измененного поля сущности.
timestamp	Integer	Временная метка изменения сущности.
userId	String	Идентификатор пользователя, изменившего сущность.

Разница между entityType и kind

Поле entityType соответствует типу изменяемой сущности, поле kind - типу изменяемого поля сущности. Значения данных полей описаны в статье Типы сущностей.

Примеры записей истории изменений с различными значениями entityType и kind:

Пользователь изменил Свойство ("kind": 10) Объекта ("entityType": 1):

[
  {
    "entityType": 1,
    "kind": 10,
    ...
  },
   ...
]

Пользователь изменил Свойство ("kind": 10) Связи ("entityType": 2):

[
  {
    "entityType": 2,
    "kind": 10,
    ...
  },
   ...
]

Пользователь изменил Сессию ("kind": 13) Пользователя ("entityType": 5).

[
  {
    "entityType": 5,
    "kind": 13,
    ...
  },
   ...
]