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
+* Enterprise Architect (nieuwste versie is 15; bij Nictiz in gebruik is versie 14.1; info per 17-10-2019))
-* MDG Tecnology
+* MDG Technology for HCIM (Zorginformatie bouwstenen)<sup>1</sup>
-* UMC startproject
+* MDG Technology for HCIM to Wiki Extraction<sup>1</sup>
-* UMC bouwsteen template
+* (optioneel) DCM Stereotypes<sup>2</sup>
+* (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 bijvoorbeeld 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.00 euro (even checken via more pricing options anders betaal je 51 EUR )
+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). Je moet dan nog wel een windows licentie kopen in in een virtualbox installeren. (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.
+==Installeren MDG Technology bestanden==
+[[Bestand:Add_MDG_technology.png|200px|thumb|right|screenshot]]
+*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 )
-==DCM standaard template en files bij HL7==
+==Aan de slag==
-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>
+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>
-Unzip alle files in een directory waar je vanuit Enterprise Architect bij kan komen
+: 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.