"Seegrid will be due for a migration to confluence on the 1st of August. Any update on or after the 1st of August will NOT be migrated"

Configuring your UML tool for domain modeling using HollowWorld

Contents

Related pages


These instructions assume you are using Enterprise Architect with version control. You will need to adapt these to fit other modes or IDEs.

These instructions do not comprise a tutorial for either UML or Enterprise Architect.It is assumed that the application schema designer will make themself familiar with these independently.

1. Install Sparx Systems Enterprise Architect

  • v7.5 or later is required because of SVN support
  • version 10, build 1005 or later is recommended due to built-in GML support
Obtain free trial version from http://www.sparxsystems.com/products/ea_downloads.html

2. Checkout copies of the shared models to your local computer

  1. Install a SubVersion client ( svn.exe, v1.5 or later)
  2. SVN Checkout a local copy of HollowWorld
    • the HollowWorld XMIs are available from
      1. HollowWorldSVN:trunk/ (a moving target)
      2. HollowWorldSVN:branches/release_4/ (stable release based on 2012 version of ISO/TC 211 Harmonized model + OGC SWE v2.0)
  3. SVN Checkout a local copy of the ISO Harmonized Model
  4. SVN Checkout a local copy of the XMIs for any other model that may be a dependency of your new model
    • see list of AvailableModels
    • keep the XMIs from each repository in a separate folder, and remember the location of each local folder
  5. ALERT! cache https server certificates for every SVN repository you intend to access ALERT!
    Enterprise Architect piggy-backs on your local machine's authentication arrangements, so you can accomplish this by following this procedure:
    • open a CMD window,
    • cd to the directory containing your local copy of a SVN you intend to access from Enterprise Architect
    • run svn update
      • when it asks, accept the cert (p)ermanently.
    • repeat for every other model
  6. ALERT! cache access credentials for every SVN repository you intend to modify ALERT!
    Enterprise Architect piggy-backs on your local machine's authentication arrangements, so you can accomplish this by following this procedure:
    • open a CMD window,
    • cd to the directory containing your local copy of a SVN you intend to access from Enterprise Architect
    • run svn --username fred.bloggs lock file.ext(use your own uid and touch a file that actually exists)
      • when it asks, enter your password
    • run svn unlock file.ext to undo what you just did
    • repeat for every other model

3. [optional] Install SolidGround Add-in

The SolidGround team has developed an EA plugin to automate some routine tasks, such as
  • assigning sequenceNumber tagged values
  • generating a context diagram for every class
  • generating the package dependency diagram
The installer for this is available by contacting solidground-support@csiro.au

4. Load the shared models in EA

Within the following instructions,
  • the path where the local copy of your selected version of HollowWorld is stored will be designated $HollowWorldLocal$
  • the path where your local copy of the ISO Harmonized Model is stored will be designated $ISOLocal$
  1. Start EA
  2. Create a New Project
    • choose a name related to your application
    • you will probably want to manage it separately from your HollowWorld cache, so don't put it in $HollowWorldLocal$
    • when prompted about what should be in the mode, select Domain Model
      NewProject.png
  3. Configure the Version Control Settings - in the Project Browser, right-click on Model - Package Control - Version Control Settings
    VCSettings.png
    1. Hollow World model
      • Save nested version controlled packages to stubs only - true
      • Unique ID: HollowWorld it is important that this is set to exactly this (case-sensitive) value
      • Type: SVN
      • Working Copy Path: $HollowWorldLocal$
      • Subversion Exe Path: set path
      • Save
      • Close
    2. ISO Harmonized model
      • Save nested version controlled packages to stubs only - true
      • Unique ID: isotc211 it is important that this is set to exactly this (case-sensitive) value
      • Type: SVN
      • Working Copy Path: $ISOLocal$
      • Subversion Exe Path: set path
      • Save
      • Close
    3. Repeat for any other shared models
  4. Load models into EA cache
    • in the Project Browser, right-click on Model- Package Control - Get Package
      ProjectBrowser.png
      • Select a Version Control Configuration HollowWorld / isotc211 / etc.
      • Select the shared file for HollowWorld.xml / ISO TC211.xml / etc (you may have to scroll down the list a way)
        GetHollowWorld.png
      • OK
      • Repeat for each shared model
    • in the Project Browser, right-click on Model - Package Control - Get All Latest
      • If "Get All Latest" is greyed out, you will need to check the "This model is private..." tick box under Version Control Settings. It should then become active.
        GetAllLatest.png
      • Import changed files only - true
      • OK

5. Configure the EA UI

  1. Make sure the diagram Toolbox is visible
    • Diagram - Diagram Toolbox
  2. Make sure the Tagged Values pane is open and that you see duplicate tagged values
    • View - Tagged Values = true
      TaggedValues.png
    • to see make duplicate tags visible, either
      • tagged value options button at the top of the tagged value pane
        Duplicate_tag.PNG
      • or Tools - Options - Objects
  3. [EA 10.0 and later] Load the GML profile
    • go to Settings - MDG Technologies and check *GML*
      EA-GML.PNG
    • use the More Tools button at the top of the Toolbox and select *GML*
      GML-toolbox.PNG
  4. [EA version prior to 10.0] Load the GML Profile
    • in the Resources pane, right click on UML Profiles - Import Profile
      UMLProfiles.png
    • Filename: $HollowWorldLocal\Utilities\ISO19136_UMLProfile.xml
      ImportProfile.png
    • Import
      GMLProfile.png
    • - Settings - UML Types
      AddTags.png
    • Tag Name: sequenceNumber
    • Detail: Type=Integer;
      sequenceNumber.png
    • Tag name: ownedBy
    • Detail: Type=String;
      ownedBy.png

Smoke-test for Release_2
smokeTest.png

6. Build your domain model

  • rename 'Domain Model' to match your domain

Foogle.png

More information

The INSPIRE guidelines for using EA with a centralized repository describe a similar procedure used by the INSPIRE data specifications team.


BuildingHollowWorldProjects

-- SimonCox - 19 Oct 2007 -- SimonCox - 08 Jan 2009 -- SimonCox - 18 May 2009 -- SimonCox - 17 May 2013

 
Topic attachments
I Attachment Action Size Date Who Comment
AddTags.pngpng AddTags.png manage 65.4 K 18 May 2009 - 17:07 SimonCox Additional tagged values
Duplicate_tag.PNGPNG Duplicate_tag.PNG manage 5.0 K 17 May 2013 - 15:28 SimonCox Duplicate tag dialogue
EA-GML.PNGPNG EA-GML.PNG manage 72.3 K 17 May 2013 - 15:08 SimonCox Dialogue to load MDG technologies, such as GML
Foogle.pngpng Foogle.png manage 23.0 K 18 May 2009 - 15:50 SimonCox Rename Domain Model
GML-toolbox.PNGPNG GML-toolbox.PNG manage 31.3 K 17 May 2013 - 15:30 SimonCox Toolbox showing GML tools
GMLProfile.pngpng GMLProfile.png manage 9.3 K 18 May 2009 - 15:35 SimonCox GML Profile in Resources Pane
GetAllLatest.pngpng GetAllLatest.png manage 9.2 K 18 May 2009 - 15:36 SimonCox Get HollowWorld contents
GetHollowWorld.pngpng GetHollowWorld.png manage 22.4 K 18 May 2009 - 15:36 SimonCox Load HollowWorld from XMI
INSPIRE_uml_howtopdf__EN_2.0.pdfpdf INSPIRE_uml_howtopdf__EN_2.0.pdf manage 1487.2 K 08 Feb 2012 - 17:34 SimonCox INSPIRE guidelines for using Enterprise Architect with a central VCS
ImportProfile.pngpng ImportProfile.png manage 87.4 K 09 Jun 2009 - 21:08 GuillaumeDuclaux Import Profile
NewProject.pngpng NewProject.png manage 17.2 K 18 May 2009 - 15:34 SimonCox New Project dialogue
ProjectBrowser.pngpng ProjectBrowser.png manage 6.5 K 18 May 2009 - 15:47 SimonCox Empty project browser
TaggedValues.pngpng TaggedValues.png manage 45.5 K 18 May 2009 - 17:07 SimonCox Make tagged values pane visible
UMLProfiles.pngpng UMLProfiles.png manage 6.8 K 18 May 2009 - 15:34 SimonCox Resources pane
VCSettings.pngpng VCSettings.png manage 22.4 K 18 May 2009 - 15:35 SimonCox Version control settings
ownedBy.pngpng ownedBy.png manage 27.4 K 18 May 2009 - 17:08 SimonCox Set owned by tagged value
projectBrowser.pngpng projectBrowser.png manage 19.4 K 10 Oct 2007 - 15:39 SimonCox Screen shot of diagram selected in project browser
sequenceNumber.pngpng sequenceNumber.png manage 27.4 K 18 May 2009 - 17:08 SimonCox Set sequence number tagged value
smokeTest.pngpng smokeTest.png manage 112.7 K 18 May 2009 - 15:38 SimonCox EA smoke test
specimen.pngpng specimen.png manage 14.2 K 10 Oct 2007 - 15:29 SimonCox Smoketest diagram from Hollow World
Topic revision: r51 - 21 May 2013, SimonCox
 

Current license: All material on this collaboration platform is licensed under a Creative Commons Attribution 3.0 Australia Licence (CC BY 3.0).