Inc/Dec Data Source Properties
An Inc/Dec data source alters a starting value by adding (incrementing) or subtracting (decrementing) a consistent value. The following are the definitions and parameters that describe an Inc/Dec data source. For information about creating an Inc/Dec data source, see Create an Inc/Dec Data Source.
Property | Description |
---|---|
Data Source Name |
The identifier assigned to the Inc/Dec data source. |
Data Ref |
The data source used to populate a field with a value. |
Tip: When incrementing an alphanumeric series, by default the series begins with zero, progresses through the numerical digits, and then progresses through letters.
Property | Description | Values |
---|---|---|
Type |
Whether the count is increasing or decreasing. |
Increment Decrement |
Mode |
The type of characters in the count. |
CUSTOM: Characters defined by the Custom Sequence property NUMERIC: Numeric digits UPPERCASE_ALPHA: Uppercase alphabetic characters UPPERCASE_ALPHANUM: Uppercase alphanumeric characters |
Custom Sequence |
The order of succession for a character in the count. For example, 0123456789ABCDEF for a hexadecimal digit. Note: This property is read-only unless CUSTOM is selected for Mode. |
Numeric digits, alphabetic characters, and symbols. |
By Value |
The value by which to increment or decrement the count. |
0 to 9999 |
Important! If the data source is populated from a Prompt, you should ensure that the Max Length field of the data source and the Max Chars field of the Prompt contain the same value. The Max Chars field is automatically calculated based on the Chars Per Line and # Lines fields.
Property | Description | Values |
---|---|---|
Start |
The source of the start value of the count. |
Fixed Start: The specified value is used as the start value. The default value is 1. From Data Source: The value of the selected data source is used as the start value. |
Min Value |
The lowest value of a decrementing count. |
0 to 999999999 Default: 1 |
Max Value |
The highest value of an incrementing count. |
1 to 999999999 |
Min Length |
The minimum number of characters in the count. |
1 to 9 Default: 1 |
Max Length |
The maximum number of characters in the count. |
1 to 9 |
Max Length Overrun Mode |
If the Start value has or could have more characters than the specified Max Length value, select an option to control the behavior of the count. Example For a numeric Inc/Dec data source incrementing by 1 with a Start value of 12345 and Max Length set to 3, the count sequence is:
|
Default: The Max Length value does not apply to the first value of the count, but the remaining count sequence is as expected. Trim Right: Trims the right side characters until the Max Length value is reached. Trim Left: Trims the left side characters until the Max Length value is reached. Rollover to 1: Resets the count value to 1 when the Start value has more characters than the Max Length value. Error and Do Not Print: Errors the print job when the Start value has more characters than the Max Length value. Use Global Setting: Uses the behavior set in the incdec.maxlength.behavior system property. (Default) |
After Print |
How the count is changed after a print command is issued. |
Reset Count: The count is returned to its start value. Update Count: The count is incremented or decremented unless the user manually changes the start value. |