Advanced Block: Do-While Repeat

Repeat an action as long as specified conditions continue to be true or the max iterations have been run.

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.

Property	Description
Row Key	Allows the user to specify a key in the map for a row list entry. The loop will execute for each row in the row list.
Max Iterations	A numeric value used to limit the total number of iterations of the loop. It is used if you want to make sure a loop doesn't accidentally run for too long. Set to -1 for unlimited iterations. Set to 0 for no iterations.

Property

Description

Row Key

Allows the user to specify a key in the map for a row list entry. The loop will execute for each row in the row list.

Max Iterations

A numeric value used to limit the total number of iterations of the loop. It is used if you want to make sure a loop doesn't accidentally run for too long.

Set to -1 for unlimited iterations.
Set to 0 for no iterations.

Before Loop Criteria

Build a conditional expression that is evaluated before the loop is executed. If it is not enabled, then it is not evaluated.

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	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

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

You can select from the following for a data ref.

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

After Loop Criteria

Build a conditional expression that is evaluated after the loop is executed to determine if the loop should be run again. If it is not enabled then it is not evaluated

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	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

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

You can select from the following for a data ref.

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

Rule Action

The list of component blocks to be run based on the resolution of the rule criteria.

Tip: You can add a component block by dragging it from the Insert tab dropping it onto a Drop block here marker within this component block.