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

История изменений – список изменений сущности или пользователя. Просмотреть список изменений для каждой сущности можно в секции История изменений, а также с помощью соответствующих запросов 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,
    ...
  },
   ...
]