Scenario d'uso di applicazione del markup del documento in base a un file delle preferenze

In questo scenario un'azienda modifica il proprio processo di stampa PDF per aggiungere un'offerta di marketing sui rendiconti dei clienti in un file PDF prima della stampa di tali rendiconti. È possibile aggiungere una di due diverse offerte di marketing. La scelta per ciascun rendiconto si basa sul livello di bonus che un cliente ha raggiunto. Poiché tale livello di bonus non rientra nei dati sul rendiconto, l'azienda lo estrapola dal proprio database clienti in un file testuale che contiene le intestazioni ed è usato come file delle preferenze. I valori nel file determinano l'offerta applicata a ciascun rendiconto.

Il file delle preferenze contiene il numero di conto e il livello di bonus del cliente. I clienti che hanno raggiunto il livello Platinum ricevono una determinata offerta, mentre per quelli con livello Gold ne sono riservate altre. I clienti che non hanno raggiunto alcun livello di bonus non ricevono nessuna offerta.

Prima di modificare i processi, l'azienda stampa tutti i rendiconti usando il flusso di lavoro EnhancePDFDocuments fornito. Il valore della proprietà File di controllo Identifica PDF sull'operazione IdentifyPDFDocuments è /aiw/aiw1/control_files/EnhancePDFdocs.ctl. Il valore della proprietà File di controllo Crea PDF 1 sull'operazione BuildPDFFromDocuments è anche /aiw/aiw1/control_files/EnhancePDFdocs.ctl.

L'azienda usa il dispositivo di input HotFolderPDF fornito con la proprietà Flusso di lavoro secondario impostata su EnhancePDFDocuments.

L'azienda inoltre usa Plug-in ProcessDirector di RICOH per Adobe Acrobat per individuare i rendiconti come singoli documenti nel file PDF di produzione per ciascun lavoro. I dati in ciascun rendiconto includono il numero di conto.

Per supportare il nuovo processo, l'amministratore:

Configura le proprietà personalizzate del documento e aggiunge il markup per le offerte.
Crea un oggetto di mappatura proprietà.
Mette a disposizione il file delle preferenze su RICOH ProcessDirector.
Aggiunge l'operazione ApplyPreferences sul flusso di lavoro EnhancePDFDocuments.

Configurazione delle proprietà personalizzate del documento e aggiunta del markup

Per impostare le proprietà personalizzate del documento e aggiungere il markup, l'amministratore:

Definisce due proprietà personalizzate del documento (con didascalie che specificano i nomi dell'interfaccia utente) nel file docCustomDefinitions.xml:
- Doc.Custom.AccountNumber, con Numero di conto per didascalia
- Doc.Custom.AwardLevel con Livello bonus per didascalia
Esegue l'utilità docCustom e installa o aggiorna la funzione Proprietà documento personalizzato.
Carica le proprietà aggiornate del documento di RICOH ProcessDirector su Plug-in ProcessDirector di RICOH per Adobe Acrobat.
Usa la funzione Definisci proprietà documento nel plug-in per associare i dati del numero di conto nei documenti sulla proprietà del documento Numero di conto (nome del database Doc.Custom.AccountNumber).
Durante l'elaborazione, l'operazione IdentifyPDFDocuments nel flusso di lavoro estrae i dati per la proprietà del documento Numero di conto da ciascun documento nel file PDF per il processo.
- La funzione Definisci proprietà documento non può essere usata per associare i dati sulla proprietà del documento Livello bonus (nome del database Doc.Custom.AwardLevel), perché i documenti non presentano tali dati. Durante l'elaborazione, l'operazione ApplyPreferences nel flusso di lavoro usa il file delle preferenze per inserire i valori della proprietà.
Usa la funzione Gestisci regole nel plug-in per definire due regole:
- La regola Award_level_platinum presenta le seguenti condizioni: Doc.Custom.AwardLevel = Platinum
- La regola Award_level_gold presenta le seguenti condizioni: Doc.Custom.AwardLevel = Gold
Usa la funzione Aggiungi immagine nel plug-in per definire due immagini:
- La prima immagine viene posizionata sui documenti che soddisfano le condizioni nella regola Award_level_platinum.
- La seconda immagine viene posizionata sui documenti che soddisfano le condizioni nella regola Award_level_gold.
Usa la funzione Salva file di controllo nel plug-in per salvare la definizione della proprietà del documento nel file di controllo e il markup per le due immagini del file di controllo EnhancePDFdocs.ctl.
Invia il file di controllo sul server RICOH ProcessDirector.

Creazione di un oggetto di mappatura proprietà

L'amministratore crea un oggetto di mappatura proprietà CustomerPreferences con questi valori:

Sulla sezione Generale, il valore di Tipo di file è CSV.

Nella sezione Mappatura proprietà, i valori sono:

Intestazione	Proprietà del documento	Utilizzo
Numero conto	Numero conto	Identifica documento
Bonus	Livello bonus	Aggiorna proprietà

Disponibilità del file delle preferenze su RICOH ProcessDirector

Per mettere a disposizione un file delle preferenze su RICOH ProcessDirector, l'amministratore:

Crea una directory /aiw/aiw1/preferences per i file di preferenze.
Chiede al dipartimento che fornisce il file delle preferenze di nominarlo EnhancePDFprefs.csv e scriverlo sulla directory /aiw/aiw1/preferences.
Si assicura che il file delle preferenze sia pronto per elaborazione da parte di RICOH ProcessDirector:
- Il file deve essere in formato CSV (Comma Separated Values) o delimitato da tabulazioni.
  Le colonne di dati devono presentare le intestazioni specificate nell'oggetto di mappatura proprietà: Numero conto e Bonus.
Questo esempio mostra una porzione del file:
```
Account Number,Awards
2000144372,Gold
2001144678,None
2001154898,Platinum
2004187456,None
2007192007,None
2010197554,Gold
2010223114,Gold
2012234096,Platinum
2231547625,None
```

Modifica del flusso di lavoro

Per modificare il flusso di lavoro EnhancePDFDocuments usato dall'azienda per stampare i rendiconti, l'amministratore aggiunge un'operazione ApplyPreferences dopo IdentifyPDFDocuments e imposta i valori per le proprietà operative:

Il valore del File delle preferenze è /aiw/aiw1/preferences/EnhancePDFprefs.csv.
Il valore di Mappatura proprietà è CustomerPreferences.

Elaborazione dei processi attraverso il flusso di lavoro

Una volta configurato e testato il flusso di lavoro, l'amministratore mette in produzione il flusso di lavoro.

Il dispositivo di input HotFolderPDF fornito riceve un processo PDF con documenti di rendiconto e inoltra tutto al flusso di lavoro EnhancePDFDocuments.

Il lavoro passa all'operazione IdentifyPDFDocuments. RICOH ProcessDirector identifica i documenti nel file PDF e determina il valore della proprietà Doc.Custom.AccountNumber per ciascun documento. RICOH ProcessDirector scrive i valori della proprietà sul file delle proprietà del documento per quel lavoro.

Il lavoro passa all'operazione ApplyPreferences. RICOH ProcessDirector legge le informazioni nel file EnhancePDFprefs.csv e crea una colonna di dati nel file delle proprietà del documento. Questa colonna contiene i valori per la proprietà Doc.Custom.AwardLevel.

Il lavoro passa all'operazione BuildPDFFromDocuments. RICOH ProcessDirector applica le immagini ai documenti usando i valori per la proprietà Doc.Custom.AwardLevel nel file delle proprietà del documento.

RICOH ProcessDirector™ per Linux