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 het gebruikende component plus de naam van het gebruikte component aan de versienummer van dit gebruikte component.

Het sjabloon kan op pagina's ingezet worden met:

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

• component: de naam van het _gebruikte_ component, dus bv. de naam van het FHIR-package dat een standaard gebruikt.
• release: de versie(string) van het _gebruikende_ component, dub 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.

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 het 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.