Интеграции

CityScreen Deals из коробки подключается к нескольким внешним системам, и у каждой из них есть свой раздел настроек и свой журнал сбоев. Программы, которые входят в CityScreen Deals или входят через него от имени сотрудников, перечислены в разделе Идентификация и доступ к API. Всё, чего нет в этих списках, подключается через REST API или через движок процессов — см. Подключение системы, которой нет в этом списке.

Доступные интеграции

Интеграция	Направление	Назначение
CityScreen Play	Входящая и исходящая	Загружает из CS Play инвентарь цифровых экранов и передаёт обратно забронированные кампании как контент для воспроизведения.
CityScreen Context	Исходящая	Передаёт в программатик-маркетплейс данные о конструкциях, цены и свободные периоды, чтобы зарезервированный и забронированный инвентарь снимался с программатик-продажи.
Виджет бронирования инвентаря	Входящая	Встраиваемый виджет, в котором посетители сайта просматривают инвентарь и отправляют заявки на бронирование, а заявки приходят в виде сделок-заявок.
SAP Cloud for Customer	Входящая	Импортирует основные данные клиентов из SAP C4C, чтобы отдел продаж работал с теми же карточками клиентов, что и финансовая система.
Электронные счета ClearTax / LHDN	Исходящая, с опросом статуса	Отправляет счета на проверку электронных счетов через ClearTax, опрашивает статус государственного одобрения и скачивает QR-коды.
Unit4 CODA Financials	Исходящая	Проводит утверждённые счета в главной книге CODA как бухгалтерские транзакции, чтобы финансисты работали с тем счётом, который утвердил отдел продаж.
1С:Предприятие	Входящая и исходящая, из бизнес-процессов	Позволяет скриптовым задачам читать записи из базы 1С и создавать или изменять их по стандартному интерфейсу OData, а каждый запрос попадает в журнал организации.

Интеграция

Направление

Назначение

CityScreen Play

Входящая и исходящая

Загружает из CS Play инвентарь цифровых экранов и передаёт обратно забронированные кампании как контент для воспроизведения.

CityScreen Context

Исходящая

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

Виджет бронирования инвентаря

Входящая

Встраиваемый виджет, в котором посетители сайта просматривают инвентарь и отправляют заявки на бронирование, а заявки приходят в виде сделок-заявок.

SAP Cloud for Customer

Входящая

Импортирует основные данные клиентов из SAP C4C, чтобы отдел продаж работал с теми же карточками клиентов, что и финансовая система.

Электронные счета ClearTax / LHDN

Исходящая, с опросом статуса

Отправляет счета на проверку электронных счетов через ClearTax, опрашивает статус государственного одобрения и скачивает QR-коды.

Unit4 CODA Financials

Исходящая

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

1С:Предприятие

Входящая и исходящая, из бизнес-процессов

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

Идентификация и доступ к API

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

Функция	Кто использует	Назначение
OAuth-приложения	Ваши собственные системы и приложения, которым сотрудник дал доступ	Регистрирует приложение, которое получает токены доступа от CityScreen Deals: служебную учётную запись со своими ролями или доступ к REST API от имени сотрудника, который его разрешил.
Единый вход через OpenID Connect	Ваши другие веб-приложения	Позволяет сотруднику войти в вики, дашборд или другое приложение с учётной записью CityScreen Deals, передаёт группы сотрудника и сообщает приложению, когда сотрудник вышел.
LDAP-справочник	Почтовые серверы и другие системы	Публикует сотрудников и группы сотрудников как справочник только для чтения по LDAPS и проверяет пароли для систем, в которые входят люди.
Персональные токены доступа	Скрипты и локальные инструменты сотрудника	Токен, с которым REST API вызывается с собственными правами сотрудника.

Функция

Кто использует

Назначение

OAuth-приложения

Ваши собственные системы и приложения, которым сотрудник дал доступ

Регистрирует приложение, которое получает токены доступа от CityScreen Deals: служебную учётную запись со своими ролями или доступ к REST API от имени сотрудника, который его разрешил.

Единый вход через OpenID Connect

Ваши другие веб-приложения

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

LDAP-справочник

Почтовые серверы и другие системы

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

Персональные токены доступа

Скрипты и локальные инструменты сотрудника

Токен, с которым REST API вызывается с собственными правами сотрудника.

Сотрудники создают персональные токены доступа и пароли приложений для своих почтовых клиентов в разделе Аккаунт. См. Токены доступа и пароли приложений.

Где находятся настройки

Учётные данные и переключатели интеграций настраиваются в разделе Настройки → Настройки синхронизации (в модели прав — «Настройки синхронизации»). У каждой интеграции на странице синхронизации есть свой раздел: интеграция с CMS, интеграция с SSP, интеграция с С4С и интеграция с ClearTax.

Виджет бронирования инвентаря настраивается отдельно, в разделе Настройки → Общие → Виджет бронирования инвентаря.

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

CityScreen записывает подключение к Unit4 CODA Financials для вашей организации.

Учётные записи для подключения к базам 1С:Предприятие хранятся в разделе Настройки → 1С и регулируются правом Настройки организации.

Если исходящая передача завершилась сбоем

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

Подключение системы, которой нет в этом списке

Перечисленные выше интеграции входят в состав продукта. Всё остальное — бухгалтерскую систему, ERP, региональный налоговый орган, собственную точку приёма отчётов клиента — подключают через REST API или через движок процессов.

Есть три способа. При работе через REST API обмен начинает другая система и обращается к CityScreen Deals. Скриптовая задача и серверное расширение работают внутри бизнес-процесса, который обращается во внешнюю систему. Эти два способа отличаются тем, кто пишет код.

REST API: Ваша система входит с помощью OAuth-приложения, то есть служебной учётной записи со своими ролями, или с помощью персонального токена доступа, когда вызов делает скрипт сотрудника. Она действует с правами, которые есть у этих учётных данных. Нашего участия для этого не требуется, если лицензия вашей организации включает эти функции. Способ подходит системе, которая сама начинает обмен, например передаёт запись или читает список.

См. OAuth-приложения и Токены доступа и пароли приложений.
Скриптовая задача: Шаг бизнес-процесса, который выполняет JavaScript, написанный вами в дизайнере процессов. Он может читать и записывать переменные процесса и обращаться во внешние системы по HTTP. Нашего участия для этого не требуется: администратор с доступом к дизайнеру процессов может создать и изменить такую задачу. Способ подходит для простых обменов: отправить данные, получить значение или преобразовать данные между шагами.

См. Скриптовые задачи.
Серверное расширение: Компонент, который CityScreen разрабатывает для вашей организации и который процесс вызывает как сервисную задачу. Это способ для обменов, которые скрипт выполнить не может: проприетарные протоколы, учётные данные, которые ни в коем случае не должны попасть в скрипт, большие объёмы данных или всё, что требует повторных попыток и транзакционного поведения.

См. Сервисные задачи о том, как процесс вызывает такое расширение.

Серверные расширения — это индивидуальная разработка, которую заказывают отдельно для каждого клиента. Расскажите нам, что нужно подключить, и мы оценим работу.

Скриптовая задача и серверное расширение находятся внутри бизнес-процесса, а значит, наследуют его механизмы: они выполняются там, где вы поставили их в потоке, а при сбое вызывают инцидент в инстансе процесса.