SOAP Request

UiPath.Web.Activities.Design.SoapClientWithBodyFactory

Description

Enables you to perform HTTP requests to a specified web API which uses the SOAP protocol. When first dragging this activity to the Designer panel, the SOAP Request Wizard window is displayed. The wizard provides an easy way of building requests and previewing server responses. Once you close the wizard, you cannot reopen it.

Todos os campos presentes nessa janela estão disponíveis também no painel de Propriedades.Na sequência, você ainda pode editar suas preferências após fechar o assistente.

Compatibilidade do projeto

Windows - Legacy

Observação:

As solicitações SOAP são compatíveis apenas com projetos do Windows - Legado. Se você tiver que executar solicitações SOAP em projetos do Windows ou multiplataforma, em vez disso, tente estas soluções:

• Use um Windows - Legado para todo o seu processo.
• Use um processo do Windows - Legado apenas para a parte das colicitações SOAP e invoque-o de um processo do Windows por meio de argumentos de entrada/saída
• Use a atividade Invoke code.
• Use fluxos de trabalho codificados (disponíveis a partir do Studio 2023.10).
• Use a atividade HTTP Request para criar sua própria solicitação que corresponda à definição de SOAP. Certifique-se de usar os cabeçalhos adequados e incluir o XML correto no corpo de sua solicitação.

O Assistente de Solicitação SOAP

• Service Description - The WSDL schema location.
• Ellipsis menu - Enables you to browse your hard drive for a .wsdl file.
• Get - Fetches information from the provided .wsdl file, and displays the available parameters in the table.
• Contract - The name of the contract which describes the methods exposed by the SOAP service.
• Method - A list of all the supported methods. Changing the method also changes the parameters displayed in the table.

Tabela de Parâmetros

• Name - The name of all the supported parameters.
• Type - The type of each supported parameter. In some cases, hovering over the Type displays further information, such as whether or not the parameter is optional.
• Value - Enables you to add a value for each parameter, so you can make the desired request.
• Authentication - A dropdown list that enables you to select the type of authentication used by the web service. The following options are available:
  • None - the default option. Indicates that the web service does not use any kind of authorization.
  • Simple - Indicated that the service uses simple authentication. If this method is selected, the Username and Password fields are displayed, which enables you to input your credentials.
  • Windows - Indicates that the service uses Windows authentication.
  • Client Certificate - Indicates that the service uses Client Certificates for authorization. If selected, the Client Certificate field is displayed, which enables you to browse your local drive for your certificate.
• Invoke - Enables you to perform the request with the specified options.
• Response - Displays a preview of the web server's response.

Propriedades

CertificateAuthentication do Cliente

• Client Certificate - Indicates that the service uses Client Certificates for authorization and enables you to browse your local drive for your certificate.
• ClientCertificatePassword - The password for the client certificate. This field supports String variables.
• SecureClientCertificatePassword - The password for the client certificate, in the form of a Secure String variable.

Comum

• ContinueOnError - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (True, False). The default value is False. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.
  Observação:

  If this activity is included in Try Catch and the value of the ContinueOnError property is True, no error is caught when the project is executed.

• DisplayName - O nome de exibição da atividade.

Entrada

• Contract Name - The name of the contract which describes the methods exposed by the SOAP service. This property supports strings and string variables.
• EndPoint - The WSDL schema location. By default, the http://www.webservicex.com/globalweather.asmx?wsdl URL is provided, for testing purposes. This property supports strings and string variables, and corresponds to the Service Description field, in the SOAP Request Wizard window.
• Method - Method name called by the client.
• Parameters - The parameters for the specified method. Select the Ellipsis button to display the Parameters window, in which you can add the desired parameters.

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Saída

• Headers - The response received from the SOAP request.
• Result - The web server's response, as a String variable.

Autenticação Simples

• Username - Indicates that the web service uses simple authentication and enables you to input your username. Adding a password is also required. This property supports strings and string variables.
• Password - Indicates that the web service uses simple authentication and enables you to input your password. Adding a username is also required. This property supports Strings and String variables.
• SecurePassword - Indicates that the web service uses secure authentication and enables you to input your secure string password. Adding a username is also required. This property supports Secure String variables.

Autenticação do Windows

• UseWindowsCredentials - If selected, this check box indicates that Windows Credentials should be used with the specified web service.