Connection Management

This section explains how to create, test, save, and manage database connections in OpenEdge Data Administration. It covers the connection settings used in both the VS Code extension and the native application, so you can quickly connect to the right database and switch between saved connections when needed.

Good connection management makes it easier to work with different environments such as development, test, and production, while keeping your connection details organized and easy to reuse. In the sections below, you will learn how to add a new connection, choose where it should be saved, work with user names and passwords, test whether a connection is valid, and manage existing connections after they have been created.

Whether you use Data Administration inside VS Code or as a native desktop application, the overall connection flow is designed to stay familiar and straightforward.

Choosing Where to Save a Connection

When you create a connection, you can choose where it should be stored.

User settings
- Best when the connection is only meant for your own use.
Workspace settings
- Useful when the connection should be available in the current workspace.
Folder settings
- Useful when one specific folder needs its own connection settings.

Choose the save location carefully, because it determines where the connection will be available later.

Password and Security Notes

If your connection requires a password, Data Administration allows you to choose how it should be stored.

Save as secret
- Recommended for normal use.
- Helps keep the password stored more securely.
Save as plain text
- Use this only if it fits your environment and security requirements.

If you are not sure which option to use, choose Save as secret. This is done by leaving the Save password as plain text checkbox unchecked.

Switching Between Contexts and Databases

Data Administration lets you switch between different connection sources and then choose the database you want to work with.

Switching context changes where Data Administration reads available connections from, such as User settings, Workspace settings, Folder settings, or a Project.

Switching database changes the active database within the currently selected context.

When you switch to a project context, you may also need to select a project profile. If you switch to a folder context, you may need to choose the correct folder first. These selections affect which connections and databases are shown in the database list.

To switch databases, use the database selector in the header and choose the connection or database you want to open. If the database you expect is missing, first check whether the selected context, folder, or project profile is correct.

If you recently changed your saved connections, refreshing or reopening Data Administration may be needed before the updated list is shown.

Adding Database Connections

In this step-by-step guide you can follow along to learn how to add a new database connection. A full demonstration video is available below.

Step 1: Open the Connection Manager

Click the Connection Settings gear icon in the top right corner of the Data Administration window.

Step 2: Click "Add Connection"

A window opens displaying a list of the current connections. Click the Add Connection button at the bottom to open the connection creation form.

Step 3: Fill in Connection Details

Select the context you want to save your connection to: User settings, Folder settings, or Workspace settings.
Enter a connection string, for example -db mydb -S 10001.
Enter a name for the connection. If left blank, the database name is used.
If required, enter your user credentials.
Choose how you want to save your password. Save as secret is recommended.

Step 4: Test the Connection

Before you can add a connection, test it to make sure it is valid.
Click Test Connection to verify that the connection details are correct and the database is accessible.

Step 5: Save the Connection

Click Add to save the connection.
Click Done to close the connection manager.
The new connection should now appear in the connection list.

Full Demo Video

Open video in new tab Video: adding connection demo.mp4

adding connection demo.mp4

Editing Database Connections

Editing an existing database connection is just as simple as adding one. You can edit a connection by clicking the edit button next to the connection name in the connection list.

Step 1: Open the Connection Manager

Click the Connection Settings gear icon in the top right corner of the Data Administration window.

Step 2: Click "Edit Connection"

A window opens displaying a list of the current connections. Click the Edit Connection pencil icon to the right of the connection name to open the connection editing form.
Here you can edit the connection details and test the connection again.

Step 3: Update the Connection

Update the connection details as needed.
Click Update to save the changes.
Click Done to close the connection manager.
The updated connection should now appear in the connection list.

Full Demo Video

Open video in new tab Video: editing connection demo.mp4

editing connection demo.mp4

Duplicating Database Connections

An existing database connection can be duplicated, saving time when a new connection is mostly similar to an existing one. You can duplicate a connection by clicking the duplicate icon between the pencil icon and the trashcan icon.

Step 1: Open the Connection Manager

Click the Connection Settings gear icon in the top right corner of the Data Administration window.
A window opens displaying a list of the current connections.

Step 2: Click "Duplicate Connection"

Click the Duplicate Connection icon to the right of the connection name to open the duplication form.
Here you can edit the copied connection details and test the connection.

Step 3: Save the Duplicated Connection

Update the copied connection details as needed.
Click Add to save the duplicated connection.
Click Done to close the connection manager.
The duplicated connection should now appear in the connection list.

Full Demo Video

Open video in new tab Video: duplicate example.mp4

duplicate example.mp4

Removing Database Connections

You can remove a connection by clicking the trashcan icon to the right of the connection name.

Step 1: Open the Connection Manager

Click the Connection Settings gear icon in the top right corner of the Data Administration window.
A window opens displaying a list of the current connections.

Step 2: Click "Delete Connection"

Click the Remove Connection trashcan icon to the right of the connection name.
Click Done to close the connection manager.
The connection is now removed.

Full Demo Video

Open video in new tab Video: delete example.mp4

delete example.mp4

Using Project Profiles

If your project uses openedge-project.json, you can define profiles with different database connection sets. This is useful when one project needs separate connections for different situations, such as development, testing, or customer-specific environments.

At the moment, these profile definitions need to be added manually in openedge-project.json.

Working with Profiles

To use profiles, your project configuration should contain:

a top-level dbConnections section for the default project connections
a profiles array
a name for each profile
an optional inherits property if the profile should inherit the default connections
a value.dbConnections section when the profile should define its own connections

A restart may be required before a new profile becomes available.

Example Structure

{
  "dbConnections": [
    {
      "name": "Sports DEV",
      "connect": "-db sports_dev -H server1 -S 10001"
    }
  ],
  "profiles": [
    {
      "name": "Development",
      "inherits": "default"
    },
    {
      "name": "Test",
      "value": {
        "dbConnections": [
          {
            "name": "Sports TEST",
            "connect": "-db sports_test -H server2 -S 10002"
          }
        ]
      }
    },
    {
      "name": "Inherited",
      "inherits": "default"
    }
  ]
}

How Data Administration Uses This

When you select a profile, Data Administration applies that profile's resolved connection list.
If a profile defines value.dbConnections, those connections are used.
If a profile does not define its own connections but has "inherits": "default", Data Administration uses the top-level dbConnections.
If a profile has no valid connections, selecting it may not show any project connections.

If you do not see the connections you expect, check whether the selected project profile is the correct one and whether the profile contains valid dbConnections.

Additional Information

Notes

A connection can only be added after it has been tested.
If you leave the connection name empty, Data Administration uses the database name instead.
If you change connection details, it is a good idea to test the connection again before saving the update.

Troubleshooting Tips

The connection test fails
- Verify the connection string and credentials.
- Confirm that the database is accessible.
The connection does not appear where expected
- Check to which context the connection was saved.
- Verify that the selected context, folder, or project profile matches where you saved it.