Вимоги до розробки драйверів для терміналів збору даних
Система програм 1С:Підприємство підтримує обмін даними з різними моделями терміналів збору даних за узгодженою технологією.Вступ
Оновлено: 14.02.2008
Вступ
Система програм 1С:Підприємство підтримує обмін даними з різними моделями терміналів збору даних за узгодженою технологією (рис.1).
Рис.1
Конфігурація системи програм «1С:Підприємство 8» взаємодіє з обробками обслуговування терміналів збору даних.
Обробки обслуговування терміналів збору даних взаємодіють із зовнішніми компонентами для терміналів збору даних (драйверами для інтеграції з «1С:Підприємство 8»).
Зовнішня компонента (далі за текстом «драйвер») може взаємодіяти:
- безпосередньо з моделлю термінала збору даних;
- з програмним забезпеченням (АРМ), що постачається разом із терміналом збору даних;
- з драйвером термінала збору даних низького рівня, написаним за технологією OLE for POS (OPOS).
Загальні вимоги до драйвера:
Драйвер повинен:
- бути розроблений у вигляді зовнішньої компоненти (опис механізму створення зовнішніх компонент наведено в документі «Документація з технології створення зовнішніх компонент» на диску ІТС у розділі «Технологія створення зовнішніх компонент» Методичної підтримки 1C:Підприємства 8.1.);
- забезпечити можливість реалізації функціоналу в повному обсязі для підключеного виду обладнання
- надавати набір властивостей і методів для налаштування та керування драйвером відповідно до опублікованих на диску ІТС у розділі «Робота з торговим обладнанням» Методичної підтримки 1С:Підприємства 8.1 вимог до виду обладнання, представленого на сертифікацію
- надавати російськомовні та англомовні назви властивостей і методів (наприклад, Порт- Port, Швидкість - Speed, Підключити() - Open(), ВивантажитиТаблицю() - UploadTable() та ін.);
- підтримувати множинні підключення (відповідно до ідеології COM-технології), а також підтримувати роботу з кількома пристроями, якщо це дозволяють бізнес-процеси, у яких використовується це обладнання;
- у разі виникнення помилки в роботі надавати докладний опис помилки, що сталася, який дає змогу користувачеві зрозуміти причину виникнення помилки та спосіб її усунення;
- у разі виникнення позаштатних ситуацій (некоректні дії користувача, відсутність запитуваного методу чи функції, передавання некоректних значень тощо) коректно їх обробляти. Не повинно бути аварійних завершень роботи драйвера та інших некоректних дій драйвера, які можуть призвести до порушення нормальної роботи користувача.
Опис роботи з драйвером
Початок роботи з драйвером
Система 1С:Підприємство (надалі "система") ініціалізує з'єднання з драйвером і завантажує його. Далі встановлюються конфігураційні параметри, необхідні для роботи. Підключення до пристрою виконується на початку операції з пристроєм торгового обладнання.
Завершення роботи
Відключення від пристрою виконується після закінчення операції з пристроєм.
З'єднання з драйвером закривається лише під час завершення роботи системи.
Опис властивостей
|
Опис властивостей | ||||
|---|---|---|---|---|
|
Назва (alias) |
Тип |
Доступність |
Опис | |
| Читання | Запис | |||
Опис методів
|
Опис методів | |||||
|---|---|---|---|---|---|
|
Назва (alias) |
Параметри |
Значення, що повертається |
Опис | ||
|
Ім'я |
Тип |
Опис | |||
| ОтриматиНомерВерсії (GetVersion) | - | - | - | BSTR | Повертає номер версії драйвера |
| ОтриматиПомилку(GetLastError) | ОписПомилки (ErrorDescription) |
BSTR [OUT] | Опис помилки | LONG | Повертає код і опис останньої помилки, що сталася |
| Підключити (Open) | МасивЗначень (Valuesarray) |
IDispatch* |
Масив значень для налаштування підключення | BOOL | Підключає ТЗД |
| ІДПристрою (DeviceID) | BSTR [OUT] | Ідентифікатор пристрою | |||
| Відключити (Close) | ІДПристрою (DeviceID) | BSTR [IN] | Ідентифікатор пристрою | BOOL | Відключає ТЗД |
| ВивантажитиТаблицю (UploadTable) | ІДПристрою (DeviceID) | BSTR [IN] | Ідентифікатор пристрою | BOOL | Вивантажує таблицю в ТЗД |
| ТаблицяВивантаження (UploadTable) | IDispatch*[IN] | Таблиця, що вивантажується | |||
| ЗавантажитиТаблицю (DownloadTable) | ІДПристрою (DeviceID) | BSTR [IN] | Ідентифікатор пристрою | BOOL | Завантажує таблицю з ТЗД |
| ТаблицяЗавантаження (DownloadTable) | IDispatch*[OUT] | Таблиця, що завантажується | |||
| ТестПристрою (DeviceTest) | МасивЗначень (Valuesarray) |
IDispatch* |
Масив значень для налаштування підключення |
BOOL |
Виконує пробне підключення та опитування пристрою. У разі успішного виконання підключення в описі повертається опис пристрою. У разі негативного результату повертається опис проблеми, що виникла під час підключення. |
| ДодатковийОпис (additionalDescription) |
BSTR |
Опис результату виконання тесту | |||
Додатковий опис :
"МасивЗначень" (приклад значень для пристрою, що підключається до послідовного порту)
Тип даних "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) |
| Чутливість (Sensitivity) | Необов'язково | LONG | Задає чутливість клавіатурного введення під час роботи з периферійним пристроєм через клавіатурний порт |
| БазаВивантаження (BaseNumber) | Необов'язково | LONG | Номер бази, до якої виконується вивантаження |
| ДокументЗавантаження (DocumentNumber) | Необов'язково | LONG | Номер документа, з якого виконується завантаження |
"ТаблицяВивантаження"
Тип даних "1С:Підприємства 8" - ТаблицяЗначень.
|
Ім'я |
Наявність у структурі |
Тип |
Опис |
|---|---|---|---|
| Штрихкод (BarCode) | Обов'язкове | BSTR | Штрихкод |
| Найменування (Quantity) | Необов'язково | BSTR | Найменування |
"ТаблицяЗавантаження"
Тип даних "1С:Підприємства 8" - ТаблицяЗначень.
|
Ім'я |
Наявність у структурі |
Тип |
Опис |
|---|---|---|---|
| Штрихкод (BarCode) | Обов'язкове | BSTR | Штрихкод |
| Кількість (Quantity) | Необов'язково | LONG | Кількість |
