Описание действий СЭД Detrix: WS-клиент

Расширение возможностей системы электронного документооборота Detrix и ее интеграция с другими информационными системами возможны посредство механизма веб-сервисов.  Действие WS-клиент (WS — Web Service) как раз и предназначено для организации вызовов внешних веб-сервисов из СЭД Detrix. Действие поддерживает протоколы SOAP 1.1 и WSDL. Таким образом, существует возможность разработки недостающего функционала в виде отдельного приложения. Достаточно лишь опубликовать его в качестве веб-сервиса и вызвать из СЭД посредством действия WS-клиент.

Действие 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-клиент при выполнении его пользователем (в нашем случае можно написать Первое слагаемое и Второе слагаемое), а переключатели Показать определяют необходимость показа полей ввода в окне действия соответствующих параметров (если, к примеру, нам нужно показать только Первое слагаемое, включаем возле него переключатель, а  Второе слагаемое оставляем как есть).
    • Результат записать в поле. Если сервис возвращает какой-либо результат, а в рассматриваемом в нашем случае он возвращает сумму двух чисел, его можно записать в какое-либо поле данного типа документа.
    • Переместить на. При установленном атрибуте после выполнения действия документ перемещается на соответствующее количество точек.

Комментарии

  1. OlegNV:

    При попытке указать адрес WS-клиент система пишет, что в данный момент веб-сервис не доступен. Подскажите куда рулить?

  2. OlegNV:

    Всё-таки, можете подсказать какие настройки и где посмотреть? Всё остальное работает. Версия 1.2.1

  3. Геннадий:

    Добрый день
    У меня метод возвращает некую структуру из 1С. А тут как я понял, принимается только некий простой тип данных? Или я ошибаюсь и можно как то принять структуру и разнести ее по разным полям?

    • То, что принимается, пишется в поле системы. Соответственно, приниматься могут только данные, который соответствуют форматам полей Detrix.

      • Геннадий:

        Добрый день.
        То есть в случае с Detrix мне необходимо переписать методы в 1С-ке. Проще говоря, если у меня в структуре три примитивных типа которые понимает Detrix, то мне необходимо написать три разных метода которые будут возвращать примитивные данные и записывать их в соответствующие поля?
        Спасибо.

Задать вопрос

Copyright © 2011-2013 Андрей Суров При копировании материалов сайта гиперссылка Detrix.kz обязательна