Reassigning Connections
The Reassign feature changes a Connection within a Map without recreating each Block that calls that Connection.
For example, assume you have SQL Server Connections that connect to Test and Production databases. After testing your Scheduled Solution with the Test database, you are ready to move to the Production database. You could use the Reassign feature to switch from the Connection to the Test database to the Connection to the Production Database.
If you import Maps from another Organization, the Connections in the imported Map may not match those in the current Organization. For the imported Maps, you may also need to reassign Connections.
Considerations
When reassigning Connections, note the following Best Practices:
- Make sure that the new Connection has corresponding entities and relationships. If the new Connection does not have the same entities and relationships, the change can cause Blocks with previously configured relationships to generate an error message.
- Make sure that the new Connection supports the same operations as the prior Connection. If the new Connection does not support the same operations or Blocks, the Map may fail to run and may generate errors.
- Reassigning a Connection in a Map does not trigger Map validation. Select the Validate button at the bottom of the Map.
- Inactive Block that are outside the Active Stack are ignored and their Connection information is not updated. Before reassigning the Connection either make the inactive Blocks part of the Active Stack before reassigning the Connection or select Assign Connection from the Gear menu for each inactive Block and assign the correct Connection.
Note: Reassigning a Connection in a Map saves the new Connection immediately and creates a revision of the Map with a Comment Reassigned connection from 'ConnectionName' to 'NewConnectionName' or Reassigned connection to 'NewConnectionName'.
Canceling or exiting the Map without saving does not restore the prior Connection. If you reassign a Connection and want to revert to the original Connection, you must change it manually or use the Revisions dialog to revert to a prior revision of the Map. See Map Revisions and Reverting A Map To A Prior Revision.
Reassign A Connection
- Open the Map with the Connection you want to reassign.
- On the Connection panel, locate the Connection.
- From the Gear menu
for that Connection select Reassign. The Reassign Connection dialog displays. - Select a Connection from the drop-down list or select Create a New Connection.
- Select OK to save your changes and close the dialog box.
- Any references to the original Connection change to the new selected Connection. If the Entities and fields are identical, you do not need to make changes to the Blocks.
