Важно!

С 01.06.2020 второй экран больше не дорабатывается. Поддержка прекратилась 31.12.2020. Используйте Guest Screen.

Введение

Существует плагин, позволяющий настраивать сцены второго экрана через менеджерскую станцию. Он работает через Feature Server и сам записывает данные в XML. У вас нет необходимости править INI файлы – все настройки делаются через менеджерскую станцию. Перед чтением статьи, обязательно ознакомьтесь с основной.

Второй экран не требует лицензирования.

Важно!

Если у вас установлены другие плагины, для которых нужны Common Server и Feature Server – для работы второго экрана нужно установить новые экземпляры с другими портами!

Кратко

Плагин живёт здесь: ftp://ftp.ucs.ru/rk7/INSTALL/RK7_XMLSecondScreen/.
Настройка идентична обычной настройке второго экрана, за исключением двух моментов:

Настройте и запустите Common Server и Feature Server.
Распакуйте файлы второго экрана на кассу.
Файлы плагина — в папку менеджерской станции. В файле плагина ssxml_settings.ini пропишите URL подключения к Common Server. Делать это нужно в разделе [CS_CONNECTION]:
```
[CS_CONNECTION] 
WSDL=http://127.0.0.1:7007/soap/UCSCommonWS
```
XML
Настройте XML-интерфейс

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

Подробно

Требуемые компоненты

Для работы плагина у вас должны быть запущены Common Server (CS), Feature Server и r_keeper_7, подключенный к MSSQL.
Настройки CS хранятся в файле CS_service.ini. Нужные порты пропишите в разделе [CS_CONNECTION]:

[CS_CONNECTION] 
def_port=11111 
SSL_port=11112

XML

Установка плагина

Настройка XML-интерфейса

Для работы второго экрана нужно на нужной кассе в менеджерской станции создать XML-интерфейс. Перейдите в раздел Кассовые станции и устройства и выберите нужную кассу. В разделе Устройства нажмите правой кнопкой мыши и добавьте интерфейс Second Screen with XML Interface.
Опционально можно указать имя лог-файла и выбрать уровень логирования.

Нажмите Сохранить или Ctrl+S.

Настройка плагина

Скачайте плагин с FTP: ftp://ftp.ucs.ru/rk7/INSTALL/RK7_XMLSecondScreen/.
Плагин состоит из 3-х частей, вам понадобятся все.

Ядро – SSXMLAIR_core
Сам плагин – SSXMLAIR_FS&Plugin. В этом же архиве есть экземпляр Feature Server'a.
Файлы оформления. Они есть в папке на /FTP SSXMLAIR_Designs/. Выберите и скачайте нужные вам.

Файлы ядра SSXMLAIR_core распакуйте в папку кассовой станции, к которой подключен второй экран. Обычно это папка \Rk7Cash. Туда же распакуйте файлы оформления, из архива SSXMLAIR_FS&Plugin.7z.

Важно!

Сохраняйте структуру папок! Как файлы есть в архиве, так они должны лежать и на диске.

Папку plugins с файлами распакуйте в папку plugins менеджерской станции \Rk7Manager\plugins\

Файлы оформления распакуйте в папку с кассовой станцией \Rk7Cash\. В корневой папке кассы должно появиться 3 файла:

SSString.xml
SSConfig.xml
SecondScreen.ini

А в папках media – исполняемый файл второго экрана и файлы оформления. В папке plugins – папка ssxml_settings.

Настройка Feature Server

Feature Server можно запускать как приложение или службу. Для установки:

Распакуйте файлы Feature Server из архива SXMLAIR_FS&Plugin в удобное место.
Откройте файл подключения к БД MSSQL_FS.udl:

Примечание
UDL – это обычный текстовый файл, содержащий строчку подключения. Его можно редактировать блокнотом.

[oledb] 
; Everything after this line is an OLE DB initstring 
Provider=SQLOLEDB.1;Password=1;Persist Security Info=True;User ID=sa;Initial Catalog=RK7_1803;Data Source=127.0.0.1

XML

2. Укажите:

IP-адрес сервера. Пишите порт только если он отличается от стандартного
Логин и пароль для доступа к БД

3. Нажмите Проверить соединение.

4. После успешной проверки, выберите БД из списка:

5. Сохраните настройки, нажав ОК.

6. Подключение к БД настроено. Осталось указать порты работы FS и CS. Откройте файл SSXMLFeatureServer.ini:

[FS_CONNECTION] 
; URL работы SSXMLFeatureServer 
url = http://127.0.0.1:9992/soap/IStructuresInfo 
urlSSL = 
start_port = 10000 
DB_Connect_Count = 2 
FSGuid ={469B5D64-113C-4E24-8621-BB3A76B5DC23} 
[CS_CONNECTION] 
; URL подключения Common Server к SSXMLFeatureServer 
url = http://127.0.0.1:7007/soap/UCSCommonWS 
urlSSL =

XML

Тут нужно изменить 2 настройки:

1. URL, по которому будет доступен SSXMLFeature Server
2. URL подключения Common Server к SSXMLFeature Server

7. Осталось запустить Feature Server. Чтобы Feature Server сам подключился к Common Server, включите последний заранее.
Откройте файл SSXMLFeatureServer.exe.

Строчка After registration: code 2, Previously означает что подключение к CS работает корректно.

8. Чтобы установить Feature сервер как службу, запустите файл SSXMLFeatureServer.exe с ключом /install.

Пример файла настроек

Пример работающей конфигурации файла SSXMLFeatureServer.ini с комментариями ниже.

[FS_CONNECTION] 
	; URL работы SSXMLFeatureServer 
	url = http://127.0.0.1:9992/soap/IStructuresInfo 
	; Тоже самое, только через SSL 
	urlSSL = 
	; Порт работы SSXMLFeatureServer 
	start_port = 9992 
	DB_Connect_Count = 10 
	; GUID SSXMLFeatureServer FSGuid = {045F8849-E925-4728-A277-6E4A391FFD70} 
[CS_CONNECTION] 
	; URL подключения Common Server к SSXMLFeatureServer 
	url = http://127.0.0.1:7007/soap/UCSCommonWS 
	; Тоже самое, только через SSL 
	urlSSL =

XML

Настройка плагина

Настройки плагина хранятся в файле \plugins\ssxml_settings\ssxml_settings.ini. Менять их имеет смысл только если ваш CS использует нестандартный адрес и порт. Пропишите в файле URL подключения:

[CS_CONNECTION] 
WSDL=http://127.0.0.1:7007/soap/UCSCommonWS

XML

Дополнительно можно выбрать уровень логирования от 1 до 3. Логи хранятся в папке \Logs\.

Эту же настройку нужно прописать в файле SecondScreen.ini кассовой станции. Раздел тот же – [CS_CONNECTION]. Укажите в этом файле код (номер) кассы, на котором должен работать второй экран.
Пример рабочего конфига:

[CS_CONNECTION]
WSDL=WSDL=http://127.0.0.1:7007/soap/UCSCommonWS 
[STATION] 
Code=1

XML

Использование плагина

Запуск плагина производится через менеджерскую станцию. Перейдите в меню Расширения > Конфигуратор SecondScreenXML (общий)

При открытии плагин не должен выдавать ошибок. В рабочем окне можно настраивать сцены, сценарии и режимы.

Подробнее о настройке второго экрана читайте в основной статье.

Решение проблем

Не удается установить связь с сервером

Ошибка. Не удается установить связь с сервером.

Причина. Common Server недоступен или не запущен.
Решение. Проверьте настройки CS в файле ssxml_settings.ini и перезапустите сервер.

Ошибка при обращении к Feature Server

Ошибка. Ошибка при обращении к Feature Server

Причина. Feature Server недоступен или не запущен.
Решение. Проверьте настройки Feature Server и перезапустите.

Нет доступного Feature Server для структуры

Ошибка. Нет доступного Feature Server для структуры

Причина. В настройках подключения выбрана неверная базе данных.
Решение. Выберите в файле MSSQL_FS.udl правильную базе данных.

FS internal error

Ошибка. FS Internal error

Причина. Неправильные параметры подключения к базе данных
Решение. Откройте файл MSSQL_FS.udl и укажите правильные настройки подключения.