Для того чтобы получать события от элементов системы необходимо сначала добавить их в сессию. При исчезновении необходимости слежения за каким-либо элементом, его можно удалить из сессии. Для выполнения данных задач используется команда core/update_data_flags:
svc=core/update_data_flags¶ms={"spec":[ { "type":<text>, "data":<long|text|[long]>, "flags":<long>, "mode":<uint>, "max_items":<uint> } ]}
Использование данного запроса рассмотрено в примере Управление элементами системы и событиями.
Название | Описание |
---|---|
spec | массив объектов с конфигурацией для запроса на изменение элементов, находящихся в сессии |
type | метод передачи элементов в сессию (см. список ниже) |
data | данные (зависит от значения предыдущего параметра) |
flags | флаги, определяющие какая именно информация об элементах будет добавляться в сессию (флаги каждого типа элемента описаны в разделе Форматы данных) |
mode | режим применения флагов (см. список ниже) |
max_items | параметр доступен только при type='type', задаёт максимальное количество подписанных items |
Методы передачи элементов:
Pежим применения флагов:
Флаги устанавливаются, чтобы следить за изменениями каких-то конкретных свойств элемента. Количество выставленных флагов зависит от ваших нужд, если вам необходимо получать все события, то все флаги должны быть установлены. Получить события можно выполнив запрос из раздела Другие запросы: События.
[ /*массив элементов*/ { "i":<long>, /* ID */ "d":{ /* другие поля */ ... }, "f":<long> /* примененные флаги */ }, ... ]
Формат поля «d» зависит от типа возвращаемого элемента. Форматы всех типов элементов рассмотрены в разделе Форматы данных. При вызове данной команды с режимом применения флагов «2» в поле «d» будет стоять null.
|