Werken in Archi met de GEMMA

Category:ArchiMate modelleren
Category:Modelleren handleidingen
Het GEMMA ArchiMate-model wordt ontwikkeld en beheerd met Archi en git. Wil je als gemeente of leverancier het GEMMA ArchiMate-model bekijken, dan vind je hier daarvoor de informatie.
Als je Archi nog niet op je computer hebt, zie dan de pagina Archi installeren voor links en instructies.
== Archi documentatie ==
Hoe je met Archi en de plugins werkt is op verschillende plekken gedocumenteerd:
* Website Archi https://www.archimatetool.com/
** Download de User guide
** Volg het Archi Forum voor gebruikersvragen, tips en de laatste ontwikkelingen
* ArchiModels A Collection of ArchiMate® Models
* Hoe met Archi plug-ins werken
** coArchi – Model Collaboration for Archi wiki met documentatie voor versiebeheer en samenwerken
** Archi Scripting Plug-in wiki voor schrijven Archi scripts (met javascript en jArchi API)
* Hoe aan Archi bijdragen
** Archi wiki informatie voor ontwikkelaars en over ontwerpbeslissingen in Archi
== Werken met Archimate-modellen ==
Archi maakt voor versiebeheer en het samenwerken gebruik van de coArchi plugin die gebaseerd is op git.
: An extension to Archi that provides collaborative features, allowing you to share a model on a repository and work on it with other users.
Je kunt in Archi een Archimate-model dan ook opslaan in een bestand (met .archimate extensie) of publiceren in een git-repository. Beide hebben hun bestaansrecht, kies voor
* opslaan in bestand 
** snel, geen voorbereiding nodig en kan altijd later alsnog in git worden beheerd
** voor een persoonlijk ArchiMate-model, waarin je snel een eerste opzet kunt maken
* publiceren in git-repository
** start is bewerkelijker, maar je hoeft dat maar één keer te doen
** je hebt nu versiebeheer voor persoonlijk gebruik
** en indien gewenst kun je in een ArchiMate-model samenwerken met een zelf te bepalen groep mensen
Het GEMMA ArchiMate-model wordt gepubliceerd in een GitHub-repository, de GEMMA Archi-repository. 
=== Hoe open je een in git gepubliceerd model ===
Om met Archi een bestaand Archimate-model te openen, heb je alleen de URI van de git repository nodig. 
Dit zijn de stappen om de publieke GEMMA ArchiMate-repository te openen:
* met de browser
** ga naar https://github.com/VNG-Realisatie/GEMMA-Archi-repository 
** klik op de groene \[Code\] button
*** kies voor "HTTPS"
*** kopieer de HTTPS URL (klik op clipboard knopje ernaast)
* met Archi
** Collaboration > import remote model to workspace
** plak de GitHub URL in de pop-up
** En je kunt het model in Archi bekijken
Dit werkt voor Archimate-modellen die via git gepubliceerd zijn. Open bijvoorbeeld ook eens:
* ArchiMate Metamodel and Patterns
* Open Government of Canada Architecture Git Repository
Je kunt met Archi deze publieke Archimate-modellen alleen bekijken. Als je wilt wijzigen heb je schrijfrechten nodig in de git-repository.
Wil je je eigen versie van een publiek model maken? Dan kun je het zojuist opgehaalde model:
* opslaan als lokaal bestand en lokaal bewerken
* eventueel kun je het lokale bestand weer publiceren in een door jezelf aangemaakt git-repository. Zie de volgende paragraaf hiervoor
=== Versiebeheer voor een Archimate-model ===
Door een Archimate-model niet in een bestand bewaren, maar in git te publiceren, beschik je over versiebeheer. Met git versiebeheer kun je wijzigingen als één bij elkaar horende set bewaren, in een commit. Archi toont in de Change history alle commits. Je kunt nu 'tijdreizen' door oude commits te openen, waarna je kunt bekijken hoe het model in een vorige versie in elkaar zat.
Als je het model niet met anderen hoeft te delen, dan kun je een persoonlijke git repository aanmaken. Dit kan bij alle git-providers, hieronder is gekozen voor GitLab.
* met de browser
** Ga naar Project > Your projects
** Maak een nieuw project met daarin een repository (groene button rechts boven [new project])
*** Geef een naam en kies voor private (standalone) of public (publiceren of samenwerken)
** Copy de URL, kies voor SSH of HTTPS
* Open Archi
** Maak een nieuw model aan of open een bestaand model in een bestand. Het model mag helemaal leeg zijn.
** Collaboration > Add local model to workspace and publish
*** plak de git URL in de pop-up
** Het model is nu gelinkt aan de GitLab-repository.
*** opslaan bewaart het model in een lokaal bestand
*** commit maakt een nieuwe versie aan in de lokale git-repository
*** publish publiceert de laatste versie bij GitLab
Zie verder de wiki coArchi - Model Collaboration for Archi hoe je met Archi en versies werkt.
=== Bekijken wijzigingen met git===
In Archi zie je in de change-history de lijst van commits, de commit message, door wie en wanneer deze is doorgevoerd. Maar je ziet niet in detail wat is gewijzigd. Onder water zijn alle wijzigingen met git te bekijken. Je kijkt dan in de XML-bestanden in de GEMMA-repository.
In Archi kun je de locatie van de lokale git-repository vinden:
* open de tab Collaboration workspace
* selecteer de repository
* ga naar de tab Properties > Information.
* achter location staat de directory van lokale git-repository
Je kunt vanaf de command line met git commando's de wijzigingen opvragen. Of gebruik een grafische git-client en open de gevonden map in deze client.