Attivare i flussi di lavoro di esempio per elaborare ordini recuperati da MarcomCentral

I flussi di lavoro MarcomProcessOrders e MarcomProcessJobTicket mostrano come elaborare gli ordini recuperati da un archivio di esempio sul sito Web MarcomCentral. L'archivio di esempio funge da ambiente di test per l'interfaccia dei servizi Web RICOH ProcessDirector con MarcomCentral. Un dispositivo di input di un servizio Web SOAP, un'operazione CallSOAPService e una notifica del servizio Web SOAP comunicano con il sito Web MarcomCentral. I flussi di lavoro includono inoltre esempi relativi a queste operazioni: ApplyXSLTransform, CreateOrdersFromFile e DownloadFile

Il dispositivo di input di esempio, l'operazione CallSOAPService e la notifica eseguono una simulazione. Non chiamano i servizi Web MarcomCentral specificati. La simulazione consente di eseguire gli esempi senza dover inserire le proprie credenziali MarcomCentral e senza dover impostare un archivio di esempio MarcomCentral che assomigli all'archivio di esempio. Gli esempi utilizzano i paylod richiesta SOAP 1.1 per recuperare un ordine MarcomCentral simulato e due ticket di lavoro. Il valore nei campi credenziali statiche e password indica a RICOH ProcessDirector di eseguire la simulazione.

Dopo aver eseguito gli esempi, è possibile copiarli. È quindi possibile regolare i valori nelle copie per scambiare dati con il proprio archivio sul sito Web MarcomCentral.

    Nota:
  • Gli oggetti e i file di esempio sono installati con la funzione MarcomCentral Connect.

La simulazione include oggetti di richiesta SOAP Web Service Description Language (WSDL) importati da MarcomCentral. Il dispositivo di input di esempio, le procedure CallSOAPService e la notifica specificano ognuno una richiesta SOAP.

La simulazione utilizza questi oggetti e file:

  • Flussi di lavoro:
    • MarcomProcessOrders
    • MarcomProcessJobTicket
  • Mappatura delle proprietà ordine: MarconOrderSample
  • Dispositivo di input: MarcomReceiveOrders

    Il dispositivo di input recupera gli ordini XML dal sito Web MarcomCentral simulando una chiamata al servizio Web su https://services.printable.com/Trans/1.0/Order.asmx

    La richiesta SOAP è Marcom-GetOrdersByDate.

  • Notifica: MarcomCloseoutOrder

    La notifica invia le informazioni di completamento dell'ordine al sito Web MarcomCentral simulando una chiamata ad un servizio Web su https://services.printable.com/Trans/1.0/Closeout.asmx

    La richiesta SOAP è EsempioMarcom-CloseoutByOrder.

  • Ordini XML

    Nella simulazione, un ordine viene recuperato ogni 30 secondi dal servizio Web.

    Dopo aver eseguito i flussi di lavoro di esempio, è possibile vedere i contenuti di un ordine di esempio. Andare a: /aiw/aiw1/spool/default/job_number

    Sostituire lavoro_numero con il numero del lavoro, ad esempio, 10000001.

    Visualizzare i contenuti del file lavoro_numero.print.xml, ad esempio, 10000001.print.xml.

  • Ticket di lavoro XML

    Nella simulazione, vengono recuperati due ticket di lavoro per ogni ordine.

    Dopo aver eseguito i flussi di lavoro di esempio, è possibile vedere i contenuti dei due ticket di lavoro di esempio. Andare a: /aiw/aiw1/spool/default/child_job_number

    Sostituire lavoro_secondario_numero con il numero del lavoro secondario, ad esempio, 10000001.1 o 10000001.2.

    Visualizzare i contenuti del file lavoro_secondario_numero.print.xml, ad esempio 10000001.1.print.xml o 10000001.2.print.xml.

  • File di stampa: Savings.pdf

    Questo file viene scaricato localmente da http://localhost:15080/restapi/

  • File del foglio di stile XSLT: downloadOverrides.xslt

    Il file si trova nella directory Marcom: /aiw/aiw1/testfiles/Marcom

  • Operazione CallSOAPService:
    • L'operazione CallSOAPService recupera un ticket di lavoro dal sito Web MarcomCentral simulando una chiamata ad un servizio Web su https://services.printable.com/Trans/1.0/JobTicket.asmx

      La richiesta SOAP è Marcom-GetJobTicketByLineItem.

Per eseguire il flusso di lavoro di esempio:

  1. Fare clic sulla scheda Principale.
  2. Nel portlet Stampanti, fare clic con il tasto destro del mouse sulla stampante Esempio e selezionare Abilita.
  3. Nel portlet del Dispositivo di input, fare clic con il tasto destro del mouse sul dispositivo di input del servizio Web SOAP MarcomReceiveOrders e selezionare Abilita e Connetti.

    Un lavoro chiamato Ordine di esempio Marcom viene visualizzato nella tabella lavori.

  4. Fare clic con il pulsante destro del mouse sul dispositivo di input MarcomReceiveOrders e selezionare Disattiva e disconnetti.
      Nota:
    • Il dispositivo di input di esempio esegue un polling per gli ordini ogni 30 secondi e recupera un lavoro XML. Se il dispositivo di input non viene disabilitato e disconnesso, nella tabella lavori compare un nuovo lavoro ogni 30 secondi.

    Il payload richiesta per il dispositivo di input include questi simboli RICOH ProcessDirector:

    • ${WebService.StaticCredential}

      Specifica la credenziale statica

    • ${WebService.LastSuccessRequestTime}

      Specifica l'ultima data e ora in cui il dispositivo di input ha richiesto con successo una risposta dal servizio Web.

    • ${WebService.CurrentRequestTime}

      Specifica la data e l'ora della richiesta corrente.

    Ogni volta che il dispositivo di input MarcomReceiveOrders recupera un lavoro XML, lo stesso invia il lavoro al flusso di lavoro MarcomProcessOrders.

    Il lavoro passa per queste ed altre procedure nel flusso di lavoro MarcomProcessOrders:

    • L'operazione SetJobPropsFromTextFile imposta la proprietà Nome lavoro con Marcom Sample Order.
    • L'operazione CreateOrdersFromFile utilizza l'oggetto di mappatura proprietà MarcomOrderSample per identificare gli ordini e i lavori, quindi associa i valori di alcuni elementi XML nel file degli ordini XML alle proprietà degli ordini e dei lavori.
    • La tabella elenca le proprietà impostate.

      Elemento XML Nome database Nome interfaccia utente
      /Order/OrderNumber Order.Name Nome dell'ordine
      /Order/ID Order.Reference Riferimento ordine esterno
      /Order/OrderDetails/OrderDetail/User/Name Order.Customer Nome cliente
      /Order/OrderDetails/OrderDetail/SKUDescription Order.Description Descrizione
      /Order/OrderDetails/OrderDetail/Quantity Job.Copies Copie di lavoro richieste
      /Order/OrderDetails/OrderDetail/OrderNumber Job.Marcom.OrderNumber Numero Ordine MarcomCentral
      /Order/ID Job.Marcom.OrderId ID Ordine MarcomCentral
      /Order/OrderDetails/OrderDetail/ID Job.Marcom.JobTicketId Ticket di lavoro MarcomCentral
      /Order/OrderDetails/OrderDetail/ProductType Job.Marcom.ProductType Tipo prodotto MarcomCentral
      /Order/OrderDetails/OrderDetail/ProductName Job.Name Nome lavoro

      L'operazione identifica un ordine con due lavori. Crea due lavori, Jensen Bank Baseball Cap e Brochure, e li invia al flusso di lavoro MarcomProcessJobTicket.

      Il lavoro originale viene inviato alla procedura WaitForRelatedJobs.

    I lavori iniziano l'elaborazione nel flusso di lavoro MarcomProcessJobTicket. Quando il lavoro lascia l'operazione SetJobPropsFromTextFile, la regola sul connettore [1] Magazzino controlla il valore della proprietà Tipo prodotto MarcomCentral. Versionato, Variabile e JobDirect sono tipi di prodotto per elementi stampabili.

    • Se l'elemento non ha un tipo di prodotto stampabile, il flusso di lavoro invia il lavoro mediante la sezione Magazzino.
    • Se l'elemento ha un tipo di prodotto stampabile, il flusso di lavoro invia il lavoro mediante la sezione Stampabile.

    I lavori non stampabili passano dall'operazione ManualStepWithAutoStart nella sezione Magazzino del flusso di lavoro. I lavori attendono in questa operazione finché il personale del magazzino non indica che i lavori sono pronti per la spedizione.

    I lavori stampabili passano da queste procedure e connettori nella sezione Stampabile del flusso di lavoro:

    • Quando il lavoro arriva alla seconda procedura ContinueToNextStep, la regola sul connettore [1] File pronto controlla se la proprietà Personalizzazione 3 (URL di scaricamento del file) è impostata con un valore.
      • In tal caso, il file di stampa è pronto per essere scaricato. Il flusso di lavoro invia il lavoro direttamente alla procedura DownloadFile.
      • In caso contrario, la regola sul connettore [2] Cerca file controlla se il valore della proprietà di lavoro Intero personalizzato 1 è inferiore a 10. La prima volta che il lavoro arriva alla seconda operazione ContinueToNextStep, il valore della proprietà Intero personalizzato 1 è pari a 0.
        • Se il valore è da 0 a 9, il flusso di lavoro invia il lavoro alla procedura Attendi, che attende per 30 secondi. Il flusso di lavoro trasmette quindi il lavoro alla procedura CallSOAPService.

          La procedura CallSOAPService chiama servizio Web MarcomCentral, che recupera un ticket di lavoro per un elemento stampabile. L'operazione specifica due simboli RICOH ProcessDirector come parte del valore nella proprietà Payload richiesta:

          • ${Job.WebService.Password}

            Specifica la credenziale statica.

          • ${Job.Marcom.JobTicketId}

            Specifica l'ID del job ticket.

          La procedura ApplyXSLTransform2 utilizza il foglio di stile XSLT downloadOverrides.xslt per convertire un elemento XML in una proprietà di lavoro RICOH ProcessDirector:

          Elemento XML Nome database della proprietà di lavoro Nome della proprietà di lavoro visualizzato nell'interfaccia utente
          TicketDiLavoro/URLFileRisultatoFinale/URL Job.Info.Attr3 Personalizzato 3

          La procedura inserisce il valore in un file di sovrascrittura e lo sovrascrive nella directory spool per il lavoro con il nuovo file di sovrascrittura.

          Questo esempio mostra il contenuto del file di sovrascrittura di esempio:

          Job.Info.Attr3=http://localhost:15080/restapi/Savings.pdf

          L'operazione AssignJobValues incrementa di 1 il valore della proprietà Intero personalizzato 1. Il flusso di lavoro ritrasmette quindi il lavoro alla seconda procedura ContinueToNextStep, che invia a sua volta il lavoro mediante procedura Attendi alla procedura CallSOAPService. La procedura CallSOAPService ripete la chiamata al servizio Web MarcomCentral, che recupera un ticket di lavoro per un elemento stampabile. Se la proprietà Personalizzazione 3 non dispone ancora di un valore per l'URL, il flusso di lavoro invia il lavoro mediante procedura CallSOAPService fino a 9 volte.

        • Se il valore è pari a 10, il lavoro è stato inviato all'operazione CallSOAPService 10 volte. Dopo 5 minuti, la proprietà Personalizzazione 3 non dispone ancora di un valore per il file da scaricare. Il lavoro non soddisfa la regola sul connettore [2] Cerca file. Il flusso di lavoro invia il lavoro mediante il connettore [3] Timeout alla procedura FailWithMessage e scrive un messaggio di insuccesso al log del lavoro. Il messaggio precisa: File was not available to download in the time allowed.

            Nota:
          • Dato che è una proprietà di lavoro, il messaggio viene visualizzato sulla scheda Informazioni del notebook della proprietà di lavoro per tutti i lavori che passano attraverso il flusso di lavoro. Il messaggio compare sul log di lavoro solo quando il flusso di lavoro invia il lavoro mediante connettore [3] Timeout alla procedura FailWithMessage.

    • La procedura DownloadFile scarica il file di stampa Savings.pdf da http://localhost:15080/restapi/ impostando il valore della proprietà URL per scaricare file con il simbolo ${Job.Info.Attr3}.
    • Le procedure OptimizePDF, CountPages, CreatePageRanges e PrintJobs elaborano e stampano il lavoro sulla stampante Esempio.

    La procedura WaitForRelatedJobs tiene in sospeso il lavoro principale e ciascuno dei lavori secondari fino a quando tutti i lavori secondari non arrivano alla procedura.

  5. Nella tabella lavori, fare clic con il pulsante destro del mouse sul lavoro Jensen Bank Baseball Ca e selezionare Completa manualmente.
  6. Selezionare Passa all'operazione successiva e fare clic su OK.

    Il lavoro passa all'operazione WaitForRelatedJobs.

    Quando entrambi i lavori raggiungono l'operazione WaitForRelatedJobs, il flusso di lavoro invia tutti e tre i lavori (l'ordine originale, il lavoro non stampabile e il lavoro stampabile) all'operazione RetainCompletedJobs. Lo stato di ciascun lavoro cambia in Conservato. Lo stato dell'ordine cambia in Completato.

    La notifica del servizio Web MarcomCloseoutOrder chiama il servizio Web su https://services.printable.com/Trans/1.0/Closeout.asmx

    Il payload richiesta include questi simboli RICOH ProcessDirector:

    • ${WSNotification.WebService.Credential}

      Specifica la credenziale statica.

    • ${Job.Marcom.OrderId}

      Specifica l'ID dell'ordine.

    Se la notifica ha chiamato il servizio Web invece di eseguire la simulazione, questa modifica avviene nell'archivio di esempio sul sito Web MarcomCentral. Nella finestra di dialogo Visualizza per Elemento nella Gestione Ordini, il valore nella colonna Stato ordine per ciascun elemento nel numero ordine WS113 cambia da Operazione in Corso a Spedito.

  7. Nella tabella lavori, fare clic con il tasto destro del mouse sul lavoro Brochure e selezionare Visualizza.
    Nel visualizzatore viene visualizzato il file PDF stampato come parte dell'ordine.
Per eseguire nuovamente i flussi di lavoro di esempio, abilitare e connettere il dispositivo di input MarcomReceiveOrders. Quindi disabilitarlo e disconnetterlo.

Dopo aver eseguito gli esempi, è possibile copiarli. Regolare i valori nelle copie per scambiare dati con il proprio archivio sul sito Web MarcomCentral. Vedere gli argomenti correlati.