Chamada de um serviço web SOAP a partir de um fluxo de trabalho
- Saiba os requisitos de comunicação com o serviço web SOAP para o aplicativo:
- Os valores para autenticação com o aplicativo
- Os valores para solicitar dados do serviço web SOAP
- O formato dos dados fornecidos na resposta
Consulte a documentação do aplicativo ou consulte a empresa que hospeda o aplicativo.
- Para preparar RICOH ProcessDirector para se comunicar com o aplicativo, execute as seguintes tarefas:
- Se o aplicativo exigir um certificado de segurança, instale o certificado no computador primário de RICOH ProcessDirector.
- Se o seu ambiente exigir um servidor proxy para se comunicar com serviços web, configure o sistema para usá-lo.
- Importe arquivos WSDL para todos os serviços web que você planeja chamar.
RICOH ProcessDirector cria objetos de solicitação SOAP de operações SOAP no arquivo WSDL. Você especifica um prefixo que RICOH ProcessDirector adiciona aos nomes das operações SOAP ao criar os objetos. Um objeto de solicitação SOAP permite a RICOH ProcessDirector determinar a versão SOAP e outras informações necessárias para fazer um chamada correta para o serviço web.
Para obter mais informações, consulte as tarefas relacionadas.
- Execute um teste manual que autentique com o aplicativo e que solicita uma resposta
do serviço web SOAP. Verifique se o serviço web retorna a resposta que você deseja.Muitos navegadores possuem plug-ins, como Boomerang para Google Chrome, que testam chamadas de serviço web clientes SOAP.
- Decida como deseja especificar a solicitação:
- Você pode inserir a carga como o valor da propriedade Request payload.
- É possível armazenar a carga de um arquivo de texto que a etapa CallSOAPService pode acessar durante o processamento de tarefa.
- Clique na guia Fluxo de trabalho
- Clique no nome do fluxo de trabalho que deseja modificar.
- Opcional: Desative o fluxo de trabalho clicando no botão à esquerda do nome do fluxo de trabalho.
Se você não desativar o fluxo de trabalho ao editá-lo, tarefas que usam esse fluxo de trabalho continuarão avançando pelas etapas. Quando você salvar, o fluxo de trabalho será momentaneamente desativado e, em seguida, ativado novamente. As tarefas que estão sendo processadas no fluxo de trabalho podem apresentar um erro.
- Revise as etapas incluídas no fluxo de trabalho e os valores padrão definidos por elas.
- Inclua uma etapa com base no modelo de etapas CallSOAPService para o fluxo de trabalho no local adequado.
- Defina valores para as propriedades da tarefa.
- Defina a propriedade Request URL para a URL do serviço web que a etapa chama.O URL pode usar protocolo HTTP ou HTTPS.
- Defina a propriedade Password para a senha que a etapa fornece ao serviço web SOAP para autenticação com o aplicativo.Você insere a senha como valor desta propriedade. Para fornecer a senha para o serviço web SOAP, especifique a propriedade Job.WebService.Password como um símbolo na propriedade Request payload ou Request URL: ${Job.WebService.Password}. Para determinar qual propriedade utilizar, consulte a documentação do serviço web.
- Defina a propriedade Request payload type:
- Para especificar o corpo da solicitação de serviços web como o valor da propriedade Request payload, selecione TEXT.
- Para especificar o corpo da solicitação de serviços web em um arquivo de texto que a etapa CallSOAPService possa acessar durante o processamento de tarefa, selecione FILE.
- Defina a propriedade Request payload:
- Se você definir a propriedade Request payload type para TEXT, insira a carga como o valor dessa propriedade.
- Se você definir a propriedade Request payload type para FILE, insira o caminho do diretório completo, o nome e a extensão do arquivo de texto
como o valor dessa propriedade.
Insira a carga no arquivo de texto.
Para enviar a senha na carga, especifique a propriedade Job.WebService.Password como um símbolo.
Neste exemplo, o ID de pedido é armazenado como o valor da propriedade da tarefa Custom 3 ( Job.Info.Attr3). A carga inclui a senha como valor do elemento <Token> e o ID de pedido como o valor do elemento <OrderID>:
<Token>${Job.WebService.Password}</Token><OrderID>${Job.Info.Attr3}</OrderID>
A etapa resolve os símbolos quando chama o serviço web SOAP.
- Se o seu ambiente exigir um servidor proxy para se comunicar com serviços web, configure a propriedade Use proxy para o servidor proxy correto.
- Defina a propriedade Response file para o caminho do diretório completo e o nome do arquivo que RICOH ProcessDirector utiliza para armazenar a resposta do aplicativo.Normalmente, esse valor é ${getFileName(print,xml,write)}.Após a resposta ser armazenada no arquivo, outras etapas no fluxo de trabalho podem processar a resposta.
- Defina a propriedade SOAP request para a solicitação SOAP que RICOH ProcessDirector criou quando você importou o arquivo WSDL.
Por exemplo, você deseja usar a solicitação SOAP GetOrdersByDate. Você anexou PrintShop aos nomes das solicitações SOAP ao importá-las. Selecione PrintShop-GetOrdersByDate.
- Defina a propriedade Request URL para a URL do serviço web que a etapa chama.
- Quando terminar, clique em OK.
- Salve e habilite o fluxo de trabalho.
Ao concluir a configuração dos fluxos de trabalho, teste a troca de dados entre RICOH ProcessDirector e o aplicativo.
Exemplo
O recurso MarcomCentral Connect inclui dois fluxos de trabalho fornecidos com etapas CallSOAPService.