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.
• Menu de reticências - Permite que você navegue em seu disco rígido para um arquivo .
• Obter - Busca informações do arquivo .wsdl fornecido e exibe os parâmetros disponíveis na tabela.
• Contract - The name of the contract which describes the methods exposed by the SOAP service.
• Método - Uma lista de todos os métodos compatíveis. Alterar o método também altera os parâmetros exibidos na tabela.

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.
• Autenticação - Uma lista suspensa que permite que você selecione o tipo de autenticação usada pelo serviço da Web. As seguintes opções estão disponíveis:
  • 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

• ContinuarComErro — especifica se a automação deve continuar mesmo quando a atividade gera um erro. Este campo só aceita valores booleanos (True, False). O valor padrão é False. Como resultado, se o campo estiver em branco e um erro for lançado, a execução do projeto será interrompida. Se o valor for definido como True, a execução do projeto prosseguirá mesmo com erros.
  Observação:

  Se esta atividade estiver incluída em Try Catch e o valor da propriedade Continuar com erro for Verdadeiro, nenhum erro será capturado quando o projeto for executado.

• 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.
• Parâmetros - Os parâmetros para o método especificado. Selecione o botão Reticências para exibir a janela Parâmetros , na qual você pode adicionar os parâmetros desejados.

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.