Exemplo de uso da ação Serviço web SOAP

Use a ação serviço web SOAP para passar dois valores numéricos e retornar a soma em um aplicativo de calculadora online.

Procedimento

Para fazer uma chamada de serviços web SOAP, execute as seguintes etapas:

  1. Clique duas vezes ou arraste a ação serviços web SOAP.
  2. Selecione um método de conexão:
    • Para conectar usando um URI, insira o URI, por exemplo, http://www.dneonline.com/calculator.asmx?WSDL.
    • Para conectar usando um arquivo, selecione um arquivo na Control Room ou na área de trabalho, ou insira uma variável.
  3. Opcional: Insira o ponto final SOAP no campo Local do endereço.
    Se você especificar a local do endereço, o bot o utilizará durante a execução; caso contrário, o bot utilizará o local do endereço do arquivo WSDL.
    Nota: Se você estiver criando o URI SOAP manualmente e não estiver usando a opçãoCriar solicitação SOAP, vá para a etapa Exemplo de uso da ação Serviço web SOAP.
  4. Clique em Criar solicitação SOAP.
    A janela Solicitação SOAP é exibida, mostrando os serviços e portas com detalhes sobre suas operações e parâmetro.
  5. Na janela Solicitação SOAP, expanda o serviço para o qual você deseja visualizar a lista de portas. Clique na porta necessária para exibir a lista de operações disponíveis. Selecione a operação desejada e clique em Aplicar para recuperar os detalhes da operação a partir da solicitação SOAP.
    Se você usar a opção Criar solicitação SOAP, Serviços, Porta, Operação e Parâmetros da operação serão automaticamente preenchidos com detalhes baseados na operação que você selecionou. Vá para a etapa Exemplo de uso da ação Serviço web SOAP.
  6. No campo Serviço, insira o nome do serviço.
    Esse campo identifica a coleção de portas compatíveis com o serviço da internet. Ela contém o@valor do nome do serviçopara uma chamada de serviço web SOAP, por exemplo, Calculator.
  7. Opcional: No campo Porta, insira o ponto final ao qual se conectar.
    Se você não especificar uma porta, o bot utilizará a primeira porta mencionada no arquivo WSDL com base no serviço selecionado. No entanto, se esse porta não for compatível com o serviço web SOAP, a execução do bot falhará.
    Este campo contém o@valor do nome de vinculaçãopara uma chamada de serviço web SOAP, por exemplo, CalculatorSoap.
  8. Selecione Versão SOAP do ponto final especificado no campo Porta.
    Escolha 1.1 ou 1.2.
    Nota: A versão SOAP pode ser determinada usando um dos seguintes namespaces especificados no arquivo WSDL:
    • Namespace SOAP 1.1: http://schemas.xmlsoap.org/soap/envelope
    • Namespace SOAP 1.2: http://www.w3.org/2003/05/soap-envelope
  9. No campo Operação, insira o nome da função de serviço para o ponto final especificado no campo Porta.
    A execução do bot falhará se qualquer uma das seguintes situações for verdadeira:
    • A porta mencionada no campo de porta não tem nenhuma operação.
    • A operação mencionada na solicitação SOAP para a porta não está disponível.
    Este campo contém o@valor do nome da operaçãopara uma chamada de serviço web SOAP, por exemplo, Add.
  10. Selecione Parâmetros de operação ou Parâmetros de dados brutos para fornecer os detalhes do parâmetro.
    Nota: Se você tiver selecionado Criar solicitação SOAP, a tabela de detalhes do parâmetro na guia Operação será automaticamente preenchida com os parâmetros da operação selecionada. Forneça valores para estes parâmetros. Você também pode adicionar, editar ou excluir os parâmetros para uma determinada operação.
    • Se você selecionar Parâmetros da operação, insira o nome e o valor de cada parâmetro. Por exemplo, insira os seguintes valores:
      1. intA no primeiro campo Nome
      2. 10 no primeiro campo Valor
      3. intB no segundo campo Nome
      4. 20 no segundo campo Valor
    • Se você escolher Parâmetros de dados brutos, selecione Parâmetros ou Parâmetros da credencial.
  11. Parâmetros: Você pode usar os valores das credenciais do cofre de credenciais sem expor as credenciais (nome de usuário ou senha) em texto sem formatação nos dados brutos. Para isso, é necessário primeiro mapear a credencial no mapeador de credenciais e usar o nome de referência nos dados brutos entre chaves.

    Por exemplo, nos dados brutos, você forneceu a senha em texto sem formatação para autenticar no servidor.

    <aut:AuthHeader>
    <aut:Password> abc@123</aut:Password>
    </aut:AuthHeader>
    
    Para usar a senha do cofre de credenciais, execute os seguintes passos:
    1. Clique em Adicionar substituição.
      Digite o nome de referência, por exemplo, pwd no campo Nome em XML. Selecione Credencial para usar um valor disponível no cofre de credenciais ou selecione Variável para usar uma variável de credencial ou, String insegura para especificar manualmente o valor que deseja usar.
      Para mais informações sobre cofres de credenciais e como utilizá-los, consulte Credenciais e cofres no Credential Vault.
    2. Clique em Adicionar
    3. Especifique a referência nos dados brutos entre chaves, conforme a seguir:
      <aut:AuthHeader>
      <aut:Password>{{pwd}}</aut:Password>
      </aut:AuthHeader>
      
      O nome de referência pwd especificado nos dados brutos substituirá o valor correspondente armazenado no cofre de credenciais.
      Certifique-se de inserir o nome de referência no mesmo formato especificado em Adicionar substituição. Por exemplo, se você tiver inserido a senha como pwd em Adicionar substituição e inserir password como nome de referência nos dados brutos, ao executar o bot, o bot encontrará um erro.
  12. Parâmetros da credencial: Se você quiser inserir parâmetros de dados brutos como credencial. Você pode escolher Credencial para usar um valor disponível no cofre de credenciais ou selecionar Variável para usar uma variável de credencial ou string insegura para especificar manualmente o valor que deseja usar.
  13. Selecione Sem autenticação ou Básico na lista Modo de autenticação.
    • Se você selecionar Sem autenticação, prossiga para a próxima etapa.
    • Se você selecionar Básico, insira as suas credenciais.
  14. Opcional: Forneça um certificado do cliente selecionando um arquivo da Control Room ou do desktop, ou insira uma variável.
  15. Opcional: Forneça cabeçalhos personalizados.
  16. Opcional: Forneça um arquivo para salvar a saída XML.
  17. Selecione Resposta completa ou Resposta selecionada para reduzir o escopo da resposta.
    • Se você selecionar Resposta completa, prossiga para a próxima etapa.
    • Se você selecionar Resposta selecionada, execute os seguintes passos, execute as seguintes etapas se você estiver criando a expressão Xpath manualmente e não estiver usando a opção Criar Xpath .
      1. Forneça a expressão XPath. Por exemplo:
        /*[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. Selecione uma seção da saída XML: Valores, XML interno ou XML externo.
      3. Se você selecionar a opção Valores, escolha o conteúdo de retorno como: String delimitada por ou Lista de strings.
        • Se você selecionar String delimitada por, escolha uma opção delimitadora: Pipe, Ponto e vírgula ou Personalizado.
          Se você selecionar Personalizado, insira variáveis ou caracteres no campo Delimitador personalizado (opcional).
          Nota: Não há suporte para o caractere especial de dólar ($) como delimitador.
        • Selecione Lista de strings para retornar a saída da resposta SOAP como lista de strings.
          Nota: Você só pode especificar um tipo de lista de variável com tipo de dados como strings.
  18. Clique em Criar Xpath.
    A janela de visualização da saída é exibida.
  19. Selecione o nó apropriado do corpo de resposta. O caminho XML é criado automaticamente. Clique em Aplicar.
    Se você usar a opção Criar Xpath, os campos Expressão XPath e Valor serão automaticamente preenchidos com detalhes baseados na operação selecionada.
  20. Opcional: Para definir um valor de tempo esgotado quando enviar uma solicitação SOAP e receber uma resposta, no campo Aguarde a ação para concluir, especifique o tempo de espera (em milissegundos).
    Por padrão, o tempo de espera é de 60000 milissegundos.
  21. Configurar o certificado P12:
    • Para obter o arquivo de certificação SSL, selecione uma das seguintes opções: Arquivo da Control Room, Arquivo da área de trabalho ou Variável
    • Configurar as propriedades do repositório de chaves:
      • Arquivo do repositório de chaves (opcional): Para fornecer o arquivo do repositório de chaves no formato .p12, selecione uma das seguintes opções: Arquivo da Control Room, Arquivo da área de trabalho ou Variável. O arquivo do repositório de chaves inclui a chave privada e o certificado do cliente.
      • Senha do repositório de chaves (opcional): Para fornecer a senha para o arquivo do repositório de chaves, selecione uma das seguintes opções: Credencial, Variável ou String insegura. A senha é usada para acessar o arquivo do repositório de chaves.
  22. Selecione uma variável para armazenar a saída XML.
    Por exemplo, prompt-assignment
  23. Verifique a saída da ação Serviço web SOAP inserindo uma ação Caixa de mensagem com a variável prompt-assignment no corpo da mensagem.
    Quando você executar o bot, a caixa de mensagem deverá mostrar 30.