Sjabloon:VersieInfo

Doel

Er zijn allerlei situaties waarin de specifieke versie van een component een bepaalde versie van een ander component gebruikt, bijvoorbeeld een versie van een informatiestandaard die een bepaalde versie van een FHIR-package nodig heeft. Dit sjabloon is bedoeld om dit soort versie-afhankelijkheden te leggen.

Gebruik

Dit sjabloon koppelt simpelweg de versie (om legacy-redenen 'release' genoemd) van de gebruikende component plus de naam van de gebruikte component aan de versienummer van deze gebruikte component.

Het sjabloon kan op pagina's ingezet worden met:

{{VersieInfo|[component](|release=[release])(|namespace=[namespace])}}

• component: de naam van de gebruikte component, dus bv. de naam van het FHIR-package dat een standaard gebruikt.
• release: de versie(string) van de gebruikende component, dus bv. de versie van een informatiestandaard die het FHIR-package gebruikt. Als deze parameter wordt weggelaten, wordt als default de ROOTPAGENAME van de (aanroepende) pagina gebruikt.
• namespace: als de gebruikende pagina zich in een andere namespace bevindt dan de namespace geregistreerd in dit sjabloon kan hier de namespace expliciet vermeld worden. Dit is vooral relevant voor verwijzingen waarin het versienummer wordt opgenomen.

Dit wordt dan vervangen door het bijbehorende versienummer. De naam van 'component' dient uiteraard exact overeen te komen met de naam die in dit sjabloon staat.

Bijvoorbeeld: binnen MedMij worden versienummers van individuele informatiestandaarden gekoppeld aan een bepaalde MedMij-release. Bv. de BgZ heeft binnen de MedMij-release "V2019.01" het versienummer 2.1.13. Dit kan opgezocht worden via:

{{VersieInfo|BgZ|release=V2019.01}}

Onderhoud versienummers

Het sjabloon bestaat uit een geneste switch; de eerste tak kijkt naar de Release (de eerste parameter), de tweede naar de naam van de gezochte component. Deze informatie staat bovenaan de pagina wanneer deze bewerkt wordt.

Wanneer het nodig is om een nieuwe release toe te voegen, volstaat het om het volgende stuk toe te voegen:

| NAMESPACE:<release> = {{#switch: {{{2}}}
 | <component1> = x.x.x
 | <component2> = x.x.x
 ...
 | <componentN> = x.x.x

}}

Afwijkende versienummers in systeemrolcodes

In sommige informatiestandaarden zijn er systeemrolcodes met een versie die afwijkt van die van de standaard als geheel. Typisch gebeurt dit wanneer er een use case is bijgekomen in een standaard; de major-versie wordt opgehoogd, maar de systeemrollen in de oorspronkelijke use case blijven de oorspronkelijke versie gebruiken (zolang er nog geen reden is om over te gaan naar een nieuwe versie).

Er is gekozen voor een pragmatische aanpak in dit soort gevallen door simpelweg een tweede entry toe te voegen voor de afwijkende major-versie; de standaard "PDF/A" staat bijvoorbeeld twee keer in het lijstje, een keer als "PDFA" en een keer als "PDFA1" voor de oudere systeemrolcodes.