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 you are done.

• Document(s) to Use

  • None: Specifies that no BarTender document is used for this command line.

  • File(s): Specifies the file name. Enter the folder location and file name for the document or click Browse to locate and select the file that you want. You can list more than one document by enclosing each path and file name in quotation marks.

• Close Document(s): Specifies that the documents are closed when the command line finishes running. This operation does not close documents that are currently open in other running instances of BarTender, including those instances that are running under the same command handler.

• Save Document(s): Specifies that the documents are saved when the command line finishes running. This operation does not save documents that are currently open in other running instances of BarTender, including those instances that are running under the same command handler.

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

• Print: Prints the document that is specified in the Documents tab.

• Print Job Name: Specifies the print job name. Enter a name for the print job. Alternatively, you can add a variable to specify the print job name or add a special character to the value that you enter.

• Print Options

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

  • Serial Numbers: Specifies the number of times the template is printed with a changed serial number. If you are reading from a database, this option determines the number of changed serial numbers that are printed for each record in the print job.

  • Starting Record Number: Specifies the row of a data file that contains the first row of data.

  • Show Print Dialog: Displays the Print dialog each time a print job is run.

• Printer to Use

  • Specified in Document: Specifies that the printer that is specified by the document is used.

  • System Printer: Specifies the printer to use from a list of available printers. Alternatively, you can add a variable to specify the system printer or add a special character to the value that you enter.

  • Trays: Specifies the paper tray to use when the document is printed. Select a tray from the list. Alternatively, you can add a variable to specify the paper tray or add a special character to the value that you enter. Available when the System Printer option is selected.

The Media Handling tab specifies any special media handling methods that you want for the print job.

• Action: Determines the printer's media handling action. The options that are available depend on the selected printer.

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

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

  • Pause: Specifies that the printer pauses.

  • Wait for Label Taken Sensor: Specifies that the printer waits until it senses that the label was taken.

  • Cut: Specifies that the printer cuts the label.

  • Cut and Pause: Specifies that the printer cuts the label and pauses.

  • Partial Cut: Specifies that the label stock is partially cut.

  • Partial Cut and Pause: Specifies that the label stock is partially cut and that the printer waits for user input before it prints any subsequent labels.

• Occurrence: When you select an Action setting other than User Driver's Settings, you can specify the frequency of the action by 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 are completed.

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

    • Data Item Type: Specifies 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: Specifies that the Data Item Name property is not case-sensitive.

  • After Specified Number of Printed Items: Specifies that the action occurs after the specified number of printed items.

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

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

• Text File: Specifies the path and file name of the data source. The default is the variable %FilePath%. You can also enter the folder location and file name for the document or click Browse to locate and select the file that you want. Alternatively, you can add a variable to specify the file that you want or add a special character to the value that you enter.

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

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

• SAP R/3 IDoc File: Specifies the path and file name of the IDoc file. The default is the variable %FilePath%. You can also enter the folder location and file name for the document or click Browse to locate and select the file that you want. Alternatively, you can add a variable to specify the file that you want or add a special character to the value that you enter.

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

The OLE DB/ODBC tab specifies 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 you enter a password, it appears as a series of asterisks on screen.

Use the General tab to specify any other command parameters that are not included as options from other tabs in the BarTender Command Line Builder dialog. For more information about the available command parameters, refer to the Command Line Parameter Reference in the BarTender help system.

• Additional Command Parameters: Enter the command line parameters that you want. Alternatively, you can add a variable that specifies command line parameters or 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.