Committing changes to a shared network
Commit and update network changes to the ICM database in a multi-user environment.
Tutorial resources
These downloadable resources will be used to complete this tutorial:
Step-by-step guide
When you are ready to save or share network changes that you have made locally, you can commit them. With the commit, your changes are uploaded to the database and merged with other users' changes as a new version.
Note: An uncommitted network has a red circle at the bottom of the network icon and needs to be committed before any changes can be used in a model simulation.
To commit changes:
- Right-click the network in the Explorer window and select Commit changes to database.
- In the Commit change to server dialog box is a summary of the changes that you are committing. Add a meaningful comment about the changes.
- Click OK.
Note: The File toolbar > Save tool or the Network, Version control menu can also be used to commit changes.
Every time a change to the network is committed, a new version of the network is created. The Commit history details each version of the network. From a Commit history, you can view, compare, and roll back changes. Even if you are working alone, you can benefit from the commit history.
To view the commit history:
- Right-click the network in the Explorer window and select Show Commit History.
In the Commit history dialog box, for every commit, there is a corresponding version number, date, user, and the number of changes that were made.
- Select an available version.
- Click Details to see the commit details.
Â
Note: To compare the differences between two versions, multi-select two versions and then click Diff.
Note: To revert to a previous version, use Branch or Copy. Branching a subnetwork from an existing model maintains the history between both networks. Copying starts a new network, which resets the history to version 1.
In a multi-user environment, there may be a situation where the same asset is modified by two users. If this happens, a conflict will occur.
The conflict is discovered when a commit is initiated or when one of the users selects Update (get changes made by others).
If conflicts are found:
- Right-click the network and select Resolve conflicts.
IMPORTANT: Check with the other users involved before confirming a resolution.
To view the commit history of individual objects:
- In the GeoPlan toolbar, click Find in GeoPlan to locate a specific node.
- Double-click the node to open the Object Properties window.
- Click Commit history.
- In the Commit history dialog box, select a version.
- Click Details.
- The Object commit details dialog box displays all the information for the different versions of the object. Select Full history to display a color-coded table of when each item was last edited.
Note: Recent changes are highlighted in dark red.
Note: Similar to the network history, to view the differences between two object versions, multi-select the versions in the Commit history dialog box, and then click Diff to open the Object version comparison dialog box.