Зовнішня компонента "1С:Сканер штрихкоду"
Для роботи 1С:Підприємства зі сканерами штрихкодів застосовується зовнішня компонента системи 1С:Підприємство <strong>"1С:Сканер штрихкоду", версія 8.0.8</strong>. Вона приймає від сканера прочитаний ним штрихкод і передає його для обробки в 1С:Підприємство. Компонента також може використовуватися для роботи з іншими пристроями, спосіб передавання даних якими аналогічний способу передавання даних сканером штрихкодів.
- Загальні відомості
- Властивості
- Методи
- Приклад роботи з компонентою
- Установлення драйвера
Загальні відомості
Для роботи 1С:Підприємства зі сканерами штрихкодів застосовується зовнішня компонента системи 1С:Підприємство "1С:Сканер штрихкоду", версія 8.0.8. Вона приймає від сканера прочитаний ним штрихкод і передає його для обробки в 1С:Підприємство. Компонента також може використовуватися для роботи з іншими пристроями, спосіб передавання даних якими аналогічний способу передавання даних сканером штрихкодів.
Властивості
| Назва (аліас) | Тип | R | W | Опис |
|---|---|---|---|---|
| АвтоВыключение (autoDisable) | Число | + | + | Якщо властивість має значення 1, то після кожного надсилання даних пристрій автоматично вимикатиметься. |
| ДвоичноеПреобразование (BinaryConversion) | Число | + | + | Загальна властивість OPOS. Вона задає спосіб перетворення двійкових даних під час передавання їх за допомогою рядка. |
| ЕстьУведомлОПитании (CapPowerReporting) | Число | + | - | Загальна властивість OPOS. Властивість містить значення, що вказує на можливість пристрою повідомляти про стан живлення. |
| РезультатПроверки (CheckHealthText) | Строка | + | - | Загальна властивість OPOS. Містить рядок, що описує результат перевірки стану пристрою. |
| УстройствоЗанято (Claimed) | Число | + | - | Властивість містить ознаку монопольного використання пристрою. |
| ОписаниеКонтролОбъекта (ControlObjectDescription) | Строка | + | - | Властивість містить опис контроль-об’єкта (об’єкт верхнього рівня в архітектурі OPOS). |
| ВерсияКонтролОбъекта (ControlObjectVersion) | Число | + | - | Властивість містить версію OPOS, що підтримується контроль-об’єктом |
| ЧислоДанныхВОчереди (DataCount) | Число | + | - | Властивість містить кількість повідомлень, отриманих від пристрою, які очікують у черзі. |
| ПосылкаДанных (DataEventEnabled) | Число | + | + | Якщо властивість має значення 1, то повідомлення про надходження повідомлення надсилається негайно. Інакше – дані ставляться в чергу. |
| ДекодироватьДанные (DecodeData) | Число | + | + | Якщо властивість має значення 1, то під час отримання даних від пристрою дані декодуватимуться і будуть встановлюватися значення властивостей ШтрихКод і ТипШтрихКода. |
| ОписаниеУстройства (DeviceDescription) | Строка | + | + | Властивість містить текстовий опис пристрою, який може бути змінений користувачем. |
| УстройствоВключено (DeviceEnabled) | Число | + | + | Якщо властивість має значення 1, то здійснюється обробка повідомлень, що отримуються від пристрою. |
| ИмяУстройства (DeviceName) | Строка | + | - | Властивість містить рядок, що ідентифікує пристрій. Цей рядок встановлюється в момент відкриття пристрою. |
| ЗапрещениеСобытий (FreezeEvents) | Число | + | + | Якщо властивість має значення 1, то доставка повідомлень від пристрою тимчасово призупиняється. |
| ТекущийАсинхВывод (OutputID) | Число | + | - | Загальна властивість OPOS. Містить ідентифікатор останньої асинхронної операції виведення. |
| УведомлениеОСбоеПитания (PowerNotify) | Число | + | + | Загальна властивість OPOS. Містить значення, яке вказує, про які події у разі збоїв живлення слід надсилати повідомлення. |
| Питание (PowerState) | Число | + | - | Властивість містить поточний стан живлення пристрою. |
| Результат (ResultCode) | Число | + | - | Властивість містить код результату останньої операції. |
| ДопРезультат (ResultCodeExtended) | Число | + | - | Властивість містить розширений код результату останньої операції. |
| СканированныеДанные (ScanData) | Строка | + | - | Властивість містить рядок, отриманий від пристрою. |
| ШтрихКод (ScanDataLabel) | Строка | + | - | Властивість містить рядок, що відповідає прочитаному штрихкоду. |
| ТипШтрихКода (ScanDataType) | Число | + | - | Властивість сканера OPOS. Містить код типу прочитаного штрихкоду. |
| ОписаниеСервисОбъекта (ServiceObjectDescription) | Строка | + | - | Властивість містить опис сервіс-об’єкта (об’єкт нижнього рівня архітектури OPOS). |
| ВерсияСервисОбъекта (ServiceObjectVersion) | Число | + | - | Властивість містить версію OPOS, що підтримується сервіс-об’єктом. |
| Состояние (State) | Число | + | - | Властивість містить код поточного стану пристрою. |
| БитДанных (DataBits) | Число | + | + | Один із параметрів налаштування послідовного порту (біт даних у байті). |
| Порт (Port) | Число | + | + | Один із параметрів налаштування послідовного порту (номер COM-порту). |
| Скорость (Speed) | Число | + | + | Один із параметрів налаштування послідовного порту (швидкість передавання даних). |
| СтопБит (StopBits) | Число | + | + | Один із параметрів налаштування послідовного порту (кількість стоп-бітів). |
| СтопСимвол (StopChar) | Число | + | + | Один із параметрів налаштування послідовного порту (стоп-символ). |
| ИмяСобытия (EventName) | Строка | + | + | Ім’я події, що передається на обробку в 1С:Підприємство. |
ВАЖЛИВО!
Налаштування драйвера мають збігатися з налаштуваннями сканера
Налаштування драйвера мають збігатися з налаштуваннями сканера
ПРИМІТКА
Допустимі значення властивостей АвтоВыключение, УстройствоЗанято, ПосылкаДанных, ДекодироватьДанные, УстройствоВключено, ЗапрещениеСобытий:
0 (відповідає "Ні"), 1 (відповідає "Так");
Властивості ДвоичноеПреобразование, ЕстьУведомлОПитании, УведомлениеОСбоеПитания, Питание, Результат, ДопРезультат, ТипШтрихКода, Состояние можуть набувати значень, описаних у стандарті OPOS;
Властивість БитДанных набуває значень від 1 до 8;
Властивість СтопБит набуває значень від 0 до 2
Допустимі значення властивостей АвтоВыключение, УстройствоЗанято, ПосылкаДанных, ДекодироватьДанные, УстройствоВключено, ЗапрещениеСобытий:
0 (відповідає "Ні"), 1 (відповідає "Так");
Властивості ДвоичноеПреобразование, ЕстьУведомлОПитании, УведомлениеОСбоеПитания, Питание, Результат, ДопРезультат, ТипШтрихКода, Состояние можуть набувати значень, описаних у стандарті OPOS;
Властивість БитДанных набуває значень від 1 до 8;
Властивість СтопБит набуває значень від 0 до 2
Методи
| Назва (аліас) | Параметри | Повернене значення | Опис |
|---|---|---|---|
| Проверить (CheckHealth) | ТипПроверки (Число, ідентифікатор типу перевірки) | Результат у форматі OPOS | Метод виконує перевірку пристрою вибраного типу. |
| Занять (Claim) | Таймаут (Число, максимальний час очікування) | Результат у форматі OPOS | Метод здійснює спробу отримання монопольного доступу до пристрою |
| ОчиститьВход (ClearInput) | - | Результат у форматі OPOS | Метод очищає буфер повідомлень. |
| ОчиститьВыход (ClearOutput) | - | Результат у форматі OPOS | Загальний метод OPOS. Очищає чергу виведення. |
| Отсоединить (Close) | - | Результат у форматі OPOS | Метод завершує роботу з пристроєм. |
| Управление (DirectIO) | Команда (Число, код команди), ЧислПарам (Число, числовий параметр), СтрокПарам (Строка, рядковий параметр) | Результат у форматі OPOS | Загальний метод OPOS. Використовується для взаємодії із сервіс-об’єктом безпосередньо. |
| Открыть (Open) | ИмяУстройства (Строка, що відповідає імені пристрою) | Результат у форматі OPOS | Відкрити пристрій. |
| Освободить (Release) | - | Результат у форматі OPOS | Метод звільняє пристрій (метод виконує дії, протилежні "Занять") |
|
ТестУстройства (DeviceTest) |
- | - |
Відкриває модальну форму перевірки підключення та налаштування обладнання. |
|
ПараметрыЖурналирования (LogParams) |
- | - |
Метод дає змогу відкрити модальне вікно для налаштування параметрів журналювання (запис у файл операцій драйвера). |
|
ПолучитьНомерВерсии (GetVersion) |
- | Рядок у форматі 8.0.Х.Х |
Метод дає змогу отримати поточний номер версії драйвера. |
Приклад роботи з компонентою
Приклад обробки, що здійснює роботу зі сканером штрихкоду, наведено у статті "Вимоги до розробки зовнішніх обробок обслуговування торговельного обладнання".
