Merkmalbedingungsdatei

Sie können die Merkmalbedingungsdatei verwenden, um Werte für Merkmale mit oder ohne Bedingungen festzulegen. Sie können auch eine getrennte Include-Datei verwenden, um Merkmale im Format Merkmal = Wert zu definieren.

Werte mit Bedingungen festlegen

Die erste Zeile in der Merkmalbedingungsdatei ist eine Kopfzeile (header) in der die Datenbanknamen von Dokument- oder Jobmerkmalen durch Kommas getrennt aufgelistet sind. Normalerweise sind ganz links in der Kopfzeile die Merkmale angegeben, die auf eine oder mehrere Bedingungen geprüft werden sollen. Diese Reihenfolge ist jedoch nicht zwingend.

Auf die Kopfzeile folgen eine oder mehrere Bedingungszeilen, in denen die Bedingungen definiert werden sowie die Merkmalwerte, die festgelegt werden sollen, wenn alle Bedingungen in dieser Zeile zutreffen. Im Grunde stellt jede Bedingungszeile eine If-Then-Anweisung (wenn-dann) dar. Alle in einer Zeile angegebenen Bedingungen müssen zutreffen. Wenn nur eine der Bedingungen in einer Zeile unwahr ist, wird keiner der Werte in der Zeile festgelegt. Die Werte in den Bedingungszeilen werden durch Kommas voneinander getrennt.

Dieses Beispiel zeigt die Inhalte einer Merkmalbedingungsdatei, die Merkmalwerte anhand von Bedingungen festlegt:

Doc.Custom.MailCategory,Job.Name,Doc.Run.PAVE
=USPS,,Yes
=USPS,~XYZ*,No
=NonUSPS,,No
=Exception,,No

Die erste Bedingung if-then legt einen Standardwert fest, und RICOH ProcessDirector setzt bei einer Poststückkategorie USPS das Merkmal Doc.Run.PAVE auf Yes (Ja). Die zweite Zeile setzt den Wert von Doc.Run.PAVE auf Nein, wenn der Jobname mit XYZ beginnt.

Es wird empfohlen, alle Merkmale, die Teil von Bedingungen sind, links von den Merkmalen zu stellen, die Werte erhalten.

Merkmale, die Teil von Bedingungen sind, verwenden Bedingungszeichen aus dieser Gruppe:

Ein Segment eines Merkmalwerts mit Symbolschreibweise und Unterzeichenfolge-Angabe verwenden

Wenn Sie nur einen Teil des Merkmals in einer Bedingung verwenden möchten (z. B. nur die ersten 5 Zeichen eines Merkmalwerts), können Sie die Unterzeichenfolge-Angabe verwenden, um den zu benutzenden Teil des Merkmals anzugeben.

Die Syntax lautet:

• ${property_name;substr;start;length}

• property_name ist der Name des Merkmals, wie z. B. Job.Name.
• start ist die Position in der Zeichenfolge, ab der Sie beginnen möchten.
• length ist die Anzahl der Zeichen, die in der Bedingung benutzt werden sollen. Wenn Sie eine Länge angeben, die länger als die Anzahl der Zeichen im Merkmal ist, wird der Rest des Merkmals benutzt.

Die folgende Tabelle zeigt einige Beispiele:

Aufeinander folgende Werte mit Symbolschreibweise erstellen

Zusätzlich zum Festlegen von Bedingungen oder Zuweisen von Werten basierend auf dem aktuellen Wert eines bestimmten Merkmals können Sie die Symbolschreibweise auch benutzen, um Symbole zu kombinieren und einen aufeinander folgenden einzelnen Wert zu erstellen oder sie mit Literalzeichenfolgen benutzen.

Die folgende Tabelle zeigt einige Beispiele:

Werte festlegen, ohne Bedingungen zu definieren

Das Format der Bedingungsdatei ist identisch: eine Kopfzeile, die Merkmaldatenbanknamen enthält, und eine zweite Zeile, in der Merkmalwerte aufgelistet werden. Allerdings enthält die Bedingungsdatei nur zwei Zeilen. Wenn Sie mehr als eine Zeile mit Merkmalwerten angeben, werden nur die Werte in der letzten Zeile gespeichert.

Dieses Beispiel zeigt die Inhalte einer Merkmalbedingungsdatei, die Merkmalwerte ohne Bedingungen festlegt:

Doc.Custom.MailCategory,Job.Name,Doc.Run.PAVE
USPS,PostalDiscount,Yes

Werte mit separater Include-Datei festlegen

Wenn Sie mit einer Sammlung von Merkmalen arbeiten, die für verschiedene Workflows identisch sind, können Sie diese Merkmale in einer separaten Include-Datei definieren und in der Merkmalbedingungsdatei auf diese verweisen.

Um auf eine separate Include-Datei zu verweisen, tragen Sie in die Kopfzeile der Merkmalbedingungsdatei @include ein, und geben Sie in der zweiten Zeile der Datei den relativen oder absoluten Pfad der Include-Datei an.

Dieses Beispiel zeigt die Inhalte einer Merkmalbedingungsdatei, die @include und den Pfad einer separaten Include-Datei enthält:

Doc.Custom.MailCategory,Job.Name,@include
USPS,Priority,../prop-assignments/usps-properties.txt

In diesem Beispiel wird dem Merkmal MailCategory der Wert "USPS" zugewiesen, der Jobname wird auf "Priority" gesetzt, und der relative Pfad der Include-Datei usps-properties.txt wird angegeben.

In der Include-Datei werden Merkmalwerte im Format Merkmalname = Wert definiert. Das folgende Beispiel zeigt das Format der Include-Datei:

Doc.Insert.RecipientName=George Rogers
Job.CustomerName=CerbCo

Die Bedingungsdatei wird von links nach rechts und von oben nach unten verarbeitet. Die Beispiele in der folgenden Tabelle machen deutlich, wie die Merkmalbedingungsdatei und die Include-Datei zuvor festgelegte Merkmale außer Kraft setzen können. (Diese Beispiele dienen nur zur Illustration und sind nicht zur tatsächlichen Verwendung als Bedingungsdatei bestimmt.)