Editing the Harmonized Model
This section describes how to create an EA editing environment for the harmonized model repository. It assumes that you have already set up your local working copy of the Harmonized Model.
If you do not already have a user-name and password for the repository, contact one of the HMMG convenors for one:
- Mr. Knut Jetlund, Norway.
- Dr. John R. Herring, USA
It may take a few days to get, and you will receive an email with further instructions.
- Note: This section is based on using the GUI for Tortoise SVN in Microsoft Windows. Similar steps will be applicable for other SVN Clients and operating systems.
To change your local working copy from a read only copy to an editing version, you must perform a checkout of one of the packages you have been given editorial privileges for. This must be done in SVN Client, since Enterprise Architect does not handle this information.
In Windows Explorer:
Right-click on one of the directories you have been given editorial privileges to and select "TortoiseSVN" and "Get lock..."
The SVN Client will now ask for your user name and password.
Provide user name and password, and select to save the information.
The SVN Client will lock the selected directory for you only, and store your credentials (If you try to check out things you do not have write access to, the SVN Client will not let you).
But you are not supposed to do any editing in Windows Explorer, so you must release the lock.
Right-click on the same directory again, and select "TortoiseSVN" and "Release lock..."
The SVN Client will now release the lock, but keep your credentials saved.
All editing work is done in Enterprise Architect, which communicates with the SVN software. No work on version controlled files and folders should be done outside of Enterprise Architect.
Before you can edit anything you will need to do a 'check out' for the controlled package where your edits will be most directly contained. Packages higher up the hierarchy need not be checked out.
Go to the model browser and use the context menu:
Package Control → Check Out...
New models shall be named according to the structure described in this article: Structure of the Harmonized Model, and modelling shall be done according to ISO/TC211 Best Practices for modelling geographic information in UML.
When you're done editing, check it back in. In special circumstances it is reasonable to keep something checked out between sessions - but if you always have a net connection, it is not worth the risk. SVN can roll back to (recover) any ‘check-in’ point.
Go to the model browser and use the context menu:
Package Control → Check In...
You will be asked to write a short description of the changes. Always do this.
Notes:
- If you want to update the repository with your changes, and keep the lock, you can use Package Control → Put Latest... instead.
- If you want to undo all your changes and go back to the latest version, you can use Package Control → Undo Check Out...
- If you want to go back to older versions of the package, use Package Control → File History..., and check out the revision you want to use.