Leia e revise a documentação do Automation Anywhere

Automation Anywhere Automation 360

Fechar conteúdo

Contents (Conteúdo)

Abrir conteúdo

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

  • Atualizado: 2022/03/10
    • Automation 360 v.x
    • Criar
    • Espaço de trabalho RPA
    • Exemplos

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

Use a action 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 6.
  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 10.
  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ço para uma chamada de serviço web SOAP, por exemplo, Calculadora.
  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ção para uma chamada de serviço web SOAP, por exemplo, CalculadoraSoap.
  8. Selecione Versão SOAP do ponto final especificado no campo Porta.
    Escolha 1.1 ou 1.2.
  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ção para uma chamada de serviço web SOAP, por exemplo, Adicionar.
  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 lockers 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 conforme 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 a entrada senha como nome de referência nos dados brutos, ao executar o bot, o bot irá executar 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 Valores, escolha uma opção delimitadora: Pipe ou Ponto e vírgula.
      4. Se você selecionar Valores, 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.
  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. Selecione uma variável para armazenar a saída XML.
    Por exemplo, atribuição de prompt
  22. Verifique a saída do serviço web SOAP action inserindo uma caixa de mensagem action com a variável atribuição de prompt no corpo da mensagem.
    Quando você executar o bot, a caixa de mensagem deverá mostrar 30.
Send Feedback (Enviar Feedback)