File di proprietà del documento

RICOH ProcessDirector utilizza le informazioni provenienti dal file di proprietà del documento in questi processi:

  • Procedure per ordinare, raggruppare e suddividere i documenti. Ad esempio, se si desidera utilizzare un'operazione per ordinare i documenti in base al codice postale, occorre che la proprietà Doc.Custom.ZipCode sia definita nel file di proprietà del documento.
  • Programmi esterni che elaborano proprietà del documento.
  • Operazioni che elaborano i file delle proprietà dei documenti da utilizzare con il software postale. La funzione Postal Enablement offre le seguenti operazioni: BuildExternalDocPropsFle, MapExternalResultsFileToDocProps e UpdateDocPropsFromExtResultsFile. Per eseguire queste operazioni, è necessario che nel file di proprietà del documento sia inclusa la proprietà Doc.ID o Doc.SequenceInChild.
  • Operazioni che elaborano i file delle proprietà dei documenti da utilizzare con valori di file esterni. Tutte le funzioni di elaborazione dei documenti offrono le operazioni SetDocPropsFromList e EmailDocuments. La funzione Gestione preferenza offre l'operazione ApplyPreferences.
  • Operazione di elaborazione di documenti AFP, basate ad esempio sui modelli CreateAFPJobsFromDocuments e BuildAFPFromDocuments. Per l'esecuzione corretta delle operazioni CreateAFPJobsFromDocuments o BuildAFPFromDocuments, occorre includere tali proprietà nel file di proprietà del documento:
    • Doc.OriginalJobID
    • Doc.ChildJobId
    • Doc.SequenceInChild
    • Doc.OriginalSequence
    • Doc.OriginalSheets
    • Doc.DataOffset
    • Doc.DataLen
  • Operazioni di elaborazione di documenti PDF, basate ad esempio sul modello BuildPDFFromDocuments. Per eseguire le operazioni BuildPDFFromDocuments, è necessario che nel file di proprietà del documento siano incluse le seguenti proprietà:
    • Doc.OriginalJobID
    • Doc.ChildJobId
    • Doc.SequenceInChild
    • Doc.OriginalSequence
    • Doc.OriginalSheets

La prima riga nel file di proprietà del documento contiene le informazioni provenienti dal file di modello delle proprietà del documento. Ogni riga aggiuntiva contiene valori per ogni proprietà proveniente da un documento.

Queste operazioni creano automaticamente il file di proprietà del documento:

  • Un'operazione basata sul modello di operazione IdentifyDocuments crea un file di proprietà del documento utilizzando File di controllo Visual Workbench come guida.
  • Un'operazione basata sul modello di operazione IdentifyPDFDocuments crea un file di proprietà del documento utilizzando il file di controllo Plug-in ProcessDirector di RICOH per Adobe Acrobat come guida.
  • Un'operazione basata sul modello di operazione ReadDocumentsFromDatabase crea il file di proprietà del documento mediante un file modello delle proprietà del documento come guida.
  • Un'operazione basata sul modello di operazione CreateJobsFromDocuments o CreatePDFJobsFromDocuments crea un file di proprietà del documento per i lavori secondari utilizzando come guida il file di proprietà del documento del lavoro principale (corrente).

Queste operazioni sono in grado di gestire i file di proprietà del documento:

  • GroupDocuments
  • SortDocuments
  • SplitDocuments
  • SetDocPropsFromList
  • ApplyPreferences (solo Gestione preferenza)
  • UpdateDocPropsFromExtResultsFile (solo Postal Enablement)
È anche possibile utilizzare il file di proprietà del documento da un programma esterno o da una nuova operazione personalizzata creata.

Un file di proprietà del documento contiene sempre le proprietà Doc.ChildJobId e Doc.SequenceInChild. Se si verifica un'operazione che crea gruppi di documenti (ad esempio GroupDocuments), il file di proprietà del documento contiene più di un valore per Doc.ChildJobId.

RICOH ProcessDirector fornisce i metodi, tra cui getFileName e getAbsoluteFileName, che consentono di accedere ai programmi esterni per leggere e scrivere sui file di spool nella directory di spool del lavoro. Per ulteriori informazioni, consultare Utilizzo di metodi RICOH ProcessDirector come getFileName.

Il file di proprietà del documento è memorizzato nella directory di spool del lavoro. Quando l'operazione IdentifyDocuments o IdentifyPDFDocuments crea il file, il nome del file ha il seguente formato: jobid.original.dpf (ad esempio, 10000009.original.dpf). Quando viene eseguita, l'operazione WriteDocumentsToDatabase copia il file e aggiunge altre proprietà, tra cui Doc.ID. Il nuovo file viene salvato con un nome nel seguente formato: jobid.document.dpf (ad esempio, 10000009.document.dpf). I valori sono in formato UTF-8 e separati da caratteri di tabulazione.

Alcune informazioni presenti nel file di proprietà del documento non vengono memorizzate nel database ma vengono utilizzate soltanto durante l'elaborazione delle operazioni. Ad esempio, tali informazioni si trovano nel file di proprietà del documento ma non nel database:

Doc.DataOffset
L'offset dei dati di stampa per il documento nel file di stampa AFP del lavoro originale.
Doc.DataLen
La lunghezza dei dati di stampa per il documento nel file di stampa AFP del lavoro originale.

Argomento collegato: Riferimento