Opzetten EA omgeving

Documentatie

• Inleiding
• Opzetten EA omgeving
• Datatypes
• UML Modellering
• Zib secties
• Sectie information model
• Afspraken en eisen
• Importeren en exporteren
• EA tips en tricks
• Downloads
• Uitgegeven Zib id's
• Zib Codesystems

De documentatie is gebaseerd op Enterprise Architect versie 14.
Niettemin zijn de acties zoveel mogelijk ook voor versie 12 beschreven.

Inleiding

Voor het opzetten van een EA omgeving voor het maken van zib documentie zijn benodigd:

• Enterprise Architect (nieuwste versie is 15; bij Nictiz in gebruik is versie 14.1; info per 17-10-2019))
• MDG Technology for HCIM (Zorginformatie bouwstenen)¹
• MDG Technology for HCIM to Wiki Extraction¹
• (optioneel) DCM Stereotypes²
• (optioneel) DCM standaard datatypes²
• (optioneel) RTF Template(s)²
• (optioneel) Zib startproject file (*.EAP file met daarin 0 of meer bouwstenen, de juiste RTF rapporttemplates en de standaard DCM data types die worden gebruikt)
• (optioneel) Zib bouwsteen template (XMI file met een 'schone' lege bouwsteen)
• (optioneel) XMI file(s) van bestaande bouwstenen

Met uitzondering van Enterprise Architect zijn bovenstaande bestanden te vinden op de download pagina.

¹ Installatie gebonden bestanden: moeten bij iedere nieuwe (her)installatie van Enterprise Architect geinstalleerd worden.
² Projectfile (eap) gebonden bestanden: moeten aan ieder nieuw zib project toegevoegd worden. Indien een bestaande projectfile wordt gebruikt (incl. het startproject) hoeft dit niet meer gedaan te worden.

Enterprise Architect

Begin eventueel met de 30 dagen gratis versie
Hierna kan het pakket aangeschaft worden via https://www.sparxsystems.eu/enterprise-architect/ea-pricing-purchasing/?gclid=Cj0KCQjwoqDtBRD-ARIsAL4pviAVr6im7DwSsEvQvESVtSdXMlj5pLebf3g_zVEoXDyQWl_hhp6J8hAaAgfrEALw_wcB of via de binnen de organisatie gebruikelijke procedure.
Elke versie is geschikt, de goedkoopste is de Professional versie. Voor medewerkers van onderwijsinstellingen waaronder UMC's is een (goedkopere) Academic version beschikbaar.

Apple of Linux users

Sparx geeft aan dat EA o.a. werkt via crossover of wine (check de versies op de website van Sparx).

Als je meer windows applicaties wil draaien is VirtualBox van Oracle is een gratis optie (https://www.virtualbox.org) of Parallels (licentie en kosten maar ook beschikbaar via surfspot voor onderwijsinstellingen waaronder UMC's. Je moet dan nog wel een windows licentie kopen en installeren.

Installeren MDG Technology bestanden

screenshot

• Download de 'MDG Technology' files en onthoud de locatie.

(EA versie 12) Let op! De bestanden moeten daar na het doorlopen van deze procedure blijven staan en beschikbaar blijven. Installeer ze dus niet op een netwerkschijf of verwijderbaar medium als b.v. een USB stick.

• Start Enterprise Architect en

(EA versie 12)

• kies via het menu 'Extensions' en vervolgens 'MDG Technologies'
• Klik onderaan op de knop 'Advanced'
• Klik onderaan op de knop 'Add' en vervolgens optie 'Add Path'
• Selecteer de folder waar de files zijn gedownload

(EA versie 14)

• kies via tabblad 'Specialize' en item 'Publish' en vervolgens 'Import MDG Technologies'
• Selecteer de 'MDG Technology' file
• Selecteer 'Import To Model'

• Klik op 'OK'
  

(EA versie 15)

• kies via tabblad 'Specialize' en item 'Publish-Tech' en vervolgens 'Import MDG Technologies'
• Selecteer de 'MDG Technology' file
• Selecteer 'Import To Model'

• Klik op 'OK'
  *Sluit EA af en herstart zodat de DCM MDG Technology wordt geladen
  
• Kijk via (EA versie 12) menu 'Settings' en vervolgens ' MDG Technologies' cq. (EA versie 14) tabblad 'Specialize', item 'Manage' (EA versie 15) tabblad 'Specialize', item 'Manage-Tech' of de HCIM MDG Technologies is geladen (zie voorbeeld)
  

Doe dit voor beide 'MDG Technology' files.

Alternatief kunnen de MDG bestanden ook geplaatst worden in de bestaande map '..\Program Files (x86)\Sparx Systems\EA\MDGTechnologies', maar daar zijn wel administrator rechten voor nodig.
Wanneer bestaande MDG Technology bestanden moeten worden vervangen door een nieuwere, verwijder dan eerst de oude uit de AppData filder (windows 10 C:\Users\username|AppData\Roaming\Sparx Systems\EA )

Aan de slag

Om aan de slag te gaan met het modelleren van zibs na de installatie van Enterprise Architect en de MDG Technology bestanden, zijn er drie mogelijkheden:
1: Start met een nieuwe projectfile:

• Start Enterprise Architect en maak een nieuwe projectfile aan.
• Importeer de DCM Stereotypes.
• Importeer het xmi bestand met DCM standaard datatypes (importeren, niet als kopie).
• Importeer het xmi bestand met de Zib bouwsteen template (importeren, als kopie).
• Importeer de gewenste RTF template bestanden.

2: Start met het Zib startproject:

• Download het Zib startproject en onthoud de locatie.
• Start Enterprise Architect en open het project.

3: Start met een bestaande Zib projectfile (.eap)

• Start Enterprise Architect en open het project.

Hierna is het mogelijk om ook andere XMI bestanden te importeren.
Als een bestaande zib gebruikt wordt als startpunt voor een nieuwe zib moet deze als kopie geïmporteerd worden.