ArchiMate-model importeren

Het is mogelijk om ArchiMate-modellen in NORA Online te publiceren, zodat architectuurelementen en relaties zichtbaar en herbruikbaar zijn binnen de wiki. Daarbij gelden enkele spelregels en kwaliteitscriteria om ervoor te zorgen dat modellen toegankelijk, begrijpelijk en goed integreerbaar zijn.

Wie mag een model importeren?[bewerken]

Alleen beheerders van NORA Online mogen ArchiMate-modellen importeren. Om een model te importeren neem je contact op met nora@ictu.nl. Geef daarbij het volgende aan:

  • De Git-repository waar het model wordt beheerd.
  • Voor welke onderwerp en/of expertgroep het model is.
  • Een pagina waar het model gepubliceerd wordt.

Voorwaarden voor aanlevering[bewerken]

Bestandskwaliteit en toegankelijkheid[bewerken]

  • Kleuren en contrast: Zorg voor voldoende contrast tussen de kleuren die in het model gebruikt worden, zodat deze voldoen aan de WCAG-richtlijnen. Er zijn meerdere toegankelijkheidstest beschikbaar. In de kennisbank van digitoegankelijk.nl staan er meerdere genoemgd.
  • Lettertype: Archi gebruikt standaardlettertypen die per besturingssysteem (Windows/Mac) anders worden weergegeven. Je kunt dit zelf instellen in je Architectuur software, maar houd rekening met marges en posities. Dit vereist een visuele controle.
  • Eigenschappen worden rechtstreeks uit het model gehaald. Het gaat hier om de custom properties die u in veel ArchiMate-modelleertools kunt toevoegen. Het is de verantwoordelijkheid van de aanleverende architect om de eigenschappen te voorzien van definities.

Na oplevering van het model controleert NORA Beheer op bovenstaande onderwerpen.

Indien het model niet voldoet aan de kwaliteitseisen, dan ontvangt de architect een verzoek om het model aan te passen. De NORA behoudt het recht om de modellen die niet voldoen af te wijzen of te verwijderen.

Integratie in pagina’s[bewerken]

De integratie van views of modellen in pagina's wordt gedaan via het Sjabloon:DisplayArchiMateDiagram. Om een model te vinden is er een overzichtspagina met alle geimporteerde modellen.

In de aanroep van bovenstaande sjabloon:

  • vult u verplicht de parameter page met de paginatitel (= het laatste gedeelte in de url-balk in uw browser) van de view die (of het contextdiagram dat) u wilt tonen. U kunt hier ook de semantische naam van de view opgeven.
  • vult u optioneel de parameter maxwidth met de maximale breedte die de view op het scherm mag hebben, in pixels. Als u deze parameter achterwege laat, wordt de breedte automatisch bepaald.
  • vult u optioneel de parameter nolinks met om het even welke waarde als u wilt dat de objecten in de view niet 'klikbaar' zijn. Als u deze parameter achterwege laat, zijn objecten wel klikbaar en kunt u op die wijze vanuit de view naar objecten navigeren.
  • Vult u optioneel de parameter customproperty met de naam van een eigenschap die gebruikt moet worden als basis voor de inkleuring van de elementen.
  • Vult u optioneel de parameter nopanel met de waarde 'true' als u het legendapaneel aan de rechterzijde wilt onderdrukken.