Fichier de conditions de propriété

Vous pouvez utiliser le fichier de conditions de propriété pour définir des valeurs de propriétés avec ou sans conditions. Vous pouvez également utiliser un fichier include séparé pour définir des propriétés en utilisant un format propriété = valeur.

Définition de valeurs avec conditions

La première ligne du fichier de conditions de propriété est une ligne d'en-tête qui répertorie les noms de base de données des propriétés de travail ou de document, séparés par des virgules. Généralement, la partie la plus à gauche de l'en-tête spécifie les propriétés à tester par rapport aux conditions, mais cette règle est facultative.

La ligne d'en-tête est suivie d'une ou plusieurs lignes de condition qui spécifient les conditions et les valeurs de propriété à définir quand toutes les conditions de cette ligne sont remplies. Chaque ligne de condition peut être considérée comme une instruction conditionnelle if-then. Toutes les conditions spécifiées sur une ligne sont reliées entre elles de manière logique par l'opérateur AND et doivent toutes être remplies (true). Si l'une des conditions n'est pas vérifiée, aucune des valeurs indiquées n'est définie. Les valeurs des lignes de condition sont séparées par des virgules.

Voici un exemple de contenu du fichier de conditions de propriété qui définit des valeurs de propriété basées sur des conditions :

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

La première instruction conditionnelle if-then spécifie que si une catégorie de courrier est de type USPS, RICOH ProcessDirector définit la propriété Doc.Run.PAVE sur Oui. La deuxième ligne définit la valeur de Doc.Run.PAVE sur Non si le nom du travail commence par XYZ.

Il est conseillé de placer toutes les propriétés faisant partie des conditions à gauche des propriétés recevant des valeurs.

Les propriétés faisant partie des conditions utilisent les caractères conditionnels du jeu suivant :

Utilisation d'un segment de valeur de propriété avec la notation des symboles et le spécificateur de sous-chaîne

Si vous ne souhaitez utiliser qu'une partie d'une propriété dans une condition (par exemple, uniquement les 5 premiers caractères d'une valeur de propriété), vous pouvez utiliser le spécificateur de sous-chaîne pour indiquer la partie de la propriété à utiliser.

La syntaxe est la suivante :

• ${nom_propriété;substr;début;longueur}

• nom_propriété est le nom de la propriété, tel que Job.Name.
• début est la position dans la chaîne à laquelle vous voulez commencer.
• longueur est le nombre de caractères à utiliser dans la condition ; si vous entrez une longueur supérieure au nombre de caractères de la propriété, le reste de la propriété est utilisé.

Le tableau suivant montre quelques exemples :

Création de valeurs concaténées avec la notation des symboles

Vous pouvez utiliser la notation des symboles pour définir des conditions ou attribuer des valeurs basées sur la valeur actuelle d'une propriété particulière. Vous pouvez également combiner des symboles pour créer une valeur unique concaténée ou les utiliser avec des chaînes littérales.

Le tableau suivant montre quelques exemples :

Définition de valeurs sans conditions

Le format du fichier de conditions est le même, avec une ligne d'en-tête contenant les noms de base de données de propriétés et une deuxième ligne répertoriant les valeurs de propriétés. En revanche, le fichier de conditions contient seulement deux lignes. Si vous incluez plusieurs lignes de valeurs de propriété, seules les valeurs spécifiées sur la dernière ligne sont enregistrées.

Voici un exemple de contenu du fichier de conditions de propriété qui définit des valeurs de propriété sans utiliser de conditions :

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

Définition de valeurs avec un fichier include distinct

Si vous avez un ensemble de propriétés qui restent les mêmes pour différents flots de travaux, vous pouvez définir ces propriétés dans un fichier include séparé auquel vous faites référence dans le fichier des conditions de propriété.

Pour faire référence à un fichier include séparé, indiquez @include dans la ligne d'en-tête du fichier de conditions de propriété et spécifiez le chemin d'accès absolu ou relatif au fichier include sur la deuxième ligne du fichier de conditions.

Voici un exemple de contenu du fichier de conditions de propriété qui utilise @include et un chemin d'accès à un fichier include distinct :

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

Dans cet exemple, la propriété Mail Category reçoit la valeur USPS, la propriété Job Name reçoit la valeur Priority et le chemin d'accès relatif au fichier include usps-properties.txt est indiqué.

Le fichier include définit les valeurs de propriété selon le format Nom de la propriété = Valeur. L'exemple qui suit présente le format du fichier include :

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

Le fichier de conditions est traité de gauche à droite et de haut en bas. Ce tableau contient des exemples illustrant la manière dont le fichier de conditions de propriété et le fichier include peuvent remplacer des propriétés définies antérieurement. (Ces exemples sont proposés à des fins d'illustration uniquement et ne doivent pas être repris dans le cadre d'une utilisation réelle du fichier de conditions.)