Execução da amostra de fluxos de trabalho para processar pedidos recuperados do MarcomCentral

Os fluxos de trabalho MarcomProcessOrders e MarcomProcessJobTicket mostram como processar pedidos recuperados de uma amostra de loja no site do MarcomCentral. A amostra de loja serve como um ambiente de teste para os serviços Web RICOH ProcessDirector interagirem com o MarcomCentral. Um dispositivo de entrada de serviço Web SOAP, uma etapa CallSOAPService e uma notificação de serviço Web SOAP se comunicam com o site do MarcomCentral. Os fluxos de trabalho também incluem exemplos dessas etapas: ApplyXSLTransform, CreateOrdersFromFile e DownloadFile

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.

Para executar o fluxo de trabalho de amostra:

  1. Clique na guia Principal.
  2. No portlet de Impressoras, clique com o botão direito na impressora Sample e selecione Enable.
  3. 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.

  4. 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.

        • 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.

    • A etapa DownloadFile faz download do arquivo impresso Savings.pdf de http://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.

  5. Na tabela Tarefas, clique com o botão direito na tarefa Jensen Bank Baseball Cap e selecione Conclusão manual.
  6. 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.

  7. 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.
Para executar novamente as amostras de fluxos de trabalho, ative e conecte o dispositivo de entrada MarcomReceiveOrders. Em seguida, desative e desconecte-o.

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.