Data Map Block: Conditional

In a business rule designed in the Configurator, you can add a Conditional component block to only perform an action if the result of a logical expression combining multiple conditions is true.

Each condition is a comparison of the value of a data map entry A name (key) and value pair in the data map for a job. to a specified value or is an evaluation of the state of a data map entry. The result of each condition is true or false.

The results of the conditions are combined using either logical AND or OR operations. If AND operations are used, then the rule action is performed only if all of the conditions are true. If OR operations are used, then the rule action is performed if any of the conditions are true.

Tip: Before you can add a component block to a business rule, you must create a component set by specifying a trigger that controls when component blocks in the component set are run.

Rule Criteria

The rule criteria determine whether the rule action is performed.

Tip: You can add or remove conditions from the logical expression by clicking Add or Remove .

Property	Description
Logical Operator	If the rule criteria include more than one condition, how to combine the results of the conditions to produce a result of true or false. AND: Combine the results of the conditions using logical AND operations. The rule action is performed only if all of the conditions are true. OR: Combine the results of the conditions using logical OR operations. The rule action is performed if any of the conditions are true.
Data Ref to Test	A print job property or the name of a data map entry to be evaluated or compared to a value. If the data map entry does not already exist, it is created. You can select from the following for a data ref. Manually Entered A property that allows a Designer or administrator to type in the value for a property rather than select it from a list. For a data ref, value must be the fully-qualified name of a data map entry. Job Detail Name A digital representation of a label generated by a print job. Job details can be altered during the print job by using Formula data sources, Script data sources, and business rules. Job Name What is submitted for processing. A job is separated into print jobs and print job details based on the processing rules. A job defines which processes to use. Label Template A digital representation of a label that can be combined with variable data and used by print jobs to generate print job details. Number of Duplicates The number of times to reprint a label by using the same data and without changing the value in any incrementing or decrementing field. Each duplicate printed label is identical. Pages of Labels The number of times to print the content for the labels in a layout. Each page is identical, including the value in any incrementing or decrementing field. Printer A physical printer, print queue, or other target for output, such as an image file or a PDF file. Printer Tray To which output tray to direct printed labels or documents. If a printer has only one output tray or otherwise does not support this feature, this is ignored. For Windows drivers the tray is the name of the tray that supplies the paper. The name corresponds to the configured tray name in the driver setup (not case sensitive). For PCL 5e drivers the tray is the ID number of the tray that supplies the paper. The ID corresponds to the configured tray number in the driver setup. Quantity of Labels The number of times to print a label by using the same data. Each printed label produced is identical except for any incrementing or decrementing field.
Operator	The operator to use when evaluating or comparing the data ref and the value for a condition. Equals Not Equal Equals Ignore Case Not Equal Ignore Case Less Than Greater Than Is Missing Is Not Missing Is Empty Is Not Empty
Value to Test	The literal value to compare to the value of a print job property or data map entry. This value is interpreted as a text string. Note: For some operators, no box is displayed for the Value property because it is not necessary to specify a value.

Rule Action

The rule action is performed only if the conditions specified by the rule criteria produce a result of true.

Property	Description
Data Ref to Set	A print job property or the name of a data map entry to be assigned a value if the conditions produce a result of true. If the data map entry does not already exist, it is created. You can select from the following for a data ref. Manually Entered A property that allows a Designer or administrator to type in the value for a property rather than select it from a list. For a data ref, value must be the fully-qualified name of a data map entry. Job Detail Name A digital representation of a label generated by a print job. Job details can be altered during the print job by using Formula data sources, Script data sources, and business rules. Job Name What is submitted for processing. A job is separated into print jobs and print job details based on the processing rules. A job defines which processes to use. Label Template A digital representation of a label that can be combined with variable data and used by print jobs to generate print job details. Number of Duplicates The number of times to reprint a label by using the same data and without changing the value in any incrementing or decrementing field. Each duplicate printed label is identical. Pages of Labels The number of times to print the content for the labels in a layout. Each page is identical, including the value in any incrementing or decrementing field. Printer A physical printer, print queue, or other target for output, such as an image file or a PDF file. Printer Tray To which output tray to direct printed labels or documents. If a printer has only one output tray or otherwise does not support this feature, this is ignored. For Windows drivers the tray is the name of the tray that supplies the paper. The name corresponds to the configured tray name in the driver setup (not case sensitive). For PCL 5e drivers the tray is the ID number of the tray that supplies the paper. The ID corresponds to the configured tray number in the driver setup. Quantity of Labels The number of times to print a label by using the same data. Each printed label produced is identical except for any incrementing or decrementing field.
Value to Set	The new value of the print job property or data map entry. This value is interpreted as a text string.

Property

Description

Data Ref to Set

A print job property or the name of a data map entry to be assigned a value if the conditions produce a result of true. If the data map entry does not already exist, it is created.

You can select from the following for a data ref.

Value to Set

The new value of the print job property or data map entry. This value is interpreted as a text string.