Open topic with navigation

Using Named Database Connections

If you have any BarTender documents that share the same databases, and if those databases will be configured in the same way, you should create a named database connection. Named database connections save your connection properties and parameters so that you don't have to re-enter them every time you use them in a BarTender document. If the connection parameters change, you can edit them in one place rather than in each document that uses the connection.

In some cases, you might want to stop using a named database connection with a particular document and instead create a separate copy of the connection settings that will be used only within that document. To do this, on the Connection Properties page of the Database Setup dialog, click Stop using named database connection. Any changes that you make to the unnamed database connection will apply only to the current document. The named database connection will still be available to other documents.

ClosedTo create a named database connection

First, configure a database connection in the Database Setup dialog. Then, you can choose to save it as a named database connection.

  1. On the File menu, click Database Setup. Alternatively, click the icon on the main toolbar. One of the following actions will occur:

    • If you are currently connected to a database, this operation opens the Database Setup dialog.

    • If you have not previously connected to a database, this operation starts the Database Setup wizard. Follow the steps in the wizard to complete the connection setup for the selected file type. At the end of the wizard, click Finish to open the Database Setup dialog.

  2. On the Connection Properties page, click Create named database connection to open the corresponding dialog.

  3. In the Name field, enter a name for the configured database connection.

  4. Click OK.

ClosedTo modify a named database connection

To configure an existing named database connection, on the Connection Properties page of the Database Setup dialog, click Configure named database connection to open the Database Setup wizard. From here, you can change or configure the named database connection.

When you modify the configuration settings for a named database connection, all other documents and connections in other BarTender applications that use the named database connection are affected.

ClosedTo connect to a database by using a named database connection

  1. On the File menu, click Database Setup. Alternatively, click the icon on the main toolbar. One of the following actions will occur:

    • If you are currently connected to a database, this operation opens the Database Setup dialog. Click the icon to start the Database Setup wizard.

    • If you have not previously connected to a database, this operation starts the Database Setup wizard.

  2. On the first page of the wizard, select Use an existing named database connection.

  3. Select the named database connection that you want to use.

  4. Click Finish.

Related Topics