Preparação para enviar status para um serviço web SOAP
- 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 sobre o evento para o qual deseja acionar a notificação e as condições que
determinam quando a notificação chama o serviço web.Caso queira enviar uma notificação para um evento que ocorre somente quando um fluxo de trabalho específico processa uma tarefa, especifique esse fluxo de trabalho como uma condição.
- Defina uma notificação de serviço web SOAP:
- Clique na guia Administração.
- No painel esquerdo, clique em .
- Clique em .
- Na guia Geral, insira um nome para a notificação.
- Na guia Solicitação:
- Defina a propriedade Request URL para a URL do serviço web que deseja notificar.
- Para o valor da propriedade Request payload, especifique o corpo da solicitação dos serviços web que a notificação envia para
o aplicativo.Nesse exemplo, a carga contém dois elementos XML: <Token> e <OrderNumber>.
<Token>${WS.Notification.WebService.Credential}</Token> <OrderNumber>${Job.Info.Attr1}</OrderNumber>
O valor de cada elemento é um símbolo RICOH ProcessDirector que contém uma propriedade. Se você estiver usando um serviço web para autenticar com o aplicativo, inclua a propriedade WSNotification.WebService.Credential em um símbolo. Substitua o outro elemento e a propriedade pelos elementos e propriedades que deseja enviar ao aplicativo. A notificação resolve os símbolos quando envia o status para o serviço web SOAP.
- 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 CloseoutOrderByNumber. Você anexou PrintShop aos nomes das solicitações SOAP ao importá-las. Selecione PrintShop-CloseoutOrderByNumber.
- 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.
- Na guia Autenticação, especifique os valores necessários para autenticar com o aplicativo.Para obter mais informações, consulte a tarefa relacionada sobre como autenticar com um serviço web SOAP.
Se o aplicativo não exigir autenticação, deixe todas as propriedades da autenticação em branco.
- Na guia Evento:
- Escolha o tipo de objeto a ser monitorado.
- Selecione a propriedade, a ação e o valor a ser monitorado.
- Para definir outro evento, clique em + à direita de qualquer evento.
- Para excluir um evento, clique em - à direita do evento que deseja excluir.
Por exemplo, para enviar uma notificação quando o estado de uma tarefa é alterado para Retained, selecione Current job state, Changes to e Retained. - Na guia Condições:
- Selecione a propriedade e o valor que devem ser satisfeitos antes de enviar qualquer notificação.
- Para definir outra condição, clique em + à direita de qualquer evento.Para especificar como as condições são combinadas, selecione Any, All ou Custom.
- Para excluir uma condição, clique em - à direita da condição que você quer excluir.
Por exemplo, para enviar uma notificação somente quando uma tarefa filha está no fluxo de trabalho ProcessWebOrders, especifique duas condições:- Workflow = ProcessWebOrders
- Número da tarefa como*.*
Para aplicar as condições somente quando uma tarefa satisfizer ambas, selecione All.
- Quando terminar, clique em OK.
Ao concluir a configuração de seus dispositivos de entrada, notificações e fluxos de trabalho, teste a troca de dados entre RICOH ProcessDirector e o aplicativo.
A notificação de serviço web REST RestfulWebServiceSampleNorify fornecida é semelhante a uma notificação de serviço web SOAP. O recurso MarcomCentral Connect inclui uma notificação de serviço web SOAP fornecida.