Algemene uitleg Maatwerksjablonen voor ArchiMate elementen en views

• In je ArchiMate-model geef je properties mee aan elementen/views die bepalen of een maatwerksjabloon getoond moet worden.
• In de wiki configureer je op basis van welke property & waarde, welk sjabloon getoond moet worden.
• Met behulp van twee voorbeeld-sjablonen kan je nieuwe sjablonen aanmaken
• Let op dat alle pagina's (sjablonen en de 'selector'-pagina's) ook gepubliceerd moeten worden naar de publicatie-omgeving.

Code van Mediawiki in het kort

• Mediawiki-opmaak: Mediawiki.org Formatting
  • een beperkt aantal html-tags is toegestaan, we gebruiken vooral <div> voor wat opmaak.
  • regeleinden in de code zorgen vaak voor regeleinden in de opmaak. Daarom zetten we vaak dingen achter elkaar, of gebruiken we 'uit-commenten' van een regeleinde: <!-- -->a
• Properties uit ArchiMate: vraag je op in de code middels: {{#var:naam van de property|waarde die gegeven wordt als de property leeg is}}
  • Als de property leeg is en er is geen vertikale pijp in je code (of er staat niets na je vertikale pijp), dan wordt er niets weergegeven op die plek
  • {{#var:label}} toont het label, dus de 'weergegeven naam' van het element.
  • daarnaast kan je de naam (deel van de URL) van de pagina opvragen met {{FULLPAGENAME}}
• soms wordt code opgesplitst in deelsjablonen die opgevraagd worden met twéé accolades: {{Naam van Sjabloon|1e parameter zonder naam die meegegeven moet worden|Parameter met naam=Waarde}}
• basale programmeer-acties doen we met bij voorbeeld de extensie ParserFunctions.
  • Een functie is te herkennen aan {{#naam van functie:
  • De meest voorkomende is {{#if:{{#var:variabele}}|waarde bestaat|waarde is leeg}}
• relaties met andere elementen kan je doen via ask-queries. Je kunt deze opbouwen via de pagina Speciaal:Vragen
  • Voorbeeld: Gebruiker:Jdirks/archimate query

Instellen welk sjabloon bij elementen/views getoond moet worden

• Sjabloon:DisplayArchiMateElementSelector configureert welke maatwerk-sjablonen je hebt voor Elementen.
• Sjabloon:DisplayArchiMateViewSelector doet hetzelfde voor Views.

In beide gevallen geeft de pagina een paar voorbeelden hoe je de code moet aanpassen. De gedachte is: je programmeert een voorwaarde en geeft aan welke sjabloon in dat geval geladen moet worden, door de variabele DisplayTemplate in te stellen.

In beide gevallen is de pagina al voorgeprogrammeerd om te kijken of er een maatwerk-sjabloon bestaat met de naam van de ArchiMate-property Objecttype of CORA concepttype'.

• Deze sjablonen moeten een naam hebben als: Sjabloon:DisplayArchiMateElement/Klasse
• Je kunt forceren om een pagina in een bepaald sjabloon te tonen door achter de URL het volgende te zetten: ?DisplayTemplate=Gegevensdomein (waarbij 'Gegevensdomein' een voorbeeld is, om Sjabloon DisplayArchiMateElement/Gegevensdomein of DisplayArchiMateView/Gegevensdomein te tonen - afhankelijk van of je een view of element bekijkt)

Sjablonen aanmaken

• Ga naar Sjabloon:DisplayArchiMateElement/Klasse of Sjabloon:DisplayArchiMateView/Gegevensdomein en kies weergaven -> bewerken
• Kopieer de inhoud van de pagina naar je klembord
• pas de URL aan naar het concept dat je wil aanmaken
• Plak en pas aan

Extra opmaaksjablonen

• Sjabloon:Rechter panelen toont aan de rechter kant vier kadertjes: versies, ArchiMate-eigenschappen, links, downloads. Oproepen via: {{Rechter panelen}}
• Sjabloon:Collapsible box zorgt voor het kader met een blauwe 'titel; rechtsboven zit een knopje om het kader in te klappen. Kijk op de Sjabloon-pagina voor extra eigenschappen die je kan meegeven.
• toont simpelweg het is-teken (nodig op uitzonderlijke plekken waar je het is-teken niet letterlijk kan gebruiken).

Klassen importeren

• Sjabloon:Klasse en Sjabloon:Attribuut-regel tonen voor een pagina de attributen van die klasse. De werking is nu: Sjabloon:DisplayArchiMateElement/Klasse kijkt of er bij de huidige pagina een klasse-pagina hoort (een pagina in de naamruimte 'Klasse' met hetzelfde label). Op die klasse-pagina wordt Sjabloon Klasse gebruikt. De eigenschap 'attributen' in die sjabloon wordt regel voor regel door de tweede sjabloon gehaald. Elke van die pagina's krijgt de categorie: Klasse-attributen.

Overzicht pagina's voor deze functionaliteit

Sjabloon:DisplayArchiMateElementCustom
Project:Sjablonen ArchiMate
Gebruiker:Jdirks/archimate query
Categorie:Klasse-attributen
Gegevensdomein
Sjabloon:Rechter panelen
Sjabloon:Collapsible box
Sjabloon:DisplayArchiMateElementCustom/Relationships
Sjabloon:DisplayArchiMateElementDefault
Sjabloon:Klasse
Sjabloon:Attribuut-regel
Sjabloon:=
Sjabloon:DisplayArchiMateViewCustom
Sjabloon:DisplayArchiMateElementSelector
Sjabloon:DisplayArchiMateViewDefault
Sjabloon:DisplayArchiMateElement/Klasse
Sjabloon:DisplayArchiMateView/Gegevensdomein
Project:Bedrijfsprocessen met views
Project:Elementen met views
Sjabloon:DisplayArchiMateElement/Bedrijfsproces
Sjabloon:DisplayArchiMateElementSelector
Sjabloon:DisplayArchiMateDiagramByLabel