Muster-Steuerdateischablonen für externe Programme

RICOH ProcessDirector stellt Muster-Steuerdateischablonen für die Verwendung mit externen Programmen im Verzeichnis /aiw/aiw1/samples/external_programs/ bereit.

Die Steuerdatei für externe Programme, die RICOH ProcessDirector aus der Steuerdateischablone generiert, übergibt Informationen zwischen RICOH ProcessDirector und dem externen Programm. Berechtigte Benutzer können die von RICOH ProcessDirector bereitgestellten Muster-Steuerdateischablonen kopieren und ändern. Sie stellen die angepasste Steuerdateischablone dann in ein beliebiges Verzeichnis, auf das RICOH ProcessDirector zugreifen kann. Verwenden Sie das Druckermerkmal Externe Steuerdateischablone, um den Namen und die Position der Steuerdateischablone anzugeben.

    Hinweis:
  • Updates können Dateien im Verzeichnis /aiw/aiw1/samples überschreiben, aber sie überschreiben keine Dateien im Verzeichnis /aiw/aiw1/control_files. Es wird empfohlen, Musterdateien in das Verzeichnis /aiw/aiw1/control_files zu kopieren und alle Änderungen in der kopierten Datei vorzunehmen.

RICOH ProcessDirector stellt die folgenden Steuerdateischablonen für externe Programme bereit:

job_info.cfg
Diese Steuerdatei wird vom Probe-PDF-Workflow verwendet. Die Steuerdatei verfügt über eine Symbolliste für neun Jobmerkmale. Wenn RICOH ProcessDirector eine Steuerdatei aus dieser Vorlage erstellt, löst es die Werte der Symbole ${Job.ID}, ${Job.Name}, ${Job.JobType}, ${Job.SubmitTime}, ${Job.RequestedPrinter}, ${Job.InputFile.Size}, ${Job.JobSize}, ${Job.TotalPages} und ${Job.TotalSheets} in die tatsächlichen RICOH ProcessDirector-Jobmerkmale auf.

Die Funktion "AFP-Unterstützung" stellt folgende zusätzliche Steuerdatei-Vorlagen für externe Programme bereit:

prepare_line2afp.cfg
Die Steuerdateischablone benutzt RICOH ProcessDirector-Symbolformeln, um Parameterwerte für den Befehl line2afp festzulegen. RICOH ProcessDirector verwendet diesen Befehl zum Umwandeln von Zeilendatenjobs in das AFP-Format. Nachfolgend werden Beispiele von Einträgen in der Steuerdateischablone gezeigt:
DUPLEX=${Job.Duplex}
FILEFORMAT=${Job.Line2AFP.FILEFORMAT}
FORMDEF=${Job.Line2AFP.FORMDEF}
MCF2REF=${Job.Line2AFP.MCF2REF}
PAGEDEF=${Job.Line2AFP.PAGEDEF}

Die Schlüsselwörter links von dem Gleichheitszeichen sind IBMAFP Conversion und ACIF-Parameter (ACIF = AFP Conversion and Indexing Facility). Die Werte rechts sind Symbolformeln für RICOH ProcessDirector-Jobmerkmale. In dem Beispiel FILEFORMAT=${Job.Line2AFP.FILEFORMAT} setzt RICOH ProcessDirector den Wert des Parameters FILEFORMAT, den der Befehl line2afp nutzt, auf den Wert des Jobmerkmals Zeilendatendateiformat.

Die Steuerdateischablone benutzt zudem die RICOH ProcessDirector-Methode getFileName, um die Namen der Dateien im Spoolverzeichnis für den Job zurückzugeben, die das Datenumsetzungsprogramm lesen oder in die das Datenumsetzungsprogramm schreiben muss. Das Spoolverzeichnis für einen Job ist /aiw/aiw1/spool/default/JobNumber, wobei Jobnummer die Spool-ID ist, die RICOH ProcessDirector dem Job zuordnet. Berechtigte Benutzer können zudem zusätzliche Spoolverzeichnisse erstellen. Die Namen zusätzlicher Spoolverzeichnisse weisen das folgende Format auf: /aiw/aiw1/spool/SpoolName/ JobNumber. Die folgenden Einträge in der Steuerdateischablone benutzen Methoden:

INPUTDD=${getFileName(print, (linedata, afp), read)}
Stellt dem Datenumsetzungsprogramm den Namen der Datendatei für den Job bereit. Die Methode gibt den Namen der Zeilendaten-Spooldatei (JobNumber.print.linedata) zurück, wenn sie vorhanden ist. Ist die Datei nicht vorhanden, gibt die Methode den Namen der AFP-Spooldatei (JobNumber.print.afp) zurück, wenn sie vorhanden ist. Ist keine der Dateien vorhanden, gibt die Methode Jobnummer.print.unknown zurück. Das Datenumsetzungsprogramm liest diese Datei und benutzt sie als Anfangseingabe.
OUTPUTDD=${getFileName(print, afp, write)}
Stellt den Namen der umgesetzten Datei bereit, die das Datenumsetzungsprogramm in das Spoolverzeichnis schreiben muss. Das Format dieses Dateinamens ist Jobnummer.print.afp. Diese Datei enthält die Ausgabe des Datenumsetzungsprogramms.
RESOBJDD=${getFileName(resources, afp, write)}
Stellt den Namen der Ressourcendatei bereit, die das Datenumsetzungsprogramm in das Spoolverzeichnis schreiben muss. Das Format dieses Dateinamens ist Jobnummer.resources.afp. Diese Datei enthält optionale Ausgabe des Datenumsetzungsprogramms.
prepare_line2afp_ascii.cfg
Diese Steuerdateischablone führt dieselben Funktionen wie die Steuerdateischablone prepare_line2afp.cfg aus, nur gibt es eine Ausnahme. Diese Steuerdateischablone ruft das Eingabe-Exit-Programm apka2e auf, das den Job aus dem ASCII-Format in das EBCDIC-Format umsetzt. Detaillierte Informationen zum Parameter INPEXIT finden Sie im AFP Conversion and Indexing Facility User's Guide, G550-1342.
prepare_transform.cfg und prepare_transform_APPE.cfg
Diese Schablonen übergeben Informationen zwischen RICOH ProcessDirector und einem RICOH ProcessDirector-Transform Feature oder InfoPrint Umwandlungsmanager. Sie benutzen Symbolformeln, um Werte für die Umwandlungsparameter und -methodenaufrufe zum Lesen aus und Schreiben in Dateien im Spoolverzeichnis festzulegen. Im Folgenden sehen Sie Beispiele von Einträgen in den Steuerdateien prepare_transform.cfg und prepare_transform_APPE.cfg:
# Input file to transform
-itm_in_files = ${getITMInputFileName()}
# Output file to create
-itm_out_files = ${getFileName(print, ${Job.Transform.Datastream}, write)}
# Page size
-w = ${truncate(3, ${Job.PageWidth})}i
-l = ${truncate(3, ${Job.PageLength})}i
# Halftone
-gcorr = ${get.HalftoneFileNameTf()}
-thresh = ${get.HalftoneFileNameTa()}

Informationen zu Umwandlungsparametern finden Sie sind im RICOH ProcessDirector-Information Center zur Funktion "Transform" oder in InfoPrint Umwandlungsmanager für Linux und Windows: Planung und Installation, G550-20160.