Требования к разработке драйверов для дисплеев покупателя
Система программ 1С:Предприятие поддерживает обмен данными с различными моделями дисплеев покупателя по согласованной технологии (рис.1).Введение
Обновлено: 14.02.2008
Введение
Система программ 1С:Предприятие поддерживает обмен данными с различными моделями дисплеев покупателя по согласованной технологии (рис.1).
Рис.1
Конфигурация системы программ «1С:Предприятие 8» взаимодействует с обработками обслуживания дисплеев покупателя.
Обработки обслуживания дисплеев покупателя взаимодействуют с внешними компонентами для дисплеев покупателя (драйверами для интеграции с «1С:Предприятие 8»).
Внешняя компонента (далее по тексту «драйвер») может взаимодействовать:
- непосредственно с моделью дисплея покупателя;
- с программным обеспечением (АРМ), поставляемым вместе с дисплеем покупателя;
- с драйвером дисплея покупателя низкого уровня, написанным по технологии OLE for POS (OPOS).
Общие требования к драйверу:
Драйвер должен:
- быть разработан в виде внешней компоненты (описание механизма создания внешних компонент приведено в документе «Документация по технологии создания внешних компонент» на диске ИТС в разделе «Технология создания внешних компонент» Методической поддержки 1C:Предприятия 8.1.);
- обеспечить возможность реализации функционала в полном объеме для подключаемого вида оборудования
- предоставлять набор свойств и методов для настройки и управления драйвером в соответствии с опубликованными на диске ИТС в разделе «Работа с торговым оборудованием» Методической поддержки 1С:Предприятия 8.1 требованиями к виду представленного на сертификацию оборудования
- предоставлять русскоязычные и англоязычные названия свойств и методов (например, Порт - Port, Скорость - Speed, ОчиститьДисплейПокупателя() - ClearCustomerDisplay() и др.);
- поддерживать множественные подключения (в соответствии с идеологией COM-технологии), а также поддерживать работу с несколькими устройствами, если позволяют бизнес-процессы, в которых используется данное оборудование;
- при возникновении ошибки в работе предоставлять подробное описание произошедшей ошибки, позволяющее пользователю понять причину возникновения ошибки и способ ее устранения;
- при возникновении внештатных ситуаций (некорректные действия пользователя, отсутствие запрашиваемого метода или функции, передача некорректных значений и др.) корректно обрабатывать их. Не должно быть аварийных завершений работы драйвера и прочих некорректных действий драйвера, которые могут привести к нарушению нормальной работы пользователя.
Описание работы с драйвером
Начало работы с драйвером
Система 1С:Предприятие (в дальнейшем "система") инициализирует соединение с драйвером и загружает его. Далее устанавливаются конфигурационные параметры, необходимые для работы. Подключение к устройству выполняется при начале операции с устройством торгового оборудования.
Завершение работы
Отключение от устройства выполняется при окончании операции с устройством.
Соединение с драйвером закрывается только при завершении работы системы.
Описание свойств
|
Описание свойств | ||||
|---|---|---|---|---|
|
Название (alias) |
Тип |
Доступность |
Описание | |
| Чтение | Запись | |||
Описание методов
|
Описание методов | |||||
|---|---|---|---|---|---|
|
Название (alias) |
Параметры |
Возвращаемое значение |
Описание | ||
|
Имя |
Тип |
Описание | |||
| ПолучитьНомерВерсии (GetVersion) | - | - | - | BSTR | Возвращает номер версии драйвера |
| ПолучитьОшибку(GetLastError) | ОписаниеОшибки (ErrorDescription) |
BSTR [OUT] | Описание ошибки | LONG | Возвращает код и описание последней произошедшей ошибки |
| Подключить (Open) | МассивЗначений (Valuesarray) |
IDispatch* |
Массив значений для настройки подключения | BOOL | Подключает дисплей покупателя |
| ИДУстройства (DeviceID) | BSTR [OUT] | Идентификатор устройства | |||
| Отключить (Close) | ИДУстройства (DeviceID) | BSTR [IN] | Идентификатор устройства | BOOL | Отключает дисплей покупателя |
| ВывестиСтрокуНаДисплейПокупателя (StringOutputOnCustomerDisplay) | ИДУстройства (DeviceID) | BSTR [IN] | Идентификатор устройства | BOOL | Выводит переданные строки на дисплей покупателя. Одна строка массива соответствует одной строке дисплея. Если строка пуста, то информация в данной строке на дисплее не меняется |
| МассивСтрок (Stringsarray) | IDispatch* [IN] |
Массив строк, содержащий информацию для отображения на дисплее | |||
| ОчиститьДисплейПокупателя(ClearCustomerDisplay) | ИДУстройства (DeviceID) | BSTR [IN] | Идентификатор устройства | BOOL | Очищает дисплей покупателя |
| ТестУстройства (DeviceTest) | МассивЗначений (Valuesarray) |
IDispatch* [IN] |
Массив значений для настройки подключения |
BOOL |
Выполняет пробное подключение и опрос устройства. При успешном выполнении подключения в описании возвращается описание устройства. При отрицательном результате возвращается описание возникшей проблемы при подключении. |
| ДополнительноеОписание (additionalDescription) | BSTR [OUT] |
Описание результата выполнения теста | |||
Дополнительное описание:
"МассивЗначений" (пример значений для устройства, подключаемого на последовательном порту)
Тип данных "1С:Предприятия 8" - Массив.
| Наименование параметра | Наличие в структуре | Типы данных | Описание параметра |
|---|---|---|---|
| Порт (Port) | Обязательное | LONG | Номер последовательного порта (1 соответствует порту COM1). |
| Скорость (Speed) | Необязательно | LONG | Скорость последовательного порта, на которой подключается устройство (передается непосредственно значение 9600, 19200, 57600, 115200 и т.д.) |
| Четность (Parity) | Необязательно | LONG | Задает значение, определяющее метод контроля четности при работе с периферийным устройством по COM-порту (Значения: 0 - "Нет", 1 - "Нечетность", 2 - "Четность", 3 - "Установлен", 4 - "Сброшен") |
| БитыДанных (DataBits) | Необязательно | LONG | Задает значение, определяющее количество бит данных при работе с периферийным устройством по COM-порту (Значения: 7, 8) |
| СтопБиты (StopBits) | Необязательно | LONG | Задает значение, определяющее количество стоповых бит при работе с периферийным устройством по COM-порту (Значения: 1, 2) |
