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

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

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

<PartnerCredentials> <Token>${WebService.StaticCredential}</Token> </PartnerCredentials> <DateRange> <Start>${WebService.LastSuccessRequestTime}</Start> <End>${WebService.CurrentRequestTime}</End> </DateRange>

Il simbolo ${WebService.StaticCredential} specifica le credenziali statiche. Il simbolo ${WebService.LastSuccessRequestTime} specifica l'ultima data e ora in cui il dispositivo di input del servizio Web ha richiesto con successo una risposta da un servizio Web. Il simbolo ${WebService.CurrentRequestTime} specifica la data e l'ora della richiesta corrente.

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

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

• L'operazione SetJobPropsFromTextFile imposta la proprietà Nome lavoro con Marcom Sample Order.
• La procedura ApplicaTrasformazioneXSL utilizza il foglio di stile XSLT orderToOverrides.xslt per convertire 8 elementi XML in 5 proprietà di lavoro RICOH ProcessDirector in un file di sovrascrittura.

  La tabella elenca le proprietà di lavoro nell'ordine in cui sono specificate nel foglio di stile XSLT e in cui appaiono nel file di sovrascrittura.

  Elemento XML	Nome database della proprietà di lavoro	Nome della proprietà di lavoro visualizzato nell'interfaccia utente
  OrderNumber	Job.Marcom.OrderNumber	Numero Ordine MarcomCentral
  ID	Job.Marcom.OrderId	ID Ordine MarcomCentral
  ShippingAddress/Address1ShippingAddress/CityShippingAddress/StateShippingAddress/Zip	Job.Info.Attr1	Personalizzato 1
  User/Email	Job.CustomerName	Nome cliente
  count(OrderDetails/OrderDetail)	Job.Info.Attr2	Personalizzato 2

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

  Job.Marcom.OrderNumber=WS113 Job.Marcom.OrderId=8487184 Job.Info.Attr1=400 Main Street Anywhere CO 11111 Job.CustomerName=Myrna.Jensen@company.com Job.Info.Attr2=2

  La procedura posiziona il file di sovrascrittura nella directory di spool per il lavoro. RICOH ProcessDirector utilizza i valori nel file di sovrascrittura per impostare i valori delle proprietà per il lavoro.

• La procedura ChiamataServizioSOAP chiama il servizio Web MarcomCentral, che restituisce i ticket di lavoro per un ordine specifico. La procedura specifica 2 simboli RICOH ProcessDirector come parte del valore nella proprietà Payload richiesta:

  <Token>${Job.WebService.Password}</Token> <PONumber>${Job.Marcom.OrderId}</PONumber>

  Il simbolo ${Job.WebService.Password} specifica le credenziali statiche. Il simbolo ${Job.Marcom.OrderId} specifica l'ID ordine.

• La procedura ApplicaTrasformazioneXSL2 utilizza il foglio di stile XSLT jobTicketsReceived.xslt per calcolare il valore della proprietà Job.Info.Attr3 conteggiando il numero di ticket di lavoro recuperati.

  Elemento XML	Nome database della proprietà di lavoro	Nome della proprietà di lavoro visualizzato nell'interfaccia utente
  calcolo(ns0:Envelope/ns0:Body/ns2:GetJobTicketsByOrderNumberResponse/ns1:GetJobTicketResponse/JobTicket)	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 dopo che tutti i ticket di lavoro sono stati recuperati:

  Job.Info.Attr3=2

• La procedura ControllaCalcoloTicket esegue una chiamata POST ad un servizio Web RICOH ProcessDirector. Il servizio Web controlla che siano stati recuperati tutti i ticket di lavoro per un ordine. La procedura compara i valori di Personalizzazione 2 (ticket di lavoro totali) e Personalizzazione 3 (ticket di lavoro recuperati). Se i valori corrispondono, la procedura imposta il valore di Personalizzazione 4 (risultato della comparazione) con UGUALE.

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

  Questo esempio mostra il contenuto del file di sovrascrittura dopo che tutti i ticket di lavoro sono stati recuperati:

  Job.Info.Attr4=EQUAL

• La regola sul connettore [1] Tutti i ticket trovati controlla se il valore della proprietà di lavoro Personalizzazione 4 (risultato della comparazione) è UGUALE.
  • In tal caso, il numero dei ticket di lavoro recuperati è uguale al numero totale di ticket di lavoro previsti. Il flusso di lavoro invia il lavoro direttamente alla procedura CreaLavoriDaXML.
  • In caso contrario, invece, il numero di ticket di lavori recuperati è inferiore al numero totale di ticket di lavoro previsti. La regola sul connettore [2] Cerca ticket controlla se il valore della proprietà di lavoro Personalizza conteggio 1 è inferiore a 10. La prima volta che il lavoro arriva all'operazione CheckTicketCount, il valore della proprietà Personalizza conteggio 1 è pari a 0.
    • Se il valore è da 0 a 9, il flusso di lavoro invia il lavoro alla procedura Attendi, che attende per 1 minuto. Il flusso di lavoro invia quindi il lavoro alla procedura EseguiProgrammaEsterno.

      La procedura RunExternalProgram attiva un'utilità Java che aumenta il valore della proprietà Calcolo personalizzazione 1 di 1. Il flusso di lavoro ritrasmette quindi il lavoro alla procedura ChiamataServizioSOAP. La procedura ripete la chiamata al servizio Web MarcomCentral che restituisce i ticket di lavoro per l'ordine. Se il numero di ticket di lavoro recuperati è inferiore a quanto previsto, il flusso di lavoro può inviare il lavoro mediante la procedura ChiamataServizioSOAP fino a 9 volte.

    • Se il valore è pari a 10, il lavoro è stato inviato all'operazione CallSOAPService 10 volte. Dopo 10 minuti, il numero di ticket di lavoro recuperati non risulta uguale al numero previsto. Il lavoro non soddisfa la regola sul connettore [2] Cerca ticket. Il flusso di lavoro invia il lavoro mediante il connettore [3] Timeout alla procedura InsuccessoConMessaggio e scrive un messaggio di insuccesso al log del lavoro. Il messaggio precisa: Some job tickets were not found 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 InsuccessoConMessaggio.

• L'operazione CreateJobsFromXML utilizza l'espressione XPath //JobTicket per analizzare le informazioni del ticket di lavoro XML. La procedura rileva 2 ticket di lavoro e crea 2 lavori secondari.

  I lavori secondari nominati Cappelli da baseball Jensen Bank e Brochure vengono visualizzati nella tabella lavori.

  La procedura invia i 2 lavori secondari al flusso di lavoro ElaborazioneTicketDiLavoroMarcom.

  Il lavoro originale viene inviato alla procedura AttendiLavoriCorrelati.

I lavori secondari passano per queste ed altre procedure nel flusso di lavoro ElaborazioneTicketDiLavoroMarcom:

• La procedura ApplicaTrasformazioneXSL utilizza il foglio di stile XSLT jobticketToOverrides.xslt per convertire 10 elementi XML in 10 proprietà di lavoro RICOH ProcessDirector in un file di sovrascrittura.

  La tabella elenca le proprietà di lavoro nell'ordine in cui sono specificate nel foglio di stile XSLT e in cui appaiono nel file di sovrascrittura.

  Elemento XML	Nome database della proprietà di lavoro	Nome della proprietà di lavoro visualizzato nell'interfaccia utente
  OrderDetails/OrderDetail/OrderID	Job.Marcom.OrderId	ID Ordine MarcomCentral
  OrderDetails/OrderDetail/SKUDescription	Job.Info.Attr1	Personalizzato 1
  OrderDetails/OrderDetail/SKU/ID	Job.Info.Attr4	Personalizzato 4
  OrderDetails/OrderDetail/ProductType	Job.Marcom.ProductType	Tipo prodotto MarcomCentral
  FinalOutputFileURL/URL	Job.Info.Attr3	Personalizzato 3
  floor(OrderDetails/OrderDetail/Quantity)	Job.Copies	Copie di lavoro richieste
  floor($var2_current/OrderDetails/OrderDetail/ID)	Job.Marcom.JobTicketId	ID ticket di lavoro MarcomCentral
  OrderDetails/OrderDetail/ProductName	Job.Name	Nome lavoro
  OrderDetails/OrderDetail/ProductDescription	Job.Description	Descrizione lavoro
  OrderDetails/OrderDetail/Shipping/Method	Job.Info.Attr2	Personalizzato 2

  La procedura inserisce ciascun file di sovrascrittura nella directory spool per il lavoro corrispondente. Dato che questi lavori sono in un nuovo flusso di lavoro, i file di sovrascrittura non sovrascrivono i file di sovrascrittura esistenti.

  Questo esempio mostra il contenuto del file di sovrascrittura di esempio per il lavoro Cappelli da baseball Jensen Bank:

  Job.Marcom.OrderId=8487184 Job.Info.Attr1=Red Job.Info.Attr4=13933967 Job.Marcom.ProductType=Static Job.Info.Attr3= Job.Copies=20 Job.Marcom.JobTicketId=22722188 Job.Name=Jensen Bank Baseball Cap Job.Description=Jensen Bank branded baseball cap features an embroidered patch logo on the front. This fitted cap is made of cotton. Fit may vary depending on the construction, materials and manufacturer. Job.Info.Attr2=Rush Shipping

  Questo esempio mostra il contenuto del file di sovrascrittura di esempio per il lavoro Brochure:

  Job.Marcom.OrderId=8487184Job.Info.Attr1=Brochure - Investing_Boulder_6300 Diagonal Highway_Boulder_CO_80301Job.Info.Attr4=15302443Job.Marcom.ProductType=VersionedJob.Info.Attr3=http://localhost:15080/restapi/Savings.pdfJob.Copies=250Job.Marcom.JobTicketId=22722189Job.Name=BrochureJob.Description=Job.Info.Attr2=Rush Shipping

• La regola sul connettore [1] Nessun Dettaglio SKU controlla se il lavoro dispone di un'unità di stoccaggio MarcomCentral (SKU - Stock-Keeping Unit).
  Nota:
  • In questo esempio, una SKU fornisce informazioni relative alla produzione di un elemento in un ordine. Ad esempio, le informazioni SKU per un elemento stampabile includono il supporto da utilizzare. Le informazioni SKU per un elemento non di stampa includono il materiale da imballaggio da utilizzare. Gli elementi MarcomCentral possono avere un numero SKU che identifica le informazioni archiviate all'esterno di MarcomCentral. Questa porzione del flusso di lavoro accede a tali informazioni e le converte in proprietà di lavoro RICOH ProcessDirector.
  • Se il valore della proprietà Personalizzato 4 (ID SKU) non è SKU13933967 o SKU15302443, il flusso di lavoro invia il lavoro direttamente all'operazione ContinueToNextStep.
    Nota:
    • Questi 2 ID SKU corrispondono ai file SKU di esempio nella directory Marcom. Quando si imposta RICOH ProcessDirector per comunicare con MarcomCentral, decidere come si desidera archiviare le informazioni sugli elementi in un ordine.
  • Se il valore è SKU13933967 o SKU15302443, il flusso di lavoro invia il lavoro all'operazione ApplyXSLTransform2 per elaborare le informazioni SKU.

    La procedura ApplicaTrasformazioneXSL2 utilizza il foglio di stile XSLT skuToOverrides.xslt per convertire 3 elementi in 3 proprietà di lavoro RICOH ProcessDirector.

    La tabella elenca le proprietà di lavoro nell'ordine in cui sono specificate nel foglio di stile XSLT e in cui appaiono nel file di sovrascrittura.

    Elemento XML	Nome database della proprietà di lavoro	Nome della proprietà di lavoro visualizzato nell'interfaccia utente
    Supporto	Job.Media	Supporto
    Fronte/retro	Job.Duplex	Fronte/retro
    Package	Job.Info.Attr5	Personalizzato 5

    La procedura inserisce i valori 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 per il lavoro Cappelli da baseball Jensen Bank:

    Job.Media= Job.Duplex=No Job.Info.Attr5=Gift wrap

    Questo esempio mostra il contenuto del file di sovrascrittura di esempio per il lavoro Brochure:

    Job.Media=Letter Plain Job.Duplex=Yes Job.Info.Attr5=

    Il flusso di lavoro invia il lavoro alla procedura ProseguiConOperazioneSuccessiva.

• Quando il lavoro arriva alla procedura ProseguiConOperazioneSuccessiva, la regola sul connettore [1] Magazzino controlla il valore della proprietà Tipo prodotto MarcomCentral. Versionato, Variabile e DirectLavoro 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 Tipografia.

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

• Quando il lavoro arriva alla seconda procedura ProseguiConOperazioneSuccessiva, 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 ScaricaFile.
  • In caso contrario, la regola sul connettore [2] Cerca file controlla se il valore della proprietà di lavoro Personalizza conteggio 1 è inferiore a 10. La prima volta che il lavoro arriva alla seconda procedura ContinueToNextStep, il valore della proprietà Personalizza conteggio 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 ChiamataServizioSOAP.

      La procedura ChiamataServizioSOAP chiama servizio Web MarcomCentral, che recupera un ticket di lavoro per un elemento stampabile. La procedura specifica 2 simboli RICOH ProcessDirector come parte del valore nella proprietà Payload servizio Web:

      <Token>${Job.WebService.Password}</Token> <LineItemID type=”Printable”>${Job.Marcom.JobTicketId}</LineItemID>

      Il simbolo ${Job.WebService.Password} specifica le credenziali statiche. Il simbolo ${Job.Marcom.JobTicketId}specifica l'ID del ticket di lavoro.

      La procedura ApplicaTrasformazioneXSL2 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

      La procedura RunExternalProgram attiva un'utilità Java che aumenta il valore della proprietà Calcolo personalizzazione 1 di 1. Il flusso di lavoro ritrasmette quindi il lavoro alla seconda procedura ProseguiConOperazioneSuccessiva, che invia a sua volta il lavoro mediante procedura Attendi alla procedura ChiamataServizioSOAP. La procedura ChiamataServizioSOAP 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 ChiamataServizioSOAP 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 InsuccessoConMessaggio 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 InsuccessoConMessaggio.

• La procedura ScaricaFile 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 OttimizzaPDF, ContaPagine, CreaIntervalliPagina e StampaLavori elaborano e stampano il lavoro sulla stampante Esempio.

I lavori secondari non stampabili passano da questa procedura nella sezione Magazzino del flusso di lavoro:

• La procedura ProceduraManualeConAvvioAutomatico attende che lo staff addetto al magazzino indichi che il lavoro è pronto per essere spedito.

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

Il lavoro passa all'operazione AttendiLavoriCorrelati.

Quando entrambi i lavori secondari raggiungono la procedura AttendiLavoriCorrelati, il flusso di lavoro invia il lavoro principale e quelli secondari alla procedura ConservaLavoriCompletati. Lo stato di ciascun lavoro cambia in Conservato.

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

Il payload richiesta include questi simboli RICOH ProcessDirector:

<PartnerCredentials> <Token>${WSNotification.WebService.Credential}</Token> </PartnerCredentials> <OrderID> <ID type="Printable">{${Job.Marcom.OrderId}}</Start> </OrderID>

Il simbolo ${WSNotification.WebService.Credential} specifica le credenziali statiche. Il simbolo ${Job.Marcom.OrderId} specifica l'ID 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.