Leia e revise a documentação do 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/08/26
    • 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, entre no 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çopara 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çãopara 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çãopara 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 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 digitado a senha como pwd em Adicionar substituição e entrar senha como nome de referência nos dados brutos, quando você executa o boto 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 Valoresescolha o conteúdo de retorno como: Corda delimitada por ou Lista de cordas.
        • Se você selecionar Corda delimitada porescolha uma opção de delimitador: 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 cordas para retornar a saída da resposta do sabão como lista de cordas.
          Nota: Você só pode especificar uma lista de tipo 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 Sala de Controle, Arquivo de mesaou Variável
    • Configurar as propriedades da Keystore:
      • Arquivo da Keystore (Opcional): Para fornecer o arquivo do keystore no formato p12, selecione uma das seguintes opções: Arquivo da Sala de Controle, Arquivo de mesaou Variável. O arquivo do keystore inclui a chave privada e o certificado do cliente.
      • Senha do Keystore (Opcional): Para fornecer a senha para o arquivo do keystore, selecione uma das seguintes opções: Credencial, Variável ou Fio inseguro. A senha é usada para acessar o arquivo do keystore.
  22. Selecione uma variável para armazenar a saída XML.
    Por exemplo, pronto atendimento
  23. Verificar a saída do Serviço web SOAPaction inserindo um Caixa de mensagensaction com a variável pronto atendimento na mensagem corporal.
    Quando você executar o bot, a caixa de mensagem deverá mostrar 30.
Send Feedback (Enviar Feedback)