Сервис интеграции. Настройка¶
- Table of contents
- Сервис интеграции. Настройка
Настройка происходит через страницу Сервис интеграции сайта Digispot 3.
Все действия на вкладках страницы осуществляются при помощи следующих кнопок:
- Добавить новую запись.
- Редактировать выбранную запись.
- Удалить выбранную запись.
- Найти записи.
Источники данных¶
Настройка начинается с вкладки Источники данных.
Источники данных для интеграции - это подключения к внешним приложениям, предоставляющим свои данные для интеграции с Digispot.
Подключение осуществляется при помощи адаптера, определяющего тип и возможности программного интерфейса (API), используемого для интеграции с внешним источником.
При добавлении указываются тип и параметры адаптера:
-
GSelector.
Параметры: указывается URL работающего сервиса экспорта/импорта, полностью, например:
httр://адрес сервиса:51511/GSImportExportService/GSImportExportService.asmx
-
MusicMaster.
Параметры: указывается адрес работающего PlusServer, в виде адреса и порта, например:
httр://адрес сервиса:8080
Станции¶
Внутри одного источника данных могут находиться материалы разных радиостанций.
На вкладке Станции необходимо выбрать и настроить станции, с которыми будет происходить обмен.
Список доступных станций определяется настройкой и параметрами работы внешних приложений и описан в руководствах пользователя этих приложений.
Проверить работоспособность настроенного источника данных можно следующим образом: если на вкладке Станции открыть окно Добавить запись, источник должен отображать список имеющихся у него радиостанций, который не бывает пустым при правильной настройке.
Должен присутствовать как минимум один элемент. Если список пуст, то необходимо проверить настройки подключения к интегрируемому приложению и его собственные настройки.
Соответствие полей¶
Для каждой станции можно настроить соответствие полей элементов МБД полям внешней БД и их направление синхронизации.
Это необходимо в случае, если выполняется синхронизация МБД и внешней БД - ручной или автоматический перенос изменений из одной БД в другую.
Изменения могут касаться полей существующих элементов, создание новых и удаление существующих элементов.
Среди всех доступных полей нужно отметить несколько полей, наличие которых в списке синхронизируемых меняет поведение системы.
Category¶
Если в списке синхронизируемых полей присутствует Category, то при переносе элементов из внешней БД в МБД будет восстанавливаться структура категорий из внешней БД в виде подкатегорий в категории хранения.
В противном случае, элементы могут находится в любом месте корневой категории хранения.
Пользователи могут создавать любые подкатегории и размещать в них элементы. Это не повлияет на синхронизацию.
Deletion Mark¶
Метка удаления, указание которой позволяет удалять элементы. Для этого необходимо наличие аналогичного поля у внешней БД, позволяющего отметить элемент как удаленный. Это поле должно иметь возможность устанавливать текстовое значение. Признаком удаленности является значение Deleted.
При отсутствии такой метки и отсутствии поля в списке удаленные элементы будут перемещаться в категорию с фиксированным названием Deleted.
ID_Number (в МБД)¶
Поле используется для хранения в МБД идентификатора из внешней БД. Поле, соответствующее этому, также известно адаптеру. Указывать его явно нет необходимости, т.к. даже если поле не указано, оно будет использоваться системой интеграции.
Это поле МБД нельзя использовать для других целей и редактировать вручную, его значение должно быть уникальным в соответствующем разделе МБД.
При синхронизации нескольких станций для гарантированной уникальности этого поля может понадобится использовать постфикс. См. настройку Базы данных.
Расписания¶
Настройка расписаний интеграции имеет две цели:
- Указанные расписания могут сверяться (reconciliation), в том числе автоматически;
- Указанные расписания становятся доступны для импорта из приложений Digispot 2 (например, DJin).
Для настройки необходимо выбрать станцию внешней системы и расписание в Digispot 2.
Выбор опции Автозапуск включит автоматическое выполнение Сверки расписания, иначе сверку можно будет выполнить только вручную.
Базы Данных¶
Вкладка позволяет настроить станцию и указать параметры работы с материалом БД внешней станции:
- Станция - синхронизируемая станция;
- Автозапуск - будет ли синхронизация выполнятся автоматически или вручную;
- Период синхронизации - указывает период автоматического запуска в секундах (60 - минута, 3600 - час, 86400 - сутки), указывается в обязательном порядке, даже если автоматический запуск не используется;
- Постфикс - строка, добавляемая в конец ID_Number элементов этой станции для гарантированной уникальности.
После добавления записи о станции необходимо настроить хранение материала станции в МБД.
После выбора необходимой станции появится дополнительное окно - Хранение в МБД.
Хранение в МБД¶
Для выделенной станции в списке Хранение в МБД настраивается хранение материала каждой станции.
Внешняя БД каждой станции может предоставлять материалы разных типов, например, музыку и джинглы.
Для каждого типа материала, доступного в настраиваемой станции, указывается корневая категория МБД, внутри которой будет располагаться синхронизируемый материал.
В форме настройки хранения одного типа материала указывается:
- Тип материала. Хранимый тип материала внешней БД;
- Категория МБД. Корневая категория, внутри которой будут располагаться синхронизированные элементы. (См. также Сategory в списке синхронизируемых полей)
- Категория внешней БД. Это категория, в которой будут создаваться элементы при синхронизации в случае, если категория явно не определена.
Лог выполнения¶
Вкладка отображает файлы, содержащие системную информацию о работе программы, например, время события, тип, метод, описание и т.п. Позволяет просмотреть события, произошедшие в разные даты.
Статус¶
На вкладке Статус отображается результат последней операции для всех настроенных объектов:
- результаты выполнения синхронизации для баз данных;
- результаты сверки для расписаний.
С этой же страницы можно выполнить синхронизацию и сверку вручную, выделив необходимую строку в таблице и нажав кнопку Запуск.
Состояние на странице не изменяется автоматически: чтобы увидеть изменения, необходимо перезагрузить страницу.
