Skip to Content

Запрос SOAP

alt

Важно! Элемент доступен только при установке пакета Primo.Networking, который скачивается с помощью Менеджера зависимостей Студии либо на сайте NuGet.org.

Элемент осуществляет базовые виды запросов к сервисам SOAP. Работает только на ОС Windows.

Окно мастера (wizard)

На панели элемента отображается кнопка с вызовом окна мастера. Мастер - это простой способ создания запросов SOAP и предварительного просмотра ответов сервера. Все поля, присутствующие в мастере, также доступны на панели Свойства. Таким образом, настроить запрос возможно либо в мастере, либо в свойствах элемента.

Обращаем внимание, что при закрытии окна мастера изменить настройки можно только в свойствах.

alt

Настройки запроса:

  • Описание сервиса - укажите 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При использовании зашифрованного пароля укажите его в этом поле в виде переменной SecureString. Такой пароль не хранится в открытом виде в памяти компьютера. Получить его можно, например, из Диспетчера учетных данных (Credential Manager)
СертификатПараметры для типа аутентификации Client Certificate
СертификатStringУкажите путь к файлу сертификата либо Subject в хранилище Root
Пароль сертификатаStringУкажите пароль сертификата
Защищенный парольSecureStringПри использовании зашифрованного пароля сертификата укажите его в этом поле в виде переменной SecureString
SOAP
Endpoint*StringУкажите расположение схемы WSDL. Пример: "http://www.webservicex.com/globalweather.asmx?wsdl"
Contract*StringКонтракт сервиса
Метод*StringИмя метода
ПараметрыList<Object>Массив параметров метода. Важно! В типах данных классы не поддерживаются, только простые типы
Тайм-аут:Int32Тайм-аут запроса в миллисекундах. Укажите максимальное время ожидания ответа от сервера в мс, по истечении которого при отсутствии отклика обращение будет прервано со статусом ошибки. По умолчанию 20000
Вывод
ЗаголовкиDictionary<string, string>Заголовки ответа, полученного на запрос SOAP
ОтветStringОтвет сервиса