Расширение возможностей системы электронного документооборота Detrix и ее интеграция с другими информационными системами возможны посредство механизма веб-сервисов. Действие WS-клиент (WS — Web Service) как раз и предназначено для организации вызовов внешних веб-сервисов из СЭД Detrix. Действие поддерживает протоколы SOAP 1.1 и WSDL. Таким образом, существует возможность разработки недостающего функционала в виде отдельного приложения. Достаточно лишь опубликовать его в качестве веб-сервиса и вызвать из СЭД посредством действия WS-клиент.
Действие WS-клиент содержит следующий набор параметров:
- Показать окно действия. Можно предоставить пользователю возможность изменения параметров, передаваемых вызываемому сервису. Если таковая возможность есть — показываем окно действия.
- Адрес web-сервиса. Здесь вводится http-адрес сервиса. В качестве демонстрационного примера в системе есть сервис, к которому можно обратиться по адресу http://domain_name/wsSample.php?wsdl. Этот сервис может выполнять простейшие арифметические операции над двумя операндами.
- Аутентификация. При необходимости аутентификации для обращения к сервису аутентификационные данные указываются в этой секции. Для обращения к упомянутом ранее демонстрационному сервису, по умолчанию, такие данные требуются. Они доступны в расположенном в корневом каталоге системы файле settings.xml в элементах:
<item name="ws_login" value="Admin"/>
<item name="ws_password" value="пароль"/> - Метод. В списке этого параметра находятся методы, предоставляемые сервисом. Наш тестовый сервис предлагает методы сложения, вычитания, умножения и деления. На рисунке выбран метод, который позволяет сложить два операнда.
- Параметры. Если web-сервису для работы требуются параметры, они передаются через данный атрибут. Нашему сервису нужно передать два слагаемых. Названия параметров со стороны сервиса приводятся в секции Переменная (Slagaemoe1 и Slagaemoe2). В секции Поле выбираются поля, значения которых будут переданы в качестве параметров сервису (т.е. в качестве слагаемых в нашем случае). Например, если в типе документа были добавлены два вещественных поля под названиями В1 и В2, то можно их использовать в качестве слагаемых для нашего тестового сервиса. Псевдоним предназначен для указания названия параметра в окне действия WS-клиент при выполнении его пользователем (в нашем случае можно написать Первое слагаемое и Второе слагаемое), а переключатели Показать определяют необходимость показа полей ввода в окне действия соответствующих параметров (если, к примеру, нам нужно показать только Первое слагаемое, включаем возле него переключатель, а Второе слагаемое оставляем как есть).
- Результат записать в поле. Если сервис возвращает какой-либо результат, а в рассматриваемом в нашем случае он возвращает сумму двух чисел, его можно записать в какое-либо поле данного типа документа.
- Переместить на. При установленном атрибуте после выполнения действия документ перемещается на соответствующее количество точек.