Ознакомиться с документацией Automation Anywhere

Automation Anywhere Automation 360

Закрыть содержимое

Содержимое

Открыть содержимое

Пример использования действия веб-службы SOAP

  • Обновлено: 2022/03/10
    • Automation 360 v.x
    • Сборка
    • Рабочая область RPA
    • Примеры

Пример использования действия веб-службы SOAP

Используйте action Веб-служба SOAP для передачи двух числовых значений и возврата суммы из веб-приложения «калькулятор».

Процедура

Чтобы вызвать веб-службу SOAP, выполните указанные ниже действия.

  1. Дважды щелкните или перетащите действие Веб-службы SOAP.
  2. Выберите метод подключения:
    • Чтобы подключиться с помощью URI, введите URI, например http://www.dneonline.com/calculator.asmx?WSDL.
    • Чтобы подключиться с помощью файла, выберите файл в Control Room или на рабочем столе или вставьте переменную.
  3. Необязательно: Укажите конечную точку SOAP в поле Расположение адреса.
    Если указать расположение адреса, то bot использует его во время выполнения; в противном случае bot использует местоположение адреса из WSDL-файла.
    Прим.: Если URI SOAP создается вручную, без использования команды Создать запрос SOAP, перейдите к шагу 6.
  4. Щелкните Создать запрос SOAP.
    Появляется окно Запрос SOAP, в котором отображаются службы и порты с подробной информацией об их операциях и параметрах.
  5. В окне Запрос SOAP разверните запись службы, для которой требуется просмотреть список портов. Чтобы отобразить список доступных операций, щелкните нужный порт. Чтобы получить сведения об операции из запроса SOAP, выберите необходимую операцию и щелкните Применить.
    Если используется команда Создать запрос SOAP, поля Службы, Порт, Операция и Параметры операции автоматически заполняются сведениями в зависимости от выбранной операции. Перейдите к шагу 10.
  6. В поле Служба введите имя службы.
    Это поле определяет набор портов, поддерживаемых веб-службой. В нем содержится значение @имени службы для вызова веб-службы SOAP, например, Calculator.
  7. Необязательно: В поле Порт укажите конечную точку для подключения.
    Если не указать порт, bot будет использовать первый порт, указанный в WSDL-файле, в зависимости от выбранной службы. Однако, если этот порт не поддерживается веб-службой SOAP, выполнение bot завершится ошибкой.
    В этом поле хранится значение @имени привязки для вызова веб-службы SOAP, например, CalculatorSoap.
  8. Выберите версию SOAP конечной точки, которую вы указали в поле Порт.
    Выберите 1.1 или 1.2.
  9. В поле Операция введите имя сервисной функции для конечной точки, которую вы указали в поле Порт.
    Выполнение bot завершается ошибкой, если верно одно из указанных ниже условий.
    • Для порта, указанного в поле «Порт», нет никаких операций.
    • Операция, указанная в запросе SOAP для данного порта, недоступна.
    В этом поле хранится значение @названия операции для вызова веб-службы SOAP, например, Add.
  10. Выберите Параметры операции или Параметры с необработанными данными для получения подробной информации о параметрах.
    Прим.: Если выбрана команда Создать запрос SOAP, таблица сведений о параметрах на вкладке Операция автоматически заполняется параметрами выбранной операции. Укажите значения этих параметров. Также можно добавлять, редактировать или удалять параметры для конкретной операции.
    • При выборе варианта Параметры операции введите название и значение каждого параметра. Например, введите указанные ниже значения.
      1. intA в первом поле Имя
      2. 10 в первом поле Значение
      3. intB во втором поле Имя
      4. 20 во втором поле Значение
    • При выборе варианта Параметры с необработанными данными выберите Параметры или Параметры учетных данных.
  11. Параметры: Можно использовать значения учетных данных из ячейки «Компонент учетных данных», не раскрывая учетные данные (имя пользователя или пароль) в виде обычного текста в необработанных данных. Для этого сначала необходимо сопоставить учетные данные в модуле сопоставления учетных данных и использовать имя ссылки в необработанных данных, заключенное в фигурные скобки.

    Например, в необработанных данных вы предоставили пароль в виде обычного текста для аутентификации на сервере.

    <aut:AuthHeader>
    <aut:Password> abc@123</aut:Password>
    </aut:AuthHeader>
    
    Чтобы использовать пароль из ячейки учетных данных, выполните указанные ниже действия.
    1. Щелкните Добавить подстановку.
      В поле Имя в XML введите имя ссылки, например pwd. Выберите Компонент учетных данных, чтобы использовать значение, доступное в хранилище учетных данных, Переменная, чтобы использовать переменную учетных данных, или Небезопасная строка, чтобы вручную указать значение, которое требуется использовать.
      Подробнее о хранилищах учетных данных и о том, как их использовать, см. в разделе Учетные данные и lockers в Credential Vault.
    2. Щелкните Добавить
    3. Укажите ссылку в необработанных данных в фигурных скобках, как показано ниже.
      <aut:AuthHeader>
      <aut:Password>{{pwd}}</aut:Password>
      </aut:AuthHeader>
      
      Имя ссылки pwd, указанное в необработанных данных, заменит соответствующее значение, содержащееся в хранилище учетных данных.
      Убедитесь, что имя ссылки введено в том же формате, который указан в поле Добавить подстановку. Например, если ввести пароль pwd в поле Добавить подстановку и ввести password в качестве имени ссылки в необработанных данных, при запуске bot выполнение bot завершится ошибкой.
  12. Параметры учетных данных: Если требуется ввести параметры необработанных данных в качестве учетных данных, можно выбрать Компонент учетных данных, чтобы использовать значение, доступное в хранилище учетных данных, или Переменная, чтобы использовать переменную учетных данных, или небезопасную строку, чтобы вручную указать значение, которое требуется использовать.
  13. Выберите Без проверки подлинности или Базовая из Режим проверки подлинности список.
    • Выбрав Без проверки подлинности, перейдите к следующему шагу.
    • Выбрав вариант Базовый, введите свои учетные данные.
  14. Необязательно: Предоставьте сертификат клиента, выбрав файл в Control Room или на рабочем столе, или вставьте переменную.
  15. Необязательно: Предоставьте настраиваемые заголовки.
  16. Необязательно: Укажите файл для сохранения выходных данных XML.
  17. Выберите Полный ответ или Выбранный ответ, чтобы сузить рамки ответа.
    • Выбрав Полный ответ, перейдите к следующему шагу.
    • При выборе параметра Выбранный ответ, если вы создаете выражение XPath вручную, не используя параметр Создать XPath, выполните указанные ниже действия.
      1. Предоставьте выражение XPath. Пример.
        /*[local-name()='Envelope' and namespace-uri()='http://schemas.xmlsoap.org/soap/envelope/']/*[local-name()='Body' and namespace-uri()='http://schemas.xmlsoap.org/soap/envelope/']/*[local-name()='AddResponse' and namespace-uri()='http://tempuri.org/']/*[local-name()='AddResult' and namespace-uri()='http://tempuri.org/']
      2. Выберите раздел выходного XML-файла: Значения, Внутренний XML или Внешний XML
      3. Выбрав Значения, выберите вариант разделителя: прямая черта или точка с запятой.
      4. Выбрав Значения, выберите вариант разделителя: Прямая черта, Точка с запятой или Пользовательский.
        Если вы выбрали Пользовательский, введите переменные или символы в поле Пользовательский разделитель (необязательно).
        Прим.: Специальный символ «знак доллара» ($) в качестве разделителя не поддерживается.
  18. Щелкните Создать Xpath.
    Открывается окно предварительного просмотра выходных данных.
  19. Выберите соответствующий узел из тела ответа. Путь XML создается автоматически. Щелкните Применить.
    Если используется команда Создать Xpath, поля Выражение XPath и Значение поля автоматически заполняются сведениями на основе выбранной операции.
  20. Необязательно: Чтобы установить значение ожидания при отправке SOAP-запроса и получении ответа, укажите время ожидания (в миллисекундах) в параметре Время ожидания завершения действия.
    По умолчанию время ожидания составляет 60 000 миллисекунд.
  21. Выберите переменную для сохранения выходных данных XML.
    Например, prompt-assignment
  22. Проверьте выходные данные action веб-службы SOAP, вставив в тело сообщения action Окно сообщения с переменной prompt-assignment.
    При запуске bot в окне сообщения должно отображаться значение 30.
Отправить отзыв