Using Database Connection Configuration Files

You can use a database connection configuration file to apply a custom configuration to a new or existing database connection. To do this, you export a configuration from one BarTender document to an XML file that you can then use in another BarTender document.

Exported files contain all the configuration information, including filters, sort order, records-per-item data, and database joins, for all the databases in a single connection.

After you export a database connection configuration file, you can use it to create a new database connection for a document when you use the Database Setup wizard for the first time. Or, you can import the file to an existing database connection; when you do this, existing configuration settings are replaced by the settings in the imported file.

The import feature is not available for document actions or other features that support only limited database connections.

In the Database Setup dialog, click on the toolbar.
In the Save File dialog, browse to the location where you want to save the configuration file, enter a file name, and then click Save.

In a document that is not yet connected to a database, use one of the following methods to start the Database Setup wizard:

On the File menu, click Database Connection Setup.
On the main toolbar, click the icon.
In the Data Sources pane of the Toolbox, right-click Database Fields, and then click Database Connection Setup.

On the Select Database Type page of the wizard, select Import From File, and then click Next.
In the Open File dialog, browse to and select the configuration file that you want, and then click Open.

In the Database Setup dialog, click on the toolbar.
In the Replace Existing Database Setup dialog, click OK.
In the Open File dialog, browse to and select the configuration file that you want, and then click Open.