Archi en VNGR modellen


Overzichtpagina werken met VNGR architectuurmodellen

VNGR heeft gekozen om haar architectuurmodellen te ontwikkelen en beheren met Archi en git. Op deze pagina staat beschreven wat je nodig hebt om met Archi te kunnen werken en hoe je toegang krijgt tot de architectuurmodellen opgeslagen in de git-repositories.

Archi versie

Voor het GEMMA architectuurmodel en de van de GEMMA afgeleide projectmodellen geldt de eis dat Archi versie 4.7 of hoger moet worden gebruikt. Dit vanwege:

  • ondersteuning voor ArchiMate 3.1 (vanaf Archi 4.6)
  • het samenvoegen van projectmodellen en het GEMMA architectuurmodel (interne en geëxporteerde id's gelijk aan elkaar vanaf versie 4.7)

Zie de pagina Archi en plug-ins installeren voor instructies en links van plug-ins en configuratiebestanden

Archi documentatie

Hier een aantal links voor meer Archi documentatie en tips:

Werken met architectuurmodellen

Je kunt in Archi een architectuurmodel 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 wat 'plaatjes' zonder versiebeheer en samenwerking via de mail
  • publiceren in git-repository
    • bewerkelijker, maar gaat snel als je het vaker doet.
    • versiebeheer voor persoonlijk gebruik
    • versiebeheer en samenwerken met een zelf te bepalen groep mensen

De rest van deze paragraaf gaat ervan uit dat een architectuurmodel wordt gepubliceerd in een git-repository.

Hoe open je een in git gepubliceerd model

Om met Archi een bestaand architectuurmodel te openen, heb je alleen de URI van de git repository nodig.

Voorbeeld hoe je eenvoudig de publieke GEMMA repository kunt openen in Archi

  • met de browser ophalen van de URI van git repo
  • met Archi
    • Collaboration > import remote model to workspace
    • plak de git URI in de pop-up
    • En Archi haalt het model op
    • Open het zojuist opgehaalde model
      • Ga naar het dropdown menu Collaboration > toggle Collaboration workspace
      • Hiermee verschijnt er in Archi een nieuw subwindow
      • Dubbelklik in de Collaboration workspace op je zojuist opgehaalde repo
      • Het model wordt nu geopend


Dit werkt voor architectuurmodellen die via git gepubliceerd zijn. Kijk bijvoorbeeld eens naar:

Je kunt met Archi deze publieke architectuurmodellen bekijken en ook wijzigen. Je kunt de wijzigingen echter niet publiceren, hiervoor heb je schrijfrechten in de repository nodig. Maar je kunt de wijzigingen wel opslaan in een lokaal bestaan en eventueel vervolgens in je eigen git repository.

Als je in een architectuurmodel wilt samenwerken en dus ook je wijzigingen in het model wilt kunnen publiceren, zul je bij de beheerder of eigenaar van de repository schrijfrechten moeten aanvragen.

Versiebeheer voor een architectuurmodel

Door een architectuurmodel 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.

Samenwerken aan VNGR architectuurmodellen

Wil je met meerdere mensen aan één architectuurmodel samenwerken, dan zul je het model in een gedeelde git-repository moeten publiceren. Samenwerken vereist ook dat al deze mensen toegang tot de repository hebben en wijzigingen moeten kunnen publiceren.

De VNGR architectuurmodellen worden gedeeld op GitLab onder de organisatie VNG Realisatie. Op GitLab kunnen de toegangsrechten als rollen aan gebruikers worden uitgedeeld.

We maken gebruik van vier rollen. Zie de pagina Permissions voor een overzicht van de mogelijke rechten per rol.

  • Guest - voor het kunnen lezen van een private repository en het kunnen melden van issues
  • Reporter - om ook issues te kunnen beantwoorden en oplossen
  • Developer - om ook te kunnen wijzigen in een repository
  • Maintainer - om ook beheeracties in de repository te kunnen uitvoeren

Waar vind je gedeelde VNGR architectuurmodellen

De publieke groepen en projecten van VNGR zie als je niet bent ingelogd (of nog geen toegangsrechten hebt) en gaat naar https://gitlab.com/vng-realisatie. Je ziet daar de groep Architectuur met daarin de groep GEMMA en daarin weer het project GEMMA. Het GEMMA project is het GEMMA architectuurmodel dat je in Archi kan openen.

Als je inlogt en je account heeft toegangsrechten op de VNGR Architectuur groep, dan zie je op je GitLab homepagina de repositories met daarachter de toegangsrechten. Zie je hier niet de repositories die je nodig hebt, vraag dan toegang tot deze repository aan.

GitLab Your Projects.png


Als je kijkt onder Groups > Your groups zie hoe de repositories zijn verdeeld in groepen. Met de groepen worden de toegangsrechten ingesteld.

GitLab Your Groups.png


Voor het openen en bekijken van één van de modellen, zie de instructies Hoe open je een in git gepubliceerd model in de paragraaf hierboven