Запрос SOAP
Last updated
Last updated
Важно! Элемент доступен только при установке пакета Primo.Networking, который скачивается с помощью либо на сайте .
Элемент осуществляет базовые виды запросов к сервисам SOAP. Работает только на ОС Windows.
На панели элемента отображается кнопка с вызовом окна мастера. Мастер - это простой способ создания запросов SOAP и предварительного просмотра ответов сервера. Все поля, присутствующие в мастере, также доступны на панели Свойства. Таким образом, настроить запрос возможно либо в мастере, либо в свойствах элемента.
Обращаем внимание, что при закрытии окна мастера изменить настройки можно только в свойствах.
Настройки запроса:
Описание сервиса - укажите URL схемы WSDL с описанием сервиса. Или нажмите кнопку ...
, если файл *.wsdl нужно найти на жестком диске.
Получить — по нажатию кнопки будет извлечена информация из файла *.wsdl и отобразятся доступные параметры в таблице.
Контракт - имя контракта, который описывает методы, предоставляемые службой SOAP. Заполняется из файла *.wsdl.
Метод - список всех поддерживаемых методов. Становится доступным после указания файла *.wsdl. При изменении метода также изменятся параметры, отображаемые в таблице ниже.
Аутентификация - тип аутентификации сервиса SOAP. Доступные значения:
None - по умолчанию аутентификация не требуется;
Simple - SOAP-сервис требует простой аутентификация по логину и паролю. При выборе этого значения появятся поля Логин, Пароль;
Windows - Windows-аутентификация;
Client Certificate - аутентификация осуществляется по сертификату клиента. При выборе этого значения появятся поля Сертификат (путь до файла сертификата, без кавычек) и Пароль (сертификата).
Таблица параметров метода:
Наименование - имена поддерживаемых параметров. Заполняется из файла *.wsdl.
Тип - тип данных параметра. Поддерживаются только простые типы данных, без классов.
Значение - позволяет добавить значение для каждого параметра, чтобы выполнить нужный запрос. Заполнение доступно по двойному клику строки.
Выполнить (кнопка) - выполняет запрос с указанными параметрами.
После нажатия кнопки Выполнить можно просмотреть ответ веб-сервера в соответствующей области.
Все свойства элемента разделены на группы - они выделены в таблице жирным курсивом.
Символ *
в названии свойства указывает на обязательность заполнения.
Свойство | Тип | Описание |
---|
Общие |
Аутентификация |
Аутентификация | - | Выберите из раскрывающегося списка тип аутентификации. Доступные значения: 1) None - по умолчанию аутентификация не требуется; 2) Simple - простая аутентификация по логину и паролю; 3) Windows - используются учетные данные Windows; 4) Client Certificate - сертификат клиента |
Simple | Параметры для типа аутентификации Simple |
Логин | String | Логин |
Пароль | String | Пароль |
Защищенный пароль | При использовании зашифрованного пароля укажите его в этом поле в виде переменной SecureString. Такой пароль не хранится в открытом виде в памяти компьютера. Получить его можно, например, из Диспетчера учетных данных (Credential Manager) |
Сертификат | Параметры для типа аутентификации Client Certificate |
Сертификат | String | Укажите путь к файлу сертификата либо Subject в хранилище Root |
Пароль сертификата | String | Укажите пароль сертификата |
Защищенный пароль | При использовании зашифрованного пароля сертификата укажите его в этом поле в виде переменной SecureString |
SOAP |
Endpoint* | String | Укажите расположение схемы WSDL. Пример: |
Contract* | String | Контракт сервиса |
Метод* | String | Имя метода |
Параметры | List<Object> | Массив параметров метода. Важно! В типах данных классы не поддерживаются, только простые типы |
Тайм-аут: | Int32 | Тайм-аут запроса в миллисекундах. Укажите максимальное время ожидания ответа от сервера в мс, по истечении которого при отсутствии отклика обращение будет прервано со статусом ошибки. По умолчанию 20000 |
Вывод |
Заголовки | Заголовки ответа, полученного на запрос SOAP |
Ответ | String | Ответ сервиса |
Описание общих свойств см. в разделе
<string, string>