Вимоги до розробки драйверів для дисплеїв покупця
Система програм 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) |
