Вимоги до розробки драйверів для електронних ваг з друком етикеток у режимі "offline"
Система програм 1С:Підприємство підтримує обмін даними з різними моделями електронних ваг з друком етикеток у режимі "offline" за узгодженою технологією (рис.1).Вступ
Оновлено: 14.02.2008
Вступ
Система програм 1С:Підприємство підтримує обмін даними з різними моделями електронних ваг з друком етикеток у режимі «offline» за узгодженою технологією (рис.1).
Рис.1
Конфігурація системи програм «1С:Підприємство 8» взаємодіє з обробками обслуговування електронних ваг з друком етикеток у режимі «offline».
Обробки обслуговування електронних ваг з друком етикеток у режимі «offline» взаємодіють із зовнішніми компонентами для електронних ваг з друком етикеток у режимі «offline» (драйверами для інтеграції з «1С:Підприємство 8»).
Зовнішній компонент (далі за текстом «драйвер») може взаємодіяти:
- безпосередньо з моделлю електронних ваг з друком етикеток у режимі «offline»;
- з програмним забезпеченням (АРМ), що постачається разом з електронними вагами з друком етикеток у режимі «offline»;
- з драйвером електронних ваг з друком етикеток у режимі «offline» низького рівня, написаним за технологією OLE for POS (OPOS).
Загальні вимоги до драйвера:
Драйвер повинен:
- бути розроблений у вигляді зовнішнього компонента (опис механізму створення зовнішніх компонентів наведено в документі «Документація з технології створення зовнішніх компонентів» на диску ІТС у розділі «Технологія створення зовнішніх компонентів» Методичної підтримки 1C:Підприємства 8.1.);
- забезпечувати можливість реалізації функціоналу в повному обсязі для підключеного виду обладнання
- надавати набір властивостей і методів для налаштування та керування драйвером відповідно до опублікованих на диску ІТС у розділі «Робота з торговельним обладнанням» Методичної підтримки 1С:Підприємства 8.1 вимог до виду представленого на сертифікацію обладнання
- надавати російськомовні та англомовні назви властивостей і методів (наприклад, Порт - Port, Швидкість - Speed, ВивантажитиТовари() - UploadGoods() та ін.);
- підтримувати множинні підключення (відповідно до ідеології COM-технології), а також підтримувати роботу з кількома пристроями, якщо це дозволяють бізнес-процеси, у яких використовується це обладнання;
- у разі виникнення помилки в роботі надавати докладний опис помилки, що сталася, який дає змогу користувачеві зрозуміти причину виникнення помилки та спосіб її усунення;
- у разі виникнення позаштатних ситуацій (некоректні дії користувача, відсутність запитуваного методу або функції, передавання некоректних значень тощо) коректно їх обробляти. Не повинно бути аварійних завершень роботи драйвера та інших некоректних дій драйвера, які можуть призвести до порушення нормальної роботи користувача.
Опис роботи з драйвером
Початок роботи з драйвером
Система 1С:Підприємство (надалі "система") ініціалізує з'єднання з драйвером і завантажує його. Далі встановлюються конфігураційні параметри, необхідні для роботи. Підключення до пристрою виконується на початку операції з пристроєм торговельного обладнання.
Завершення роботи
Відключення від пристрою виконується після завершення операції з пристроєм.
З'єднання з драйвером закривається лише після завершення роботи системи.
Опис властивостей
|
Опис властивостей | ||||
|---|---|---|---|---|
|
Назва (alias) |
Тип |
Доступність |
Опис | |
| Читання |
Запис | |||
Опис методів
|
Опис методів | |||||
|---|---|---|---|---|---|
|
Назва (alias) |
Параметри |
Повернене значення |
Опис | ||
|
Ім'я |
Тип |
Опис | |||
| ОтриматиНомерВерсії (GetVersion) | - | - | - | BSTR | Повертає номер версії драйвера |
| ОтриматиПомилку(GetLastError) | ОписПомилки (ErrorDescription) |
BSTR [OUT] | Опис помилки | LONG | Повертає код і опис останньої помилки, що сталася |
| Підключити (Open) | МасивЗначень (Valuesarray) |
IDispatch* |
Масив значень для налаштування підключення | BOOL | Підключає ЕВ-Offline |
| ІДПристрою (DeviceID) | BSTR [OUT] | Ідентифікатор пристрою | |||
| Відключити (Close) | ІДПристрою (DeviceID) | BSTR [IN] | Ідентифікатор пристрою | BOOL | Відключає ЕВ-Offline |
| ВивантажитиТовари (UploadGoods) | ІДПристрою (DeviceID) | BSTR [IN] | Ідентифікатор пристрою | BOOL | Вивантажує товари у ваги |
| ТаблицяТоварів (Goods) | IDispatch*[IN] | Таблиця товарів | |||
| ТестПристрою (DeviceTest) | МасивЗначень (Valuesarray) |
IDispatch* [IN] |
Масив значень для налаштування підключення |
BOOL |
Виконує пробне підключення та опитування пристрою. У разі успішного виконання підключення в описі повертається опис пристрою. У разі негативного результату повертається опис проблеми, що виникла під час підключення. |
| ДодатковийОпис (additionalDescription) | BSTR [OUT] |
Опис результату виконання тесту | |||
Додатковий опис::
"МасивЗначень" (приклад значень для пристрою, що підключається залежно від інтерфейсу взаємодії до послідовного порту або мережею)
Тип даних "1С:Підприємства 8" - Масив.
| Найменування параметра | Наявність у структурі | Типи даних | Опис параметра |
|---|---|---|---|
| Інтерфейс (Interface) | Необов'язково | LONG | Інтерфейс взаємодії з пристроєм (Значення: 0 - "RS-232", 1 - "Ethernet") |
| Порт (Port)/IP адреса | Необов'язково | LONG/BSTR | Номер послідовного порту (1 відповідає порту COM1)/Адреса ваг у мережі |
| Швидкість (Speed)/UDPпорт | Необов'язково | LONG/LONG | Швидкість послідовного порту, на якій підключається пристрій (передається безпосередньо значення 9600, 19200, 57600, 115200 тощо)/Порт у мережі для |
| Тайм-аут (Timeout)/UDP тайм-аут | Необов'язково | LONG/LONG | Час, протягом якого компонента повинна очікувати відповіді від пристрою під час виконання операцій |
| Пароль (Password) | Необов'язково | BSTR | Пароль для доступу до пристрою |
"ТаблицяТоварів"
Тип даних "1С:Підприємства 8" - ТаблицяЗначень.
| Найменування параметра | Наявність у структурі | Типи даних | Опис параметра |
|---|---|---|---|
| PLU | Необов'язково | LONG | PLU товару (код вагового товару) |
| НайменуванняТовару (Name) | Необов'язково | BSTR | Найменування товару |
| Ціна (Price) | Необов'язково | DOUBLE | Ціна за кілограм |
