Правила форматирования клиентских экранов NDC¶

Предустанавливаемые экраны¶

Экран C01.

Отображается когда УС находится в автономном режиме (Off-Line mode).

Не используется при активации режима отложенной авторизации операций CASHIN_OFFLINE_MODE.

Содержимое экрана:
```
[HKEY_LOCAL_MACHINE\SOFTWARE\FS365\NDC\SCREEN\C01]
"CONTENTS"=hex:0c,0e,30,30,31
```
Экран C02.

Отображается когда УС находится в режиме остановки обслуживания (Out-of-Service mode).

Содержимое экрана:
```
[HKEY_LOCAL_MACHINE\SOFTWARE\FS365\NDC\SCREEN\C02]
"CONTENTS"=hex:0c,0e,30,30,32
```
Экран C03.

Отображается когда УС находится в режиме сервисного обслуживания (Supervisor mode).

Содержимое экрана:
```
[HKEY_LOCAL_MACHINE\SOFTWARE\FS365\NDC\SCREEN\C03]
"CONTENTS"=hex:0c,0e,30,30,33
```
Экран C04.

Отображается когда УС задерживает карту не по команде хоста.

Содержимое экрана:
```
[HKEY_LOCAL_MACHINE\SOFTWARE\FS365\NDC\SCREEN\C04]
"CONTENTS"=hex:0c,0e,30,30,34
```

Печать содержимого внутреннего буфера NDC¶

Расширенная команда описания экрана, позволяющая вывести содержимое указанного буфера NDC. Формат команды:

\1bDORS_EXT;PRINT_BUFFER(<buffer_id>, <codepage>)\1b\5c

Параметры:

buffer_id — идентификатор целевого буфера (в частности, «BarcodeData»). Возможные значения: Track1, Track2, Track3, ChipData, CardPINBlock, AmountBuffer, OperationCodeBuffer, Buffer_B, Buffer_С, BarcodeData, BNANotesInEscrow.
codepage — кодировка, в которой представлены данные в буфере. Возможные значения: UTF-8 или номер кодовой страницы ANSI.

Пример вывода на экран содержимого буфера штрихкода:

\1bDORS_EXT;PRINT_BUFFER(BarcodeData;UTF8)\1b\5c

Расширенный набор NDC-экранов для информирования кассира АДМ о пропадании электропитания¶

В ПроАТМ обеспечена поддержка расширенного набора экранов NDC с целью своевременного информирования клиента о пропадании напряжения в сети электропитания. Задействованы Reserved Screens группы „C“ — Cardholder Display, для вывода соответствующих сообщений на экран.

Экран С96.

В случае, если пропало напряжение в сети электропитания, АДМ переходит в режим OUT OF SERVICE. Если экран не определён в сценарии банка, отображается стандартный экран Out Of Service C02/С01.
Экран С97.

В случае, если на момент перехода в состояние CashAcceptState, пропало напряжение в сети электропитания, на экране будет выведено сообщение «Отсутствует питание, прием невозможен».

Если экран не определён в сценарии банка, будет отображен Hardware Error Screen из параметра №4 CashAcceptState..
Экран С98.

После перехода в состояние CashAcceptState, выполняется приём наличных. При пропадании напряжения в сети электропитания и наличии принятых банкнот на Cash Accept state будет отображен экран C98 со следующим сообщением: «Отсутствует питание, подтвердите зачисление». Если экран не определён в сценарии банка, отображается Escrow Full Screen из параметра №5 CashAcceptState.

В ПроАТМ предусмотрен режим автоматиечского зачисления принятых денежных средств. В данном режиме производится принудительное завершение операции внесения наличных по истечении NDC-таймера 098.

Допустимые значения таймера — от 1 до 15 сек. включительно. По истечении таймера выполняется автоматический переход на зачисление принятых денежных средств (выход с Cash Accept State по Good Next State Number).

Для активации режима, требуется задать значение NDC-таймера 098. Это можно сделать одним из следующих способов:
1. Значение таймера задается NDC-сценарием и будет загружено с хоста:
```
3\1c000\1c\1c1A\1c\1c\1c98005
```
2. Значение таймера задается кастомизацией:
```
[HKEY_LOCAL_MACHINE\SOFTWARE\FS365\NDC\TIMER]
"TIMER_98"="005"
```
Если таймер не установлен/имеет недопустимое значение, то будет использована классическая схема: будет выведена таблица принятых банкнот, активные кнопки и т.д. для экрана С98.

Использование html-документов для замены экранов NDC¶

При работе по протоколам NDC, при получении прогрузки от хостовой системы, описание NDC-экранов помещается в ветку системного реестра [HKEY_LOCAL_MACHINE\SOFTWARE\FS365\NDC\SCREEN]. При этом для каждого экрана создается собственная папка, имя которой определяется номером NDC-экрана. Так, например, описание экрана 015 будет размещено в папке с именем 015.

Описание экрана NDC хранится в бинарном поле с именем CONTENTS. В случае если NDC-экран должен быть заменен web-формой, значение поля CONTENTS должно содержать ссылку на внешнюю web-форму html-документа, оформленную в соответствии с правилами записи Uniform Resource Locator, описанными в документе IETF RFC 1738.

При этом в случае использования протокола NDC URL указывается в ESC-последовательности Display Image Files Control. Например, значение поля CONTENTS \1сhttp://www.myserver.by/birthday.html\1c\ приведет к попытке загрузки web-формы birthday.html с сайта www.myserver.by по протоколу http.

Примечание

ПроАТМ поддерживает web-расширения SmartVista, разработанные компанией БПЦ. Дополнительные материалы по интеграции могут быть взяты из соответствующей справочной документации STANDARD SMARTVISTA FRONT END. HTML extension for NDС+.

ПроАТМ обновляет значения полей CONTENTS при получении новой хостовой прогрузки, что отражает общую концепцию DirectConnect-протоколов, в соответствии с которой конфигурация хранится и изменяется централизованно, а на УС хранится кэш (cache), обновляемый по команде хоста. Таким образом, изменение значения полей CONTENTS и EXTERNAL локально в системном реестре не приведет к созданию надежного решения по расширению функциональных возможностей устройства самообслуживания без необходимости внесения изменений в хостовую прогрузку.