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