<< Щелкните, чтобы показать Содержание >> Администратору > Файлы системы DIRECTUM > Программа DIRECTUM RapID Waiter

Файл RIDWaiterSettings.xml

Contents

Файл хранит информацию о настройках программы DIRECTUM RapID Waiter. Файл находится в папке с программой, путь к ней указывается во время установки.

Пример файла RIDWaiterSettings.xml см. в разделе «Пример файла RIDWaiterSettings.xml».

Структура файла RIDWaiterSettings.xml:

<?xml version="1.0" encoding="utf-8"?>
<Settings>
<Language>{Язык интерфейса}</Language>
<Port>{Номер порта}</Port>
<Mode>{Параметры порта}</Mode>
<Barcodes>
<DIRECTUMBarcode>
<Action>{Описание действия}</Action>
<Params>
<{Имя параметра}>{Значение параметра}
</{Имя параметра}>
...
</Params>
<Comment>{Текстовое примечание к
формату штрихкода} </Comment>
</DIRECTUMBarcode>
<CustomBarcode>
<Mask>{Регулярное выражение}</Mask>
<Action>{Описание действия}</Action>
<Params>
<{Имя параметра}>{Значение параметра}
</{Имя параметра}>
...
</Params>
<Comment>{Текстовое примечание к
формату штрихкода} </Comment>
</CustomBarcode>
...
</Barcodes>

<EnableLogs>{Включить логирование}</EnableLogs>
<LogsDirPath>{Путь до папки с лог-файлами}</LogsDirPath>
</Settings>

Язык интерфейса. Язык, на котором будут отображаться текстовые элементы интерфейса программы DIRECTUM RapID Waiter, например, заголовки и сообщения. Возможные значения:

•	RU – текстовые элементы интерфейса отображаются на русском языке;

•	EN – элементы отображаются на английском языке.

Если значение параметра Язык интерфейса не указано, то элементы будут отображаться на языке, установленном в операционной системе для конкретного пользователя.

Номер порта. Номер виртуального порта, на работу с которым настроен сканер штрихкодов. Указывается, если сканер работает в режиме эмуляции COM-порта. Подробнее см. раздел «Режимы работы сканеров штрихкодов».

Параметры порта. Настройки работы с com-портом, указанным в параметре Номер порта. Задаются в формате: [baud=b][parity=p][data=d][stop=s], где:

•	b – скорость порта Значение по умолчанию 9600;

•	p – режим контрольного бита, паритет (Parity Control Bit). Возможные значения:

•	N – no parity. Проверка на паритет не используется;

•	S – space parity. Бит паритета всегда равен 0;

•	O – odd parity. Проверка на нечетность;

•	E – even parity. Проверка на четность;

•	M – mark parity. Бит паритета всегда равен 1.

Значение по умолчанию S;

•	d – количество битов данных. Значение по умолчанию 7;

•	s – количество стоповых битов. Значение по умолчанию 1.

Если параметры не указаны, то используются значения параметров порта по умолчанию.

Настройки форматов штрихкода

В узле Barcodes хранятся настройки всех форматов штрихкода.

Примечание

Чтобы изменить настройки формата штрихкода, необходимо в узел Barcodes добавить новый узел CustomBarcode с нужными настройками формата или изменить существующий.

В узле DIRECTUMBarcode хранится настройка формата штрихкода для системы DIRECTUM. Маску для этого узла задавать не нужно, она определяется автоматически.

Регулярное выражение. Формализованный шаблон штрихкода, задаваемый в регулярном выражении. Например, для системы DIRECTUM регулярное выражение будет иметь вид:

^DIRECTUM-([0-9]+)-([0-9]+)$

Описание действия

Структура узла Action, в котором хранится описание действия, зависит от того, какое именно действие выполняется после сканирования штрихкода.

Если после сканирования штрихкода выполняется сценарий системы DIRECTUM, то узел Action имеет структуру:

<Action Type="Script">{Имя сценария}[{Параметры сценария}]</Action>

Имя сценария. Имя сценария системы DIRECTUM. Сценарий запускается из той системы, на работу с которой настроена программа DIRECTUM RapID Waiter. Подробнее см. раздел «Описание программы DIRECTUM RapID Waiter». Если имя сценария содержит пробелы, то значение следует заключать в кавычки.

Параметры сценария. Параметры выполнения сценария. Указываются в том случае, если сценарий имеет параметры выполнения. Параметры указываются в формате: <Имя параметра сценария>=<Значение параметра сценария>. Если параметров несколько, то они отделяются друг от друга пробелом. При задании параметров сценария допускается использовать параметры действия. Описание см. ниже.

Например, сценарий Обработка результатов сканирования (ProcessScanningResult) имеет два параметра выполнения: ID и Msg. В параметре ID должен быть указан ИД системы DIRECTUM. В параметре Msg текст сообщения о неудачной попытке подключения к системе DIRECTUM. В этом случае узел Action может выглядеть так:

<Action Type="Script">ProcessScanningResult ID=%ID% Msg=%TextMsg%</Action>

где %ID%, %TextMsg% – значение параметра действия, описанного в узле Params.

Если после сканирования штрихкода выполняется какое-либо другое действие, не сценарий системы DIRECTUM, то узел Action имеет структуру:

<Action>{Командная строка}</Action>

или равнозначный вариант:

<Action Type="">{Командная строка}</Action>

Командная строка. Командная строка, которая будет выполняться после сканирования штрихкода. В командной строке допускается использовать параметры действия. Описание см. ниже.

Например, командная строка для запуска сценария Обработка результатов сканирования (ProcessScanningResult) может быть такой:

<Action>"C:\Program Files\DIRECTUM Company\DIRECTUM\SBLauncher.exe"
-SYS=%SYS% -CT=Script -F=ProcessScanningResult -R="ID=%ID%|Msg=%TextMsg%" </Action>

где

•	%SYS% – значение предопределенного параметра;

•	%ID%, %TextMsg% – значение параметра действия, описанного в узле Params.

Если значение параметра Командная строка не задано, то после сканирования штрихкода тот документ, ИД которого указан в штрихкоде, будет открываться в специальном приложении для просмотра документов. Если документ с таким ИД не найден в системе, или у пользователя нет на него прав, то будет выдано сообщение «Штрихкод документа не соответствует ни одному из зарегистрированных форматов».

Имя и значение параметра

В узле Params задаются параметры действия, которые могут использоваться в описании действия. Выделение параметров позволяет упростить описание действия.

Например, в конфигурационном файле можно указать параметры сценария для командной строки:

<Action>"C:\Program Files\DIRECTUM Company\
DIRECTUM\SBLauncher.exe" -SYS=%SYS% -CT=Script -F=ProcessScanningResult
-R="ID=%ID%|Msg=Start"
</Action>

С использованием узла Params описанный выше пример можно преобразовать к виду:

<Action Type="Script">ProcessScanningResult Msg=%TextMsg%
<Params>
<TextMsg>Start
</TextMsg>
<SYS>\1</SYS>
<ID>\2</ID>
</Params>
</Action>

В описании действия параметры действия указываются в виде %<Имя параметра>%, например, %ID%.

Структура узла Params:

<Params>
<{Имя параметра}>{Значение параметра}</{Имя параметра}>
...
</Params>

Значение параметра. Значение параметра, которое подставляется в Параметры сценария или в Командную строку при обработке результатов сканирования. Значение параметра можно задать двумя способами:

•	простым значением, например:

<TextMsg>”Вход в систему выполнен”</TextMsg>

•	номером группы регулярного выражения, например:

Помимо параметров действия, описанных в узле Params, в Описание действия допускается использовать предопределенные параметры действия:

•	SYS, S, D – соответственно код, имя SQL-сервера и имя БД системы DIRECTUM, на работу с которой настроена программа DIRECTUM RapID. Подробнее см. раздел «Запуск программы DIRECTUM RapID Waiter».

Включить логирование. Если указано значение True, в процессе работы DIRECTUM RapID Waiter логируются действия: загрузка файла настроек, открытие и закрытие COM-порта, чтение данных из порта, обработка штрихкода, запуск сценариев. Путь до папки, в которую сохраняются лог-файлы, указывается в секции LogsDirPath.

Путь до папки с лог-файлами. Путь до локальной или сетевой папки, в которой будут храниться лог-файлы DIRECTUM RapID Waiter. Если путь не указан или указан неверно, лог-файлы не записываются.

Сообщество пользователей DIRECTUM