BarTender Command Line

Command Line

• Command Line: Specifies the BarTender command line to be run. Enter the command line that you want in the input box. Alternatively, you can add a variable for the command line value. You can also add a special character to the value that you enter.

If you receive an "invalid parameter" error, the parameter may have been deprecated, as is the case with the /W parameter. For more information about supported command line parameters, refer to Command Line Parameter Reference.

• Command Line Builder: Opens the BarTender Command Line Builder dialog, where you can quickly build the command line command that you want to use.

• /D database location: Specifies the location of the data file.

• File Encoding: Specifies the file encoding that is used by the data file.

Print Option Overrides

• Prompt for data input: Specifies that the document's data entry forms and requests are opened for user input before the print job is sent to the printer.

Verification Options

• Queue command line and continue immediately: Submits the command line and then immediately completes the action. When this option is selected, no "response" options are available.

• Verify the command line has been processed before continuing: Submits the command line and then waits for verification that the command line has been processed before completing the action.

  • Place Response in Variable: Specifies the variable that returns the action response. Enter the variable name that you want. Alternatively, you can add a variable.

  • Include print data: Specifies that the print data is included in the print response.

  • Include print summary: Specifies that the print summary is included in the print response. Available when the Include print data option is selected.

  • Include label data: Specifies that the label data is included in the print response. Available when the Include print data option is selected.

  • Include checksum: Specifies that the checksum is included in the print response.

Action

• Name: Specifies the name of the action. You can replace the default name by entering a new name in the field.

• Description: Specifies a description for the action.

• Run Action: Specifies how often you want to run the action.

  • Always: Specifies that the Integration Service runs the action each time it runs the integration.

  • Never: Specifies that the Integration Service does not run the action when it runs the integration.

  • Conditionally, based on variable: Specifies that the Integration Service runs the action only when a selected variable meets a specified condition. Use this option in situations in which there is only one condition that determines whether the action runs. After you select this option, you can create the conditional statement in the input box.

    Input box controls

    • Variable: Specifies the variable that you want to use for the conditional statement. Enter the variable in the input box. Click to see a list of recently used variables or click More Variables to open the Insert Variable dialog.

    • [Relational Operator]: Specifies the relational operator to use for the conditional statement. Click the existing operator to display a list of additional operators, and then click the one that you want to use. For more information, refer to Relational Operators. The operators that are available in the list depend on whether you selected Text or Decimal for the Type option.

    • Value: Specifies the values to use for the conditional statement. To add a value, click , click <enter a value>, enter the value that you want, and then press Enter. To delete a value, use the secondary mouse button to click it, and then click Delete. Some operators, such as Is blank and Is not blank, do not require a value to be specified. In these situations, the Value field is not available.

    • Type: Specifies whether the conditional statement is evaluating a text or decimal value.

       

  • Conditionally, based on expression: Specifies the conditions under which the Integration Service runs the action. Use this option for situations that require more than one conditional statement. When you select this option, you can create the conditional expression in the input box by creating the conditional statements that you want. You create and edit your conditional expression on the Tree View tab. Click the Text View tab to see a read-only text view of the conditional expression.

    Input box controls (Tree View tab)

    • [Conditional Joiner]: Specifies the conditional joiner for the conditional statements within the group. The default conditional joiner is And.

      Click the existing conditional joiner to display a menu that enables you to configure your conditional expression in one of the following ways:

      • And, Or, NotAnd, NotOr: Click the conditional joiner in the list that you want to use for the conditional statements. For more information about the supported conditional joiners, refer to Conditional Joiners.

      • Add Condition: Click to add another conditional statement to the current group.

      • Add Group: Click to add a subgroup of conditional statements to the current group.

      • Remove Group: Click to delete the subgroup. Available when you open the menu from a subgroup.

      • Clear All: Click to delete all conditional statements (including subgroups). Available when you open the menu from the top-most group.

    • : Adds a conditional statement to the group that is associated with that joiner. Visible to the right of each conditional joiner in your expression.

    • :  Deletes the conditional statement. Visible to the right of an existing conditional statement when you point to the statement.

    • Variable: Specifies the variable that you want to use for the conditional statement. Enter the variable in the input box. Click to see a list of recently used variables or click More Variables to open the Insert Variable dialog.

    • [Relational Operator]: Specifies the relational operator to use for the conditional statement. Click the existing operator to display a list of additional operators, and then click the one that you want to use. For more information, refer to Relational Operators. The operators that are available in the list depend on whether you selected Text or Decimal for the Type option.

    • Value: Specifies the values to use for the conditional statement. To add a value, click , click <enter a value>, enter the value that you want, and then press Enter. To delete a value, use the secondary mouse button to click it, and then click Delete. Some operators, such as Is blank and Is not blank, do not require a value to be specified. In these situations, the Value field is not available.

    • Type: Specifies whether the conditional statement is evaluating a text or decimal value.

User Account

• Inherit from parent action: Specifies that the action inherits the user account credentials that are specified on the Actions property page. Alternatively, if the action is part of a Group action, it inherits the user account credentials that are specified on the immediate parent Group action’s property page.

• Specify user credentials: Specifies that the action runs by using the credentials that are specified.

Error Handling and Diagnostics

• Ignore errors and continue running actions: Specifies that if the action fails, the remaining actions continue to run. When this option is not selected and the action fails, the resulting behavior depends on several factors, as follows:

  The action is within a Group action

  • If you specified Sequentially for the Execute Actions property on the Group action's Execution tab, no further actions within that Group action are run. No actions outside of this Group action are affected.

  • If you specified In Parallel for the Execute Actions property on the Group action's Execution tab, the errors are ignored, and the other actions within that Group action are run. No actions outside of this Group action are affected.

  The action is not within a Group action

  • If you specified Sequentially for the Execute Actions property on the Actions Execution tab, no further actions within the integration are run.

  • If you specified In Parallel for the Execute Actions property on the Actions Execution tab, the errors are ignored, and the other actions within the integration are run.

• Resend failed print jobs: Specifies that any print jobs that failed are re-sent to the print spooler.

  • Maximum retries: Specifies the maximum number of times that the failed print jobs are re-sent. Available when the Resend failed print jobs option is selected.

• Retry if failed: Specifies that if the action fails, the Integration Service tries to run it again.

  • Maximum retries: Specifies the maximum number of times the Integration Service tries to run the action again. Available when the Retry if failed option is selected.

  • Retry interval: Specifies the length of time the Integration Service waits after the action has failed before it tries to run the action again. Available when the Retry if failed option is selected.