Working with Workbench Connections

To create a new connection:

1. Click File > Open Connection.

   The Connection Manager dialog box opens.

   

2. At the top right of the Connections pane, click Add Connection, and select the connection type.

   

   • DiveLine—Used for typical Dimensional Insight projects (except DiveTab projects)
   • DiveTab—Used for DiveTab projects

3. Enter details for the connection in the right pane. The details vary depending on the connection type. For example:

   

   See the following lists for the details on each type.

4. Click Login.

NOTE: If a wrong username or password is saved in Connection Manager, Workbench will prompt you for correct credentials. When you enter the correct credentials, Workbench offers to save them.

DiveLine connections:

• Server —Enter the server name or an IP address to connect to.

  NOTE: What you type here is duplicated in the Connections list on the left pane and becomes the connection name (unless you also add a label).

• Port—Enter a port number for this connection (check with your system administrator).

• Label—Optionally, enter a label for this connection (recommended).

  NOTE: This label overrides the text entered into the Server field for the connection name as it displays in the left Connections pane pane.

• User—Enter the user name for this connection. If no name is provided here, and authentication it is not Web Server, the login dialog box appears when opening the connection.

• Password—Optionally, enter the password for this user and connection. The password is encrypted using Windows Data Protection API. If no password is provided here, and authentication it is not Web Server, the user will need to provide a password each time the connection is made.

  NOTE: When the server is configured for Web Server authentication and no credentials are stored, authentication proceeds normally via the DLCGI object. However, if a user has authentication override set to OWN on the DiveLine server and the userid and password are stored in the connection manager, those credentials are used for the login to DiveLine, by-passing the web authentication.

• Connect on startup—Select this to have the connection login on startup (defaults to False). If credentials are missing when a login attempt is made, an error message displays on the Start Page under the Default connections area.

• Use Credentials For WebAuth—Select to allow credentials to be used for the DiveLine Web Authentication URL. Defaults to False and is only applicable for servers using Web Server authentication.

  NOTE:

  • When unchecked, Workbench uses any stored credentials to authenticate against DiveLine directly as OWN authentication.

  • When unchecked and there are no stored credentials, authentication proceeds through the DLCGI object.
  • When checked, Workbench uses any stored credentials to connect to the configured DLCGI URL.

• Sample DiveLine connection

• 

DiveTab connections:

• DiveTab URL—Enter the URL for DiveTab development. This URL is to a specific instance of a DivePort created for this DiveTab project.

  NOTE: What you type here is duplicated in the Connections list on the left-hand pane and becomes the connection name (unless you also add a label).

• Label—Enter a label for this connection (optional).

  NOTE: This label overrides the text entered into the DiveTab URL field for the connection name as it displays in the left-hand Connections pane.

• User—Enter the user name for this connection.

• Password—Optionally enter the password for this user and connection. If no password is provided here, and authentication it is not Web Server, the user will need to provide a password each time the connection is made.

  NOTE: When the server is configured for Web Server authentication and no credentials are stored, authentication proceeds normally via the DLGCI object. However, if a user has authentication override set on the DiveLine server and the userid and password are stored in the connection manager, those credentials are used for the login, by-passing the web authentication.

• Connect on startup—Select this to have the connection login on startup (defaults to False).

• Use Credentials For WebAuth—Select to allow credentials to be used for the DiveLine Web Authentication URL. Defaults to False and is only applicable for servers using Web Server authentication.

  NOTE

  • When unchecked, it will use any stored credentials to authenticate against DiveLine directly as OWN authentication.

  • When unchecked and there are no stored credentials, authentication proceeds via the DLCGI object.
  • When checked, it will use any stored credentials to connect to the configured DLCGI URL.

  Sample DiveTab connection.

  

To edit an existing connection:

1. Select the connection in the list.

2. Edit the fields in the right-hand pane.

To delete a connection:

1. Select the connection in the list
2. Click Delete (red X).
3. Click Yes to confirm the deletion.