Opzetten EA omgeving: verschil tussen versies

Huidige versie van 11 jun 2020 om 09:11

Documentatie

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.

@@ Regel 1: / Regel 1: @@
+<!--Inhoudsopgave transclude pagina-->
+{{DocumentationTOC}}
 ==Inleiding==
-Wat heb je nodig
+Voor het opzetten van een EA omgeving voor het maken van zib documentie zijn benodigd:
-* Enterprise Architect (laatste versie is 10)
+* Enterprise Architect (nieuwste versie is 15; bij Nictiz in gebruik is versie 14.1; info per 17-10-2019))
-* MDG Technology voor DCM 2010 (uit zipfile met andere bestanden)
+* MDG Technology for HCIM (Zorginformatie bouwstenen)<sup>1</sup>
-* UMC startproject file (*.EAP file met daarin 0 of meer bouwstenen, de juiste RTF rapporten en de standaard DCM data types die worden gebruikt)
+* MDG Technology for HCIM to Wiki Extraction<sup>1</sup>
-* (optioneel 1) UMC bouwsteen template (XMI file met een 'schone' lege bouwsteen)
+* (optioneel) DCM Stereotypes<sup>2</sup>
-* (optioneel 2) XMI file(s) van bestaande bouwstenen uit het project
+* (optioneel) DCM standaard datatypes<sup>2</sup>
+* (optioneel) RTF Template(s)<sup>2</sup>
+* (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 [[Downloads |download pagina]].<br><br>
+<sup>1</sup> Installatie gebonden bestanden: moeten bij iedere nieuwe (her)installatie van Enterprise Architect geinstalleerd worden.<br>
+<sup>2</sup> 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 via http://www.sparxsystems.com.au/products/ea/trial.html<br>
+Begin eventueel met de 30 dagen gratis versie<br>
-Hierna kan je het pakket aanschaffen via http://www.sparxsystems.com.au/products/ea/purchase.html#Professional<br>
+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.<br>
-Je moet wel de professional editie hebben en deze kost 199 USD.  Voor medewerkers academische centra is Enterprise architect slechts 105 USD. Je moet dan wel aantonen via b.v. via een PDF van je badge dat je een medewerker bent. Dat moet aldaar worden goedgekeurd dus kan even duren. Hou hier rekening en wacht dus niet 30 dagen voordat je het aanschaft http://www.sparxsystems.com/products/academic_pricing.html informeer ook even bij je IT helpdesk. Sommige UMC's (zoals groningen) hebben al een licentie en dan kan je die gebruiken.<br>
+Elke versie is geschikt, de goedkoopste is de Professional versie. Voor medewerkers van onderwijsinstellingen waaronder UMC's is een (goedkopere) Academic version beschikbaar.<br>
-Meer info over werken met Enterprise architect staat hier http://sparxsystems.com.au/resources/
-==Crossover (of VM of VirtualBox) alleen voor Apple of Linux users==
+==Apple of Linux users==
-Sparx geeft aan dat EA werkt via crossover. Via de eerste link kom je ook Crossover tegen voor  Mac (of Linux) users. Hiermee kan je windows programmas waaronder EA draaien.  Werkt prima met Enterprise Architect 9  en hier is de URL voor downlaoden http://www.codeweavers.com/products/ ) . Er is een gratis 14 dagen demo licentie licentie beschikbaar. Hierna kan het kopen voor/vanaf € 34 (even checken via more pricing options anders betaal je € 51 )
+Sparx geeft aan dat EA o.a. werkt via crossover of wine (check de versies op de website van Sparx).
-Er is ook een educational discount beschikbaar (voor students, faculty and staff at alle educational institutions (including home schools :-).
-Om hiervoor in aanmerking te komen moet je ze even mailen voordat je het koopt, dan maken ze een account aan en hierna krijg je korting. Achteraf korting geven doen ze niet. Korting is 30% op alle purchases.
-Als je meer windows applicaties wil draaien is VirtualBox van Oracle is een gratis optie (https://www.virtualbox.org). Je moet dan nog wel een windows licentie kopen in in een virtualbox installeren. Via een windows share kan je een folder delen van je Mac (Crossover werkt met de API's en daar hoef je dus geen licentie voor windows voor te hebben)
+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.
-==DCM 2010 standaard temptaties en files bij HL7==
+==Installeren MDG Technology bestanden==
-Download de laatste versie van de HL7 DCM2010 files via http://gforge.hl7.org/gf/project/dcm_ea/frs/?action=FrsReleaseBrowse&frs_package_id=175 <br>
+[[Bestand:Add_MDG_technology.png|200px|thumb|right|screenshot]]
-Unzip alle files in een directory waar je vanuit Enterprise Architect bij kan komen. <br>
+*Download de 'MDG Technology' files en onthoud de locatie.
+<span style="font-size:75%">'''(EA versie 12)'''</span> 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.<br>
+*Start Enterprise Architect en
+:<span style="font-size:75%">'''(EA versie 12)'''</span>
+:*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
+:<span style="font-size:75%">'''(EA versie 14)'''</span>
+:*kies via tabblad 'Specialize' en item 'Publish' en vervolgens 'Import MDG Technologies'
+:*Selecteer de 'MDG Technology' file
+:*Selecteer 'Import To Model'
+*Klik op 'OK' <br>
+:<span style="font-size:75%">'''(EA versie 15)'''</span>
+:*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' <br>*Sluit EA af en '''herstart zodat de DCM MDG Technology wordt geladen''' <br>
+*Kijk via <span style="font-size:75%">'''(EA versie 12)'''</span> menu 'Settings' en vervolgens ' MDG Technologies' cq. <span style="font-size:75%">'''(EA versie 14)'''</span> tabblad 'Specialize', item 'Manage'  <span style="font-size:75%">'''(EA versie 15)'''</span> tabblad 'Specialize', item 'Manage-Tech' of de HCIM MDG Technologies is geladen (zie voorbeeld) <br>
+Doe dit voor beide 'MDG Technology' files.<br><br>
+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.<br>
+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 )
-''Q: Wat zit er allemaal in die folder en heb ik dat nodig? A: Er zitten diverse files die je nodig kan hebben als je niet de NFU*.eap file hebt of los daarvan aan een nieuw project begint. Wellicht dat we hierover de wiki nog wel eens zullen bijwerken. De standaard datatypes en het benodigde RTF template zijn tijdens het project al toegevoegd en zitten nu in de project file (*.eap)
+==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:<br>
+: Start met een nieuwe projectfile:
+*Start Enterprise Architect en maak een nieuwe projectfile aan.
+*[[Importeren_en_exporteren#DCM Stereotypes|Importeer]] de DCM Stereotypes.
+*[[Importeren_en_exporteren#XMI_bestanden|Importeer]] het xmi bestand met DCM standaard datatypes (importeren, '''niet''' als kopie).
+*[[Importeren_en_exporteren#XMI_bestanden|Importeer]] het xmi bestand met de Zib bouwsteen template (importeren, als kopie).
+*[[Importeren_en_exporteren#RTF_templates|Importeer]] de gewenste RTF template bestanden.
-==Installeren MDG Technology for DCM==
+: Start met het Zib startproject:
-*Bij de unzipped files, zoek de 'MDG Technology for DCM2010.xml' file <br>
+*Download het Zib startproject en onthoud de locatie.
-*Start Enterprise Architect en kies via het menu 'settings' en vervolgens ' MDG Technologies' <br>
+*Start Enterprise Architect en open het project.
-*Klik onderaan op de knop 'Advanced' <br>
-*Klik onderaan op de knop 'Add' en vervolgens optie 'Add Path' <br>
-*Selecteer de folder waar de files zijn geunzipped <br>
-*Klik op 'OK' <br>
-*Sluit EA af en '''herstart zodat de DCM MDG Technology wordt geladen''' <br>
-*Kijk via menu 'settings' en vervolgens ' MDG Technologies' of de DCM MDG Technologies is geladen (zie voorbeeld) <br>
-[[Bestand:Add_MDG_technology.png|200px|thumb|left|screenshot]]
-[[Bestand:Bestand.png|200px|thumb|left|alternatieve tekst]]
+: 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_en_exporteren#XMI_bestanden|importeren]].<br>
+Als een bestaande zib gebruikt wordt als startpunt voor een nieuwe zib moet deze als kopie geïmporteerd worden.