Синхронизация

Запуск синхронизации — это один полный проход по каталогу источника. В конце запуска всё, что проход не нашёл, — это то, о чём источник перестал сообщать.

Запуск выполняет три шага по порядку.

Запуск, который сорвался на полпути, всё равно сохранил всё, что прочитал до этого момента.

Плановый забор данных выполняется ежечасно. Он охватывает каждую организацию, у которой настройки синхронизации сохранены и включены, и пропускает организации, чья интеграция передаёт инвентарь файлом.

Владелец или администратор также может в любой момент запустить синхронизацию из настроек синхронизации инвентаря организации и отменить запуск, который идёт. Отменённый запуск сохраняет уже зафиксированные страницы и пропускает проход деактивации, точно так же, как неудачный запуск.

Для интеграции с CMS, работающей по протоколу CityScreen, платформа запрашивает каталог, используя идентификатор и учётные данные оператора. В ответе перечислены экраны, каждый со вложенными в него поверхностями.

Входящие записи сопоставляются с существующими экранами и поверхностями по идентификаторам, которые использует система-источник, а поверхность дополнительно сопоставляется по GID. Это сохраняет историю поверхности, когда система-источник меняет собственные идентификаторы, но оставляет GID стабильным. Поверхность, чей GID уже занят другой поверхностью той же организации, пропускается в этом запуске, а в журнале названы GID и поверхность, которая его занимает.

Практически всё. Название поверхности, разрешение, положение на экране, расписание работы, фотографии, конфигурация слотов и большая часть метаданных заменяются из источника при каждом запуске, где они различаются. Название экрана, адрес, координаты, разрешения, физический размер, размещение, вид инсталляции, описание и фотографии также заменяются.

Четыре настройки уровня поверхности принадлежат оператору и сохраняются. Прежде чем планировать любую работу вокруг изменённых значений, прочитайте Что можно редактировать.

Ничего не удаляется. Поверхность, о которой источник перестал сообщать, переводится в неактивное состояние в конце следующего запуска, завершившегося без неудачных страниц, и остаётся в каталоге со своими идентификаторами, историей и отчётами.

Обратное тоже происходит автоматически. Поверхность, присутствующая в запуске, становится активной. Для большинства интеграций это делает активацию свойством источника — см. Активация и архивация.

Страница, запрос которой возвращает статус неуспеха или пустое тело, отбрасывается. Сбой записывается в журнал запуска вместе с ответом источника, и запуск помечается как неудачный.

Из неудачной страницы следуют два последствия.

Второй пункт — главный: источник, который ненадолго становится недоступен посреди запуска, не может привести к деактивации поверхностей, потому что проход, который их деактивировал бы, не выполняется.

Записи, не прошедшие проверку, — более мягкий случай. Экран, чья входящая запись некорректна, пропускается отдельно, проблемы записываются в журнал с названием экрана, а остальная страница обрабатывается дальше. Если экран остаётся некорректным в ходе чистого запуска, его поверхности деактивируются по обычному правилу для инвентаря, о котором источник перестаёт сообщать.

Если развёртывание лицензировано на максимальное число дисплеев, а источник сообщает больше, пакет пропускается, организации направляется уведомление, и запуск продолжается, не помечаясь как неудачный. В журнале записано, что число лицензированных дисплеев меньше полученного числа.

Некоторые интеграции с CMS не публикуют живой каталог. Для них оператор вместо этого загружает таблицу, и та же сверка выполняется по её строкам: создать, обновить и деактивировать всё, чего в файле не было.

Для организаций с файловой интеграцией плановый ежечасный забор данных не применяется, а ручной запуск забора отклоняется.

Настройки синхронизации инвентаря хранятся для каждой организации, и редактировать их могут только владельцы и администраторы.

Удаление настроек прекращает синхронизацию организации. Уже импортированный инвентарь оно не удаляет.

Информацию о синхронизации дают два места в интерфейсе.

Журнал хранит один запуск: каждый новый запуск заменяет предыдущий журнал. Завершённый запуск заканчивается своими счётчиками:

У запуска, столкнувшегося с проблемой, над счётчиками записана сама проблема:

Описанный выше забор данных — это путь по протоколу CityScreen, который используют организации, чьими экранами управляет CS Play, и универсальные источники, реализующие тот же интерфейс. Другие интеграции доходят до того же каталога собственными путями.

Поддерживаемые партнёры классифицирует каждую из них по типу интеграции и направлению обмена.