BarTender Command Line Builder Dialog

The Documents tab defines the command parameters that specify the BarTender document to open and whether to close and/or save the document when done.

• Document(s) to Use

  • None: When enabled, specifies that no BarTender document is used for this command line.

  • File(s): When enabled, you can type the folder location and file name for the document, or click Browse to locate and select the desired file. You can list more than one document by enclosing each path and file name in quotation marks.

• Close Document(s): When enabled, the document(s) will be closed when the command line execution is completed. This will not close documents currently open in other running instances of BarTender, including those instances running under the same command handler.

• Save Document(s): When enabled, the document(s) will be saved when the command line execution is completed. This will not save documents currently open in other running instances of BarTender, including those instances running under the same command handler.

The Print tab defines the command parameters that configure the print job that occurs when the action is executed.

• Print: When enabled, prints the document specified in the Documents tab.

• Print Job Name: You type a name for the print job here. Alternatively, you can add a variable to specify the print job name, or add a special character to the value you have entered.

• Print Options

  • Copies: When enabled, specifies the number of copies that you want to print of each document. If you are reading from a database, this determines the number of copies that will print for each record in the print job. When serialization is enabled for a data source on the template, this value specifies the number of copies that will print for each value in the serialization sequence.

  • Serial Numbers: When enabled, specifies the number of times the template will print with a changed serial number. If you are reading from a database, this determines the number of changed serial numbers that will print for each record in the print job.

  • Starting Record Number: When enabled, specifies the row of a data file that contains the first row of data.

  • Show Print Dialog: When enabled, displays the Print dialog each time a print job is executed.

• Printer to Use

  • Specified in Document: When enabled, the printer specified by the document is used.

  • System Printer: When enabled, allows you to select the printer to use from a dropdown list of available printers. Alternatively, you can add a variable to specify the system printer, or add a special character to the value you have entered.

  • Trays: Allows you to specify the paper tray to use when printing the document. Select a tray from the dropdown list. Alternatively, you can add a variable to specify the paper tray, or add a special character to the value you have entered. Available when System Printer has been enabled.

The Media Handling tab allows you to specify any special media handling methods you want for the print job.

• Action: Determines the printer's media handling action. Available options depend on the selected printer.

  • Use Driver's Settings: Specifies that the action will be determined by the driver's settings.

  • Page Break: Specifies that the printer will issue a page break.

  • Pause: Specifies that the printer will pause.

  • Wait for Label Taken Sensor: Specifies that the printer will wait until it senses the label has been taken.

  • Cut: Specifies that the printer will cut the label.

  • Cut and Pause: Specifies that the printer will cut the label and pause.

  • Partial Cut: Label stock is partially cut.

  • Partial Cut and Pause: Label stock is partially cut, and printer will wait for user input before printing any subsequent labels.

• Occurrence: When you choose an Action setting other than User Driver's Settings, you can specify the frequency of the action using the Occurrence property. Available options depend on the selected printer and selected action.

  • At End of Print Job: Specifies that the action occurs at the end of the print job.

  • After Every Page: Specifies that the action occurs after every printed page.

  • After Every Record:Specifies that the action occurs after each record.

  • After Copies: Specifies that the action occurs after the specified number of copies have completed.

  • After Data Changed: Specifies that the action occurs after the specified data has changed.

    • Data Item Type: Allows you to specify the type of data item as either Database Field, Named Data Source, or Object Value.

    • Data Item Name: Specifies the data item name.

    • Ignore case: When enabled, the Data Item Name property is not case-sensitive.

  • After Specified Number of Printed Items: Specifies that the action occurs .

    • Number of Printed Items: Allows you to specify how many items to print before the action occurs.

The Text File tab defines the command parameters that specify the path and file name of a text data source.

• Text File: When enabled, specifies the path and file name of the data source. The default is the variable %FilePath%. Alternatively, you can type the folder location and file name for the document, click Browse to locate and select the desired file. Alternatively, you can add a variable to specify the desired file or add a special character to the value you have entered.

• Delete File When Done: Deletes the text file after the Integration Service has read the contents.

The SAP R/3 IDoc tab defines the command parameters that specify the path and file name of an IDoc file.

• SAP R/3 IDoc File: When enabled, specifies the path and file name of the IDoc file. The default is the variable %FilePath%. You can also type the folder location and file name for the document, or click Browse to locate and select the desired file. Alternatively, you can add a variable to specify the desired file or add a special character to the value you have entered.

• Delete File When Done: Deletes the IDoc file after the Integration Service has read the contents.

The OLE DB/ODBC tab defines the command parameters that specify the login credentials for an OLE DB or ODBC data source.

• Login

  • User Name: Specifies an OLE DB or ODBC user name.

  • Password: Specifies the OLE DB or ODBC user's password. When entering a password, the password will appear as a series of asterisks on screen.

The General tab allows you to specify any other command parameters that are not included as options from other tabs in theBarTender Command Line Builder dialog. For a list of available command parameters, refer to the Command Line Parameter Reference in BarTender's help system.

• Additional Command Parameters: Enter the desired command line parameters. Alternatively, you can add a variable that specifies command line parameters, or add a special character to the value you have entered.

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.