Execução da amostra de fluxos de trabalho para processar pedidos recuperados do MarcomCentral
A amostra de dispositivo de entrada, a etapa CallSOAPService e a notificação executam uma simulação. Os serviços Web do MarcomCentral especificado não é chamado. A simulação permite executar as amostras sem obter suas próprias credenciais do MarcomCentral e configurar uma amostra de loja do MarcomCentral que se parece com a amostra de loja. As amostras usam cargas de solicitação SOAP 1.1 para recuperar a simulação de um pedido do MarcomCentral e dois bilhetes de tarefas. O valor nos campos de credencial estática e de senha informam RICOH ProcessDirector para executar a simulação.
Depois de executar as amostras, você poderá copiá-las. Em seguida, você pode ajustar os valores nas cópias para trocar dados com sua própria loja no site do MarcomCentral.
- Obs.:
- A amostra de objetos e arquivos é instalada com o recurso MarcomCentral Connect.
A simulação inclui objetos de solicitação SOAP WSDL (Web Services Description Language) importados do MarcomCentral. Cada amostra de dispositivo de entrada, etapas CallSOAPService e notificação especifica uma solicitação SOAP.
Essa simulação usa esses objetos e arquivos:
- Fluxos de trabalho:
- MarcomProcessOrders
- MarcomProcessJobTicket
- Mapeamento de propriedades de pedido: MarconOrderSample
- Dispositivo de entrada: MarcomReceiveOrders
O dispositivo de entrada recupera pedidos XML do site do MarcomCentral, simulando uma chamada para um serviço Web em
https://services.printable.com/Trans/1.0/Order.asmx
A solicitação SOAP é Marcom-Get OrdersByDate.
- Notificação: MarcomCloseoutOrder
A notificação envia as informações de conclusão do pedido para o site do MarcomCentral simulando uma chamada para um serviço Web em
https://services.printable.com/Trans/1.0/Closeout.asmx
A solicitação SOAP é MarcomSample-CloseoutByOrder.
- Pedidos XML
Na simulação, um pedido é recuperado a cada 30 segundos pelo serviço Web.
Depois de executar as amostras de fluxos de trabalho, poderá ver o conteúdo de uma amostra de pedido. Vá para:
C:\aiw\aiw1\spool\default\job_number
Substitua numero_da_tarefa pelo número da tarefa, por exemplo, 10000001.
Exiba o conteúdo do arquivo numero_da_tarefa.print.xml, por exemplo, 10000001.print.xml.
- Bilhetes de tarefas XML
Na simulação, dois bilhetes de tarefas são recuperados para cada pedido.
Depois de executar as amostras de fluxos de trabalho, você poderá ver o conteúdo das duas amostras de bilhetes de tarefas. Vá para:
C:\aiw\aiw1\spool\default\child_job_number
Substitua numero_da_tarefa_filha pelo número da tarefa filha, por exemplo, 10000001.1 ou 10000001.2.
Exiba o conteúdo do arquivo numero_da_tarefa_filha.print.xml, por exemplo, 10000001.1.print.xml ou 10000001.2.print.xml.
- Arquivo impresso:
Savings.pdf
O download desse arquivo é feito localmente em
http://localhost:15080/restapi/
- Arquivo de folha de estilo XSLT:
downloadOverrides.xslt
O arquivo está no diretório
Marcom
:C:\aiw\aiw1\testfiles\Marcom
- Etapa CallSOAPService:
- A etapa CallSOAPService recupera um bilhete de tarefa do site do MarcomCentral pela simulação de uma chamada
para um serviço Web em
https://services.printable.com/Trans/1.0/JobTicket.asmx
A solicitação SOAP é Marcom-GetJobTicketByLineItem.
- A etapa CallSOAPService recupera um bilhete de tarefa do site do MarcomCentral pela simulação de uma chamada
para um serviço Web em
Para executar o fluxo de trabalho de amostra:
- Clique na guia Principal.
- No portlet de Impressoras, clique com o botão direito na impressora Sample e selecione Enable.
- No portlet Dispositivos de entrada, clique com o botão direito do mouse no dispositivo
de entrada de serviço Web SOAP MarcomReceiveOrders e selecione Ativar e Conectar.
Uma tarefa denominada Amostra de Pedido do Marcom aparece na tabela de tarefas.
- Clique com o botão direito do mouse no dispositivo de entrada MarcomReceiveOrders e selecione Desativar e desconectar.
- Obs.:
- A amostra de dispositivo de entrada cria pools para pedidos a cada 30 segundos e recupera uma tarefa XML. Se você não desativar e desconectar o dispositivo de entrada, uma nova tarefa aparecerá na tabela de tarefas a cada 30 segundos.
A carga da solicitação para o dispositivo de entrada inclui esses símbolos RICOH ProcessDirector:
- ${WebService.StaticCredential}
Especifica a credencial estática
- ${WebService.LastSuccessRequestTime}
Especifica a data e a hora em que o dispositivo de entrada solicitou com sucesso pela última vez uma resposta de um serviço web.
- ${WebService.CurrentRequestTime}
Especifica a data e a hora da solicitação atual.
Cada vez que o dispositivo de entrada MarcomReceiveOrders recupera uma tarefa XML, ele envia a tarefa para o fluxo de trabalho MarcomProcessOrders.
A tarefa é enviada por essas e outras etapas no fluxo de trabalho MarcomProcessOrders:
- A etapa SetJobPropsFromTextFile define a propriedade Nome da tarefa para Marcom Sample Order.
- A etapa CreateOrdersFromFile usa o objeto de mapeamento de propriedades MarcomOrderSample para identificar pedidos e tarefas e, em seguida, mapeia os valores de alguns elementos XML no arquivo de pedidos XML para as propriedades de pedido e tarefa.
-
A tabela lista as propriedades que são definidas.
Elemento XML Nome do banco de dados Nome da interface do usuário /Order/OrderNumber
Order.Name Nome do pedido /Order/ID
Order.Reference Referência de pedido externo /Order/OrderDetails/OrderDetail/User/Name
Order.Customer Nome do cliente /Order/OrderDetails/OrderDetail/SKUDescription
Order.Description Descrição /Order/OrderDetails/OrderDetail/Quantity
Job.Copies Cópias de Tarefas Solicitadas /Order/OrderDetails/OrderDetail/OrderNumber
Job.Marcom.OrderNumber Número do pedido do MarcomCentral /Order/ID
Job.Marcom.OrderId ID do pedido do MarcomCentral /Order/OrderDetails/OrderDetail/ID
Job.Marcom.JobTicketId Bilhete de tarefas do MarcomCentral /Order/OrderDetails/OrderDetail/ProductType
Job.Marcom.ProductType Tipo de produto do MarcomCentral /Order/OrderDetails/OrderDetail/ProductName
Job.Name Nome da Tarefa A etapa identifica um pedido com duas tarefas. Ele cria duas tarefas, Boné de beisebol do Jensen Bank e Folheto, e envia as tarefas para o fluxo de trabalho MarcomProcessJobTicket.
A tarefa do pedido original é enviada para a etapa WaitForRelatedJobs.
As tarefas começam a ser processadas no fluxo de trabalho MarcomProcessJobTicket. Quando a tarefa chega à etapa SetJobPropsFromTextFile, a regra no conector [1] Armazém verifica o valor da propriedade Tipo de produto do MarcomCentral. Com versão, Variável e JobDirect são tipos de produtos para itens imprimíveis.
- Se o item não tiver um tipo de produto imprimível, o fluxo de trabalho envia a tarefa pela ramificação Armazém.
- Se o item tiver um tipo de produto imprimível, o fluxo de trabalho envia a tarefa pela ramificação Imprimível.
As tarefas não imprimíveis pela etapa ManualStepWithAutoStart na ramificação Armazém do fluxo de trabalho. As tarefas aguardam nessa etapa até que a equipe do armazém indique que as tarefas estão prontas para serem enviadas.
As tarefas imprimíveis passam por essas etapas e conectores na ramificação Imprimível do fluxo de trabalho:
- Quando a tarefa alcança a segunda etapa ContinueToNextStep, a regra no conector [1] Arquivo pronto verifica se a propriedade Custom 3 (URL do arquivo de download) está definida como um valor.
- Se estiver, o arquivo impresso está pronto para download. O fluxo de trabalho envia a tarefa diretamente para a etapa DownloadFile.
- Se não, a regra do conector [2] Verificar por arquivo verifica se o valor da propriedade de tarefa Número inteiro personalizado 1 é menor que 10. A primeira vez em que a tarefa alcança a segunda etapa ContinueToNextStep, o valor da propriedade Número inteiro personalizado 1 é 0.
- Se o valor for 0 a 9, fluxo de trabalho enviará a tarefa para a etapa Aguardar, que aguarda por 30 segundos. Em seguida, o fluxo de trabalho envia a tarefa para
a etapa CallSOAPService.
A etapa CallSOAPService chama o serviço Web do MarcomCentral que recupera um bilhete de tarefa para um item imprimível. A etapa especifica dois símbolos RICOH ProcessDirector como parte do valor na propriedade Solicitar payload:
- ${Job.WebService.Password}
Especifica a credencial estática.
- ${Job.Marcom.JobTicketId}
Especifica a ID do bilhete de tarefa.
A etapa ApplyXSLTransform2 usa a folha de estilo XSLT
downloadOverrides.xslt
para converter um elemento XML em uma propriedade da tarefa RICOH ProcessDirector:Elemento XML Nome do banco de dados da propriedade da tarefa Nome da interface com o usuário da propriedade da tarefa Bilhete de Tarefa/FinalOutputFileURL/URL Job.Info.Attr3 Personalizada 3 A etapa coloca o valor em um arquivo de substituições e substitui o arquivo de substituições no diretório de spool para a tarefa com o novo arquivo de substituições.
Esse exemplo mostra o conteúdo da amostra do arquivo de substituições:
Job.Info.Attr3=http://localhost:15080/restapi/Savings.pdf
A etapa AssignJobValues aumenta o valor da propriedade Número inteiro personalizado 1 em 1. Em seguida, o fluxo de trabalho envia a tarefa de volta para a segunda etapa ContinueToNextStep, que envia a tarefa pela etapa Aguardar para a etapa CallSOAPService. A etapa CallSOAPService repete a chamada para o serviço Web do MarcomCentral que recupera um bilhete de tarefa para um item imprimível. Se a propriedade Custom 3 ainda não tiver nenhum valor para o URL, o fluxo de trabalho envia a tarefa pela etapa CallSOAPService até 9 vezes.
- ${Job.WebService.Password}
- Se o valor for 10, a tarefa foi enviada para a etapa CallSOAPService 10 vezes. Após 5 minutos, a propriedade Custom 3 ainda não tem um valor para o arquivo para download. A tarefa não atende a regra
no conector [2] Verificar por arquivo. O fluxo de trabalho envia a tarefa pelo conector [3] Tempo Limite para a etapa FailWithMesssage e grava uma mensagem de falha no log da tarefa. A mensagem informa: O arquivo não estava disponível para download no tempo permitido.
- Obs.:
- Como a mensagem é uma propriedade de tarefa, ela aparece na guia Informações do bloco de notas da propriedade de tarefa para todas as tarefas que passam pelo fluxo de trabalho. A mensagem aparece no log da tarefa somente quando o fluxo de trabalho envia a tarefa pelo conector [3] Tempo Limite para a etapa FailWithMesssage.
- Se o valor for 0 a 9, fluxo de trabalho enviará a tarefa para a etapa Aguardar, que aguarda por 30 segundos. Em seguida, o fluxo de trabalho envia a tarefa para
a etapa CallSOAPService.
- A etapa DownloadFile faz download do arquivo impresso
Savings.pdf
dehttp://localhost:15080/restapi/
configurando o valor da propriedade URL para download de arquivo para o símbolo ${Job.Info.Attr3}. - As etapas OptimizePDF, CountPages, CreatePageRanges e PrintJobs processam e imprimem a tarefa na impressora Amostra.
A etapa WaitForRelatedJobs retém a tarefa pai e cada uma das tarefas filhas até que todas as tarefas filhas alcancem a etapa.
- Na tabela Tarefas, clique com o botão direito na tarefa Jensen Bank Baseball Cap e selecione Conclusão manual.
- Selecione Ir para a próxima etapa e clique em OK.
A tarefa passa para a etapa WaitForRelatedJobs.
Quando as duas tarefas atingem a etapa WaitForRelatedJobs, o fluxo de trabalho envia todas as três tarefas (a tarefa do pedido original, a tarefa não imprimível e a tarefa imprimível) para a etapa RetainCompletedJobs. O estado de cada tarefa muda para Retido. O estado do pedido muda para Concluído.
A notificação de serviço Web MarcomCloseoutOrder chama o serviço Web em
https://services.printable.com/Trans/1.0/Closeout.asmx
A carga da solicitação inclui esses símbolos RICOH ProcessDirector:
- ${WSNotification.WebService.Credential}
Especifica a credencial estática.
- O ${Job.Marcom.OrderId}
Especifica a ID do pedido.
Se a notificação chamou o serviço Web em vez de executar a simulação, essa mudança ocorre na loja de amostra do site do MarcomCentral. Na caixa de diálogo Exibir por Item do Gerenciador de Pedidos, o valor da coluna Status do Pedido de cada item no número de pedido WS113 poderia mudar de Trabalho em Andamento para Enviado.
- ${WSNotification.WebService.Credential}
- Na tabela de tarefas, clique com o botão direito do mouse na tarefa Panfleto e selecione Exibir.O visualizador mostra o arquivo PDF que foi impresso como parte do pedido.
Agora que você executou as amostras, pode copiá-las. Ajuste os valores nas cópias para trocar dados com sua própria loja no site do MarcomCentral. Consulte os tópicos relevantes.