Файлы системы DIRECTUM

 

Программа DIRECTUM RapID Waiter

 

Файл RIDWaiterSettings.xml

Файл RIDWaiterSettings.xml хранит информацию о настройках программы DIRECTUM RapID Waiter. Находится в каталоге файлов программы на тех рабочих местах, на которых была установлена программа. О каталогах файлов подробнее см. в разделе «Каталоги программы DIRECTUM RapID Waiter».

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

Файл имеет следующую структуру:

 

<?xml version="1.0" encoding="utf-8"?>

<Settings>

         <Language>{Язык интерфейса}</Language>

         <Port>{Номер порта}</Port>

         <Mode>{Параметры порта}</Mode>

            <Barcodes>

                   <Barcode>

                            <Mask ID={Номер группы с ИД}>{Регулярное выражение}<Mask>

                            <Action>{Описание действия}</Action>

                            <Params>

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

                                      ...

                            </Params>

                        <Comment>{Текстовое примечание к формату штрих-кода}</Comment>

                        </Barcode>

                   ...

         </Barcodes>

</Settings>

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

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

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

·         b - скорость порта, по умолчанию 9600;

·         p – паритет. Возможные значения: N - no parity, S - space parity, O - odd parity, E - even parity, M - mark parity, поумолчанию S;

·         d - количество битов данных, по умолчанию 7;

·         s - количество стоповых битов, по умолчанию 1.

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

Номер группы с ИД. Порядковый номер группы, которая определяет ИД документа.

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

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

 

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

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

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

 

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

Имя сценария. Имя сценария системы DIRECTUM. Сценарий запускается из той системы, на работу с которой настроена программа DIRECTUM RapID Waiter (см. в главе «Администрирование системы DIRECTUM», раздел «Описание программы 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) может быть такой:

 

"C:\Program Files\DIRECTUM Company\DIRECTUM\SBLauncher.exe"

-SYS=%SYS% -CT=Script -F=ProcessScanningResult -R="ID=%ID%|Msg=%TextMsg%"

где

·         %SYS%, %ID% - значения предопределенных параметров действия;

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

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

 

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

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

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

 

<Action Type=atComand>"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>

         </Params>

</Action>

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

Узел Params имеет следующую структуру:

 

<Params>

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

                   ...

</Params>

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

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

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

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

<SysCode>\1</SysCode>

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

·         ID – ИД документа, указанный в штрих-коде;

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

 

 

 

См. также:

·         Общие сведения о файлах программы DIRECTUM RapID Waiter;

·         Каталоги программы DIRECTUM RapID Waiter;

·         Файл RIDWaiter.exe.