Выход во внешние системы

Описание

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

Внимание!

Выход во внешние приложения доступен только для версии ISO-образа кассы не ниже 1.28.1!

В меню доступны:

• запуск приложения сutecom, которое позволяет быстро и удобно произвести диагностику COM-портов с помощью удобного графического пользовательского интерфейса;
• запуск приложения Xterm, которое обеспечивает доступ к терминальной консоли Linux;
• через RDP можно предоставить доступ к удаленному RPD-серверу по протоколу RDP 5.0 (Windows, Linux, Mac) с поддержкой RemoteApp для Windows:

Настройки на кассовом сервере

Общие настройки выхода во внешние системы через RDP аналогичны описанным выше и так же производятся в файле external_apps.conf (applications\external_apps\external_apps.conf) по адресу Магазин – Типы касс на кассовом сервере УКМ 5, куда добавляется следующий фрагмент: 

Например:

Имя скрипта start_freerdp.sh следует заменить на другое, чтобы в ходе будущих обновлений этот скрипт-пример не затёрся.

В файле external_apps.conf (applications\external_apps\external_apps.conf) на кассовом сервере задается только наименование кнопки в разделе кассового меню Внешние приложения, а также название скрипта запуска приложения, который будет размещен в папке \home\ukm5\mint\bin\ext_apps\ непосредственно на кассе. Кроме того, здесь же указывается  дополнительный параметр остановки кассового модуля (когда запуск скрипта производится с выключением кассового модуля и последующим его запуском вновь). 

Лог запуска скрипта будет фиксироваться в файле application.log (home\ukm5\mint\bin\logs\application.log), расположенном на кассе. Работа скрипта и возможные ошибки в ее ходе будут отражены в файле service-имя_скрипта.log (home\ukm5\mint\bin\logs\service-имя_скрипта.log), также расположенному на кассе.

Настройки на кассе

Непосредственно сам файл скрипта необходимо разместить на кассе в папке \home\ukm5\mint\bin\ext_apps\ в файле формата BASH или SHELL, с правами запуска 766. 

В настройках на кассе необходимо скопировать скрипт запуска RDP start_freerdp.sh и сделать из него свой, подобный, например:

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

result_with_restart
echo "==== UI started"

echo
echo "==== starting mint service"
systemctl start mint
result
echo "==== mint service started"


echo
echo "==== $0 completed $(date) ========="

exit 0

Чтобы работа и ошибки самого скрипта отразились в лог-файле application.log, надо добавить в начало скрипта следующий фрагмент:

MINT_DIR="/home/ukm5/mint/bin" NAME=$(tail $MINT_DIR/.ext_app) LOGFILE=$MINT_DIR/logs/service-$NAME.log

Также, в строке каждой команды, от которой требуется вывод сообщения в лог, необходимо добавить запись >> $LOGFILE.

Логи пишутся в папку /home/ukm5/mint/bin/logs/, расположенную на кассе: лог запуска скрипта фиксируется в файле application.log; работа и ошибки самого скрипта – в файле service-имя_скрипта.log.

Приложение xfreerdp позволяет подключаться по разным параметрам; также есть возможность использовать файл формата .rdp.

Руководство по работе с xfreerdp и описание всех параметров располагается здесь: https://wiki.yola.ru/_media/freerdp/freerdp-user-manual.pdf.

Описание всех параметров файла формата .rdp можно найти по адресу: https://docs.microsoft.com/ru-ru/windows-server/remote/remote-desktop-services/clients/rdp-files.