Настройка связи со сторонними системами видеонаблюдения по ITV
Введение
Результатом интеграции кассовой системы r_keeper_7 и системы контроля кассовых операций ITV POS Intellect является наложение титров на видео. Управление, обработка и хранение видеоконтента осуществляется исключительно на стороне системы ITV POS Intellect
Лицензирование
Для работы интерфейса требуется лицензия. Запрос на лицензию оформляется через сервер лицензирования, процесс лицензирования описан ниже.
Лицензия называется R-Keeper интерфейс Видеонаблюдение ПО.
Настройка в менеджерской станции
Настройка менеджерской требуется для возможности просмотра в отчетах архивного видеоматериала, соответствующего кассовым операциям.
Для включения доступа к функциям видеонаблюдения в менеджерской необходимо включить логический параметр Исп. видеонаблюдение. Для этого перейдите в Настройки > Параметры > Использование опций > Связь с доп. системами и оборудованием и поставьте галочку в поле Логический:
Настройка интерфейса
1. В менеджерской станции для соответствующего кассового сервера на вкладке «Устройства» из списка драйверов добавить интерфейс ITV POS Intellect interface.
Для связи с внешней системой ITV свойствах данного драйвера необходимо либо прописать путь к каталогу (VideoPath), из которого модуль системы ITV будет забирать файлы, либо прописать IP-адрес (NCR_FORWARD IP) и порт модуля системы ITV (NCR_FORWARD Port).
Примечание
Параметр VideoPath является приоритетным по отношению к параметру NCR_FORWARD IP. Если в параметре VideoPath указано какое-либо значение, NCR_FORWARD IP будет игнорироваться.
Параметры интерфейса:
- NCR_FORWARD IP = 100.100.100.100 — IP адрес NCR_FORWARD.exe (модуль ITV, который пересылает данные POS Intellect)
- NCR_FORWARD Port = 1111 — порт NCR_FORWARD, отправка NCR_FORWARD не происходит, если значение 0
- Use Alt сharset = No — Если Yes, используется альтернативный набор символов, иначе основной
- ActualTime = 15 — Время, в секундах, в течение которого данные считаются актуальными. Более старые данные не пересылаются NCR_FORWARD. На запись файлов этот параметр не влияет
- Log file name — путь к лог-файлу
2. Выбрать логический интерфейс ("Cервис-Интерфейсы") и связать его с драйвером: в свойстве логического интерфейса для кассового сервера в группе свойств "Файлы библиотек DLL" выбрать "ITV POS Intellect interface #1".

3. Создайте для ITV interface отдельное "Назначение печати".

4. После выполнения предыдущих действий у ресторана в группе свойств "Информация о Лицензии" появится свойство ITV POS Intellect, куда надо ввести ключ лицензии:

5. В свойствах ресторана в разделе "Назначения принтеров" для созданного параметра в п.3 "ITV Purpose" необходимо выбрать интерфейс "ITV POS Intellect" (можно использовать предустановленное назначение печати "Для XML отчетов", но не рекомендуется). Возможно также выбрать принтер в свойствах определенной кассовой станции вместо выбора в свойcтвах ресторана.

6. Для передачи данных в ITV POS Intellect используется механизм макетов - интерфейс обрабатывает всю печать, которая идет на него.
В стандартной поставке есть два предустановленных макета: "66 ITV POS Intellect" для чека и "67 ITV POS Intellect" для сервис печати.
Другие операции не поддерживаются, но если операция генерирует какую-либо печать, ее можно поддержать самостоятельно - для этого нужно подготовить спец. макет и настроить печать макета на интерфейс "ITV Pos Intellect".
Важно!
Макет должен генерировать данные в определенном формате. Формат описан в документе Работа с файлом настроек xml_titles.txt7. После создания собственных макетов необходимо отредактировать представление документа "Чек" (справочник "Настройки-Печать-Схемы печати").

Важно!
Не меняйте параметры "Класс основного принтера" и "Класс доп. принтера".Для XML-принтера выберите "ITV purpose" и выберите XML макет в секции Основное.
8. Создайте новый сервис чек, у него заполните поле "XML принтер" = интерфейс "ITV POS Intellect", а поле "Макет" необходимым макетом, например "67 ITV POS Intellect".
Важно!
Параметры "Принтер" и "Резервный принтер" не выбираем.
9. Сохраняем все, перезапускаем кассовый сервер, перезапускаем станцию.
Разделение титров от нескольких касс одного кассового сервера
Т.к. интерфейс "ITV POS Intellect interface" подключается к кассовому серверу, по умолчанию титры со всех кассовых станций этого кассового сервера будут пересылаться на один порт (см. параметр NCR_FORWARD Port ).
Конфигурация с 2-мя интерфейсами на одном кассовом сервере теоретически будет работать, но смысла в ней нет - кассовый сервер формирует только служебные теги и в оба интерфейса будут отправляться одинаковые данные.
Для разделения титров с разных кассовых станций одного кассового сервера можно использовать утилиту ncr_forward.exe (разработчик компания ITV), загрузить которую можно по ссылке ftp://ftp.ucs.ru/r-keeper/VideoIntellect/NCR_FORWARD.zip
В итоге, для разделения титров используется следующая конфигурация:
- на кассовый сервер добавляем один интерфейс "ITV POS Intellect interface" и настраиваем параметры NCR_FORWARD IP и NCR_FORWARD Port на подключение к ncr_forward.exe
- в настройках ncr_forward.exe в секции [FORWARD] указываем коды станций и соотв. порты на сервере видеонаблюдения
- остальные настройки выполняем стандартным способом
Примечание
Примечание: Конфигурация с использованием ncr_forward.exe будет работать с любой сторонней системой видеонаблюдения, интеграция с которой реализуется через интерфейс "ITV POS Intellect interface"Передавать изменение КДС-статуса блюд в ITV POS Intellect
Для передачи данных статусов готовности заказов через VDU сделайте дополнительные настройки, при этом драйвер ITV POS Intellect interface остается, передача данных в Trassir будет проходить через него.
Отправка данных со всех кассовых серверов через один кассовый сервер сделать нельзя. При необходимости сделайте общий кассовый сервер и включите все кассы в него.
Дополнительные настройки для передачи статусов готовности заказов с VDU через кассовый сервер в виде меток в систему видеонаблюдения через интерфейс ITV POS Intellect Interface, необходим драйвер UCS Video Title cash server interface (ucsvidt_srv.dll) (файл ifVidt_srv.udb, включен в сборку r_keeper c версии 7.25.2.4) :
- Добавьте логический интерфейс UCS Video Title cash server interface с именем библиотеки ucsvidt_srv.dll.
- Добавьте драйвер UCS Video Title cash server interface в конфигурацию кассового сервера.
- Удалите драйвер UCS Video Title Interface (ucsvidt.dll) из конфигурации касс.
Пример запроса:
<?xml version="1.0" encoding="utf-8"?>
<RK7Query>
<RK7Command CMD="KDSSetDishData3" line_guid="{7C2057CB-F67B-4908-9BB7-ED6FC99D0F2E}" kdsstate="ready" kds_state_sender="vdu">
<Employee code="1"/>
<Station code="1"/>
</RK7Command>
</RK7Query>
Ответ, сформированный библиотекой intellect.dll для системы видеонаблюдения:
<?xml version="1.0" encoding="utf-8"?>
<Document item_code="3" item_name="Order Changed" guid="{8A4AB428-B1AB-4301-A400-A3B889A1F7CA}" title_dll_version="1">
<SysParams>
<rest_code>199990009</rest_code>
<unit_code>1</unit_code>
<server_name>MIDSERVER</server_name>
<transaction_time>2024-12-03T10:10:44</transaction_time>
<shift_date>2024-10-22T00:00:00</shift_date>
<shift_num>348</shift_num>
</SysParams>
<Order>
<item_code>1</item_code>
<item_name>т7</item_name>
<guid>{4E4458DB-EA29-4D6A-B487-0EF6FE606200}</guid>
<item_total>6000</item_total>
<transaction_time>2024-12-02T15:11:37</transaction_time>
<order_type>
<item_code>1</item_code>
<item_name>Общий</item_name>
</order_type>
<Guests>
<Guest>
<item_seat>1</item_seat>
<item_name>1</item_name>
</Guest>
<Guest>
<item_seat>2</item_seat>
<item_name>2</item_name>
</Guest>
</Guests>
<Waiter>
<item_code>1</item_code>
<item_name>Администратор зала торговых аппаратов</item_name>
<ptype>Администраторы</ptype>
</Waiter>
</Order>
<CheckLines>
<CheckLine>
<item_code>32</item_code>
<item_name>Котлеты по киевски</item_name>
<guid>{BD2E6DFC-C40B-4D35-97E6-932EA827C2B4}</guid>
<item_price>60.00</item_price>
<item_count>1.000</item_count>
<item_seat></item_seat>
<printed>1</printed>
<kds_state>ready</kds_state>
</CheckLine>
</CheckLines>
<Discounts></Discounts>
<ChangedItem>
<guid>{BD2E6DFC-C40B-4D35-97E6-932EA827C2B4}</guid>
<changed>1</changed>
<oldvalue>sent</oldvalue>
<newvalue>ready</newvalue>
<oper_guid>{7C5BD723-F0E7-4AD3-9CFD-F3E752B366EE}</oper_guid>
<oper_code>263</oper_code>
<oper_name>Изменение КДС-статуса у блюда</oper_name>
<Manager>
<item_code>1</item_code>
<item_name>Администратор зала торговых аппаратов</item_name>
<ptype>Администраторы</ptype>
</Manager>
<Item>
<CheckLine>
<item_code>32</item_code>
<item_name>Котлеты по киевски</item_name>
<guid>{BD2E6DFC-C40B-4D35-97E6-932EA827C2B4}</guid>
<item_price>60.00</item_price>
<item_count>1.000</item_count>
<item_seat></item_seat>
<kds_state>ready</kds_state>
</CheckLine>
</Item>
</ChangedItem>
</Document>