プロパティー条件ファイル

プロパティー条件ファイルを使用して、条件付きまたは条件なしのプロパティーの値を設定できます。また、別個のインクルードファイルを使用して、「property = value」フォーマットを使用してプロパティーを定義することもできます。

条件を使用した値の設定

プロパティー条件ファイルの先頭行は、文書プロパティーまたはジョブプロパティーのデータベース名をコンマで区切ってリストにしたヘッダー行です。通常はヘッダー行の左端の部分に、1 つ以上の条件をテストするプロパティーを指定しますが、必ずしもこの順序でなくてもかまいません。

ヘッダー行の後に、1 行以上の条件行で、条件およびその行のすべての条件が真の場合に設定されるプロパティー値を定義します。各条件行は if-then ステートメントを表すと考えることができます。1 行に指定したすべての条件は論理的に AND 演算され、すべて真である必要があります。いずれかの条件が true ではない場合は、指定された値はいずれも設定されません。条件行では値をコンマで区切ります。

条件に基づいてプロパティー値を設定するプロパティー条件ファイルの内容の例を次に示します。

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

最初のif-then条件では、郵便物カテゴリーがUSPSの場合、RICOH ProcessDirectorで Doc.Run.PAVEプロパティーを Yesに設定すると記述しています。ジョブ名がXYZから始まる場合は、2行目によって Doc.Run.PAVEの値が Noに設定されます。

条件の一部であるプロパティーはすべて、値を受け取るプロパティーの左側に配置することをお勧めします。

条件の一部であるプロパティーは、以下の設定からの条件文字を使用します。

シンボル表記およびサブ文字列指定子によるプロパティー値の一部分の使用

条件でプロパティーの一部分のみ使用する場合 (プロパティー値の最初の 5 文字のみ使用するなど)、サブ文字列指定子を使用して、プロパティーの使用する部分を指定できます。

構文は次のとおりです。

• ${property_name;substr;start;length}

• property_name は、プロパティーの名前 ( Job.Name) です。
• start は、文字列内の開始位置です。
• length は、条件で使用する文字数です。プロパティーの文字数を超える長さを入力した場合、プロパティーの残りの部分が使用されます。

次の表にいくつかの例を示します。

シンボル表記による連結値の作成

シンボル表記を使用して、特定のプロパティーの現在値に基づいて条件を設定したり、値を割り当てるのに加えて、シンボルを組み合わせて連結された 1 つの値を作成したり、それらをリテラル文字列と共に使用できます。

次の表にいくつかの例を示します。

条件を定義せずに値を設定する

条件ファイルのフォーマットは同じです。ヘッダー行にプロパティーデータベース名を、2 行目にプロパティー値をリストします。ただし、条件ファイルには行が 2 行しか含まれていません。複数行のプロパティー値を指定した場合、最後の行に指定した値のみが保存されます。

条件を使用せずにプロパティー値を設定するプロパティー条件ファイルの内容の例を次に示します。

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

別個のインクルードファイルを使用した値の設定

複数のワークフローで同一のプロパティーの集合を使用する場合は、これらのプロパティーを別個のインクルードファイルに定義し、プロパティー条件ファイルでそのインクルードファイルを参照できます。

別個のインクルードファイルを参照するには、プロパティー条件ファイルのヘッダー行に @include を記述し、プロパティー条件ファイルの 2 行目にインクルードファイルの相対パスまたは絶対パスを指定します。

@includeと別個のインクルードファイルへのパスを含むプロパティー条件ファイルの内容の例を次に示します。

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

この例では、［メールカテゴリー］プロパティーに USPS の値を割り当て、［ジョブ名］プロパティーに「優先順位」の値を割り当てます。そして、インクルードファイル usps-properties.txt への相対パスを指定しています。

インクルードファイルでは、「Property name = Value」のフォーマットを使用してプロパティー値を定義します。インクルードファイルのフォーマットを次の例に示します。

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

条件ファイルは左から右に、かつ上から下に処理されます。次の表に、すでに設定されているプロパティーをプロパティー条件ファイルおよびインクルードファイルで指定変更する例を示します。(以下の例は説明を目的としたものであり、条件ファイルの実際の使用例を示すものではありません。)