Editing the Harmonized Model

jetgeo edited this page Dec 8, 2017 · 1 revision

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.

Get user privileges

If you do not already have a user-name and password for the repository, contact one of the HMMG convenors for one. It may take a few days to get, and you will recieve an email with further instructions.

Store SVN User Information

  • 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..."

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 credidentials (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 credientials saved.

Check out and edit in Enterprise Architect

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.

Check out packages

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...

Create new models

New models shall be named according to thes 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.

Check in packages

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.
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.