Attivare i flussi di lavoro di esempio per elaborare ordini recuperati da MarcomCentral
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.
- L'operazione CallSOAPService recupera un ticket di lavoro dal sito Web MarcomCentral simulando una chiamata ad
un servizio Web su
Per eseguire il flusso di lavoro di esempio:
- Fare clic sulla scheda Principale.
- Nel portlet Stampanti, fare clic con il tasto destro del mouse sulla stampante Esempio e selezionare Abilita.
- 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.
- 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.
- ${Job.WebService.Password}
- 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.
- 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 DownloadFile scarica il file di stampa
Savings.pdf
dahttp://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.
- Nella tabella lavori, fare clic con il pulsante destro del mouse sul lavoro Jensen Bank Baseball Ca e selezionare Completa manualmente.
- 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.
- ${WSNotification.WebService.Credential}
- 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.
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.