Chamada SOAP

• Tipo de Tarefa: soap-call

Descrição

A tarefa "Chamada SOAP" permite executar uma requisição a um serviço web baseado no protocolo SOAP. A tarefa gere automaticamente a construção do payload XML (Envelope) e o parsing das mensagens de erro (Fault) devolvidas pelo servidor.

Parâmetros de Configuração

• Conexão SSL: Especifica se a chamada deve utilizar o protocolo SSL (si / no).
• Proxy: Configuração para o encaminhamento da chamada:
• Configuração do Sistema: Utiliza as configurações de proxy padrão do sistema.
• Sem Proxy: Nenhum proxy utilizado.
• Proxy Personalizado: Permite inserir um endereço específico no campo dedicado.
• Endpoint: A URL completa do serviço web SOAP a ser consultado. (ex. https://www.dataaccess.com/webservicesserver/NumberConversion.wso).
• Namespace: O URI do namespace XML a associar ao prefixo ns dentro do corpo da requisição. Insira a declaração completa, incluindo xmlns:ns= e o namespace entre aspas. (ex. xmlns:ns="http://www.dataaccess.com/webservicesserver/").
• Header: Insira a tag <soap:Header> na mensagem SOAP. Se não houver dados para incluir, use <soap:Header/>. Se o serviço exigir informações (ex. token de autorização), insira-as dentro da tag:

<soap:Header>
 <auth:Token>ABC123XYZ</auth:Token>
</soap:Header>```

• Body: Insira a tag <soap:Body> contendo os dados da chamada (ex. <soap:Body><ns:Metodo>...</ns:Metodo></soap:Body>).

Notas Técnicas Importantes

• Envelope: Não deve ser inserida a tag </soap:Envelope>. A tarefa gera automaticamente o cabeçalho XML e a abertura/fecho do Envelope.
• Content-Type: A tarefa utiliza exclusivamente text/xml; charset=utf-8 como Content-Type padrão e não é modificável.

Parâmetros de Saída

A tarefa expõe os seguintes parâmetros após receber a resposta do servidor:

• result: Retorna uma mensagem de texto que descreve o resultado da operação.
• response: Contém o XML de resposta completo enviado pelo servidor em caso de sucesso.
• faultCode: Retorna o código de erro SOAP (ex. soap:Server ou soap:Client) se a chamada falhar.
• faultString: Retorna a descrição textual do erro fornecida pelo serviço web.
• exitStatus: Código de estado da operação (0 indica sucesso).
• resultJson: Representação completa da execução da tarefa em formato JSON.

Exemplo resultJson

{
  "run_info": {
    "status": "Completed",
    "run_result": "Success"
  },
  "output_parameters": {
    "exitStatus": "0"
  }
}

Gestão de Erros

Em caso de erro SOAP (presença de um nó <soap:Fault>), a tarefa é marcada como Falhou. Os detalhes do erro serão mapeados nos parâmetros faultCode e faultString, facilitando a depuração ou o tratamento de ramos condicionais no fluxo de trabalho.