Create and Manage Connection Mapping
Connection mappings allow Workspace Admins to control how connections are used as workflows move between different workspaces. This allows workflows to move through different workspaces without requiring manual updates to their connections.
Separate workspaces are often used for each stage of the Software Development Lifecycle (SDLC). With workspace-level connection mappings, admins can configure equivalent connections for each workspace so that workflows automatically use the appropriate connection when promoted or executed in a different workspace.
Connection Mapping
A connection mapping links a connection in one workspace (like development) to its equivalent in another (like test or production). Once a mapping exists, any workflow that uses the source connection will automatically use the correct target connection when it's promoted or run in that workspace, without modifying workflow XML.
Connection mapping ensures that workflows use the correct connections for the target workspace. Connection mappings are configured and managed by Workspace Admins and users with the desktopenvironmentrule_author capability
Create a Connection Mapping
Workspace Admins define mappings between source and target Workspace Execution connections for each workspace. When a workflow is promoted to another workspace or executed within that workspace, the configured mapping is applied so the workflow uses the corresponding target connection.
To create a new connection mapping…
Select Data from the left nav.
Select the three-dot menu > select Workspace Execution Connections Mapping. Or, select SDLC Manager> select Connections Mapping.
The Workspace Execution Connections Mapping page is displayed, where you'll see a list of existing mappings (Source Connection, Target Connection, Created By, Last Updated).
Select + New Mapping. A New Connection Mapping modal is displayed.
Select Source connection. Select from the dropdown list of already existing connections. You can also select + Add by connection ID to type in a connection ID directly, instead of picking one from the list.
Under Target Connection, either select an existing target or select Create New Connection from the dropdown.
Select Create Mapping to save it, or Close to cancel.
Note
Connection mapping applies to all assets in the workspace. Any assets using the source connection will automatically switch to the target connection.
Manage Connection Mappings
View, edit, and delete the connection mappings through the Connections Mapping page to maintain security and proper access control across environments.
Edit a Connection Mapping
To edit a connection mapping…
Go to the Connection Mapping page.
Find the mapping you want to edit and select its three-dot menu.
Select Edit.
Update the Source or Target connection as needed.
A warning message shows how many assets use this mapping and that they'll be affected. Select Review Assets if you want to see the list.
Select Save Changes.
A confirmation pop-up appears, showing the same asset count again. Select Save Changes to confirm, or Cancel to stop.
Delete a Connection Mapping
To delete a connection mapping…
Go to the Connection Mapping page.
Find the mapping you want to delete and select its three-dot menu.
Select Delete.
A warning shows how many assets will be affected. Select Review Assets if you want to check.
Select Delete Mapping, or Close to cancel.
A confirmation pop-up appears, showing the asset count again. Click Delete Mapping to confirm, or Cancel to stop.