Более подробно о API и объектах (все поля, процедуры и функции) можно прочитать в статье «Справочник разработчика».
Начало работы с компонентой
/// <example>
/// Пример использования библиотеки из Visual Basic 6:
/// <code lang="VBScript">
/// Dim api As Object
///
/// Dim readers As Object
/// Dim reader As Object
/// Dim caps As Object
/// Dim tags As Object
/// Dim epc As Object
///
/// Set api = CreateObject("Cleverence.RFID.Api")
/// ' Enshure that all connections to any reader in this Workbook are disposed prior to the next reding.
/// ' Освободить все возможные старые подключения к считывателям в рамках текущего Workbook, чтобы разрешить новые подключения.
/// Call api.DisconnectAllReaders
///
/// ' Lookup for available RFID-reader in local network.
/// ' Поискать RFID-считывател в локальной сети.
/// Set readers = api.LookupReaders()
/// If readers.count = 0 Then
/// MsgBox ("RFID-считывателей не найдено!")
/// Return
/// End If
///
/// ' Подключиться к считывателю.
/// Set reader = api.ConnectToReader(readers.Item(0).URL)
/// ' Получить подробную информацию об оснащении ридера.
/// Set caps = reader.GetCapabilities()
///
/// ' Искать RFID-метки в течение 3 секунд, допуская повторные чтения.
/// Set tags = reader.LookupTags(3000, 0)
/// For i = 0 To tags.count - 1
/// ' Прочитать содержимое банка EPC метки с таким-то значением Tag ID.
/// Set epc = tags.Item(i).EPC
/// MsgBox (epc.ToString())
/// Next
///
/// ' Отключиться от ридера и освободить все ресурсы.
/// Call reader.Dispose
/// Call api.DisconnectAllReaders
/// </code>
Для начала работы с компонентой следует создать один её экземпляр на каждом клиенте (который будет работать с RFID-считывателями со своей локальной машины):
Завершение работы с компонентой
Процедура правильного завершения работы с компонентой (при закрытии окна 1С или остановке сервера) должна выглядеть следующим образом:
Обработка ошибок при работе с компонентой
Если в работе компоненты возникают ошибки (исключительные ситуации), то «1С:Предприятие» в основном интерпретирует их как «Неизвестная ошибка». Чтобы получить более подробную информацию по ошибке, следует использовать метод «ОписаниеОшибки()» компоненты:
Кроме того все ошибки, возникающие при работе самой компоненты (т.е. те, которые возникли после успешного выполнения функции «ПодключитьВнешнююКомпоненту»), пишутся в лог-файл «CleverenceRFID_log.txt», который лежит в папке «Мои документы» того пользователя, под которым сейчас запущено «1С:Предприятие». Некоторые редкие ошибки выполнения функции «ПодключитьВнешнююКомпоненту» тоже пишутся в этот лог.
Распространенные ошибки и их устранение
В работе компоненты выявлены ошибки, которые появляются либо на некоторых конфигурациях машин, либо время от времени на любых конфигурациях.
При любой непонятной ошибке будет полезно посмотреть файл CleverenceRFID_log.txt, который находится в папке «Мои документы» того пользователя, под которым сейчас запущено «1С:Предприятие»!
Метод «ОбработкаВнешнегоСобытия» в 1С не вызывается.
Обратитесь к статьям «Установка и настройка «Wonderfid™ Link» и «Установка и настройка RFID считывателей»» и файлу CleverenceRFID_log.txt.
Чтение меток асинхронно (асинхронная инвентаризация) ничего не читает.
Возникает на домашних версиях операционной системы Windows, а также при неправильной настройке политики доступа (прав доступа) продукта в «1С:Предприятие».
«Приложение будет закрыто» и обрушение окна «1С:Предприятия»
Возникает при повторных созданиях и уничтожениях продукта, например, при повторных открытиях копий демонстрационной обработки в одном и том же окне «1С:Предприятия». Совет: создавайте не более одного экземпляра обработки на каждого запущенного клиента 1С.
