Archivo de condiciones de propiedad

Puede usar el archivo de condiciones de propiedad para establecer valores para propiedades con condiciones o sin condiciones. También puede utilizar un archivo de inclusión separado para definir las propiedades mediante una propiedad = formato de valor.

Establecimiento de valores mediante condiciones

La primera línea del archivo de condiciones de propiedades es una fila de cabecera que lista los nombres de base de datos de las propiedades de trabajo o documento, separados por comas. Normalmente, la parte de la fila de cabecera situada más a la izquierda especifica las propiedades para probar una o más condiciones, aunque este orden no es necesario.

La fila de cabecera va seguida de una o más filas de condiciones que definen las condiciones y los valores de propiedad que se van a establecer si todas las condiciones en dicha fila son verdaderas. Puede pensar en cada fila de condiciones como representación de una sentencia if-then. Se utiliza AND de forma lógica para unir todas las condiciones especificadas en una fila y todas deben ser verdaderas. Si alguna de las condiciones de una fila no es verdadera, no se establece ninguno de los valores en dicha fila. Los valores de las filas de condiciones se separan por comas.

Este ejemplo muestra los contenidos de un archivo de condiciones de propiedades que establece los valores de la propiedad según las condiciones:

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

La primera condición if-then especifica que si una categoría de elemento de correo es USPS, RICOH ProcessDirector establece la propiedad Doc.Run.PAVE en Yes. La segunda fila establece el valor de Doc.Run.PAVE en No si el nombre del trabajo comienza por XYZ.

Recomendamos que coloque todas las propiedades que forman parte de condiciones a la izquierda de las propiedades que reciben los valores.

Las propiedades que forman parte de las condiciones utilizan caracteres de este conjunto:

Uso de un segmento de un valor de propiedad con notación de símbolos y especificador de subserie

Si sólo desea utilizar una parte de una propiedad en una condición, por ejemplo, utilizar sólo los 5 primeros caracteres del valor de una propiedad, puede utilizar el especificador de subserie para indicar la parte de la propiedad que desea utilizar.

La sintaxis es:

• ${property_name;substr;start;length}

• nombre_propiedad es el nombre de la propiedad, como Trabajo.Nombre.
• inicio es la posición en la serie desde la que desea empezar.
• longitud es el número de caracteres que se utilizan en la condición; si introduce una longitud mayor al número de caracteres en la propiedad, se utiliza el resto de la propiedad.

Esta tabla muestra algunos ejemplos:

Creación de valores concatenados con notación de símbolos

Además de utilizar la notación de símbolos para establecer condiciones o asignar valores basados en el valor actual de una propiedad determinada, puede combinar símbolos para crear un valor único concatenado o utilizarlos con series literales.

Esta tabla muestra algunos ejemplos:

Establecimiento de valores sin definir condiciones

El formato del archivo de condiciones es el mismo, con una fila de cabecera que contiene nombres de bases de datos de propiedades y una segunda fila que lista valores de propiedades. Sin embargo, el archivo de condiciones sólo contiene dos filas. Si incluye más de una fila de valores de propiedades, sólo se guardan los valores especificados en la última fila.

Este ejemplo muestra los contenidos de un archivo de condiciones de propiedades que establece los valores de propiedades sin utilizar condiciones:

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

Establecimiento de valores con un archivo de inclusión separado

Si tiene un conjunto de propiedades que permanecen igual para diferentes flujos de trabajo, puede definir esas propiedades en un archivo de inclusión separado al que hace referencia en el archivo de condiciones de propiedades.

Para hacer referencia a un archivo de inclusión separado, introduzca @include en la fila de cabecera del archivo de condiciones de propiedades y especifique la vía de acceso absoluta o relativa al archivo de inclusión en la segunda fila del archivo de condiciones de propiedades.

Este ejemplo muestra los contenidos de un archivo de condiciones de propiedades que contiene @include y una vía de acceso a un archivo de inclusión separado:

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

En este ejemplo, a la propiedad de categoría de correo se asigna el valor de USPS, a la propiedad de nombre de trabajo se asigna el valor de prioridad y se especifica la vía de acceso relativa al archivo de inclusiónusps-properties.txt.

El archivo de inclusión define los valores de propiedades mediante el formato Property name = Value. Este ejemplo muestra el formato del archivo de inclusión:

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

El archivo de condiciones se procesa de izquierda a derecha y de arriba a abajo. Esta tabla contiene ejemplos que muestran cómo el archivo de condiciones de propiedades y el archivo de inclusión pueden alterar las propiedades establecidas anteriormente. (Estos ejemplos son a modo informativo y no forman parte de usos reales del archivo de condiciones).