Sjabloon:VersieInfo: verschil tussen versies

Uit informatiestandaarden
Ga naar: navigatie, zoeken
(Change the positional release parameter to a named parameter)
(Bump version for KCR october 2021)
(40 tussenliggende versies door 5 gebruikers niet weergegeven)
Regel 1: Regel 1:
−
{{#switch: {{{2}}}
+
{{#switch: {{NAMESPACE}}:{{{release|{{ROOTPAGENAME}}}}}
  
−
| V2019.01 = {{#switch: {{{release}}}
+
| MedMij:V2019.01 = {{#switch: {{{1}}}
−
  | BgZ = 2.1.13
+
  | BgZ = 2.1.21
−
  | Laboratoriumresultaten = 1.1.13
+
  | Laboratoriumresultaten = 1.1.21
 
  | Medicatieproces = 9.0.7
 
  | Medicatieproces = 9.0.7
 +
| MedicatieprocesVerstrekkingenvertaling = 9.A.7
 +
| AllergieIntolerantie1 = 1.1.19
 +
| AllergieIntolerantie = 2.0.17
 +
| AllergieIntolerantieVertaling = 1.A.13
 +
| eAfspraak = 1.1.23
 +
| Zelfmetingen = 1.2.21
 +
| PDFA = 2.0.17
 +
| PDFA1 = 1.2.19
 +
| Huisartsgegevens = 1.1.22
 +
| BgGGZ = 1.1.21
 +
| BgLZ = 1.0.19
 +
| Beelden = 1.0.17
 +
| Vragenlijsten = 1.0.16
 +
| package = 1.3.15
 +
| nictiz.fhir.nl.stu3.zib2017 = 1.3.15
 +
}}
 +
 +
| MedMij:V2020.01 = {{#switch: {{{1}}}
 +
| BgZ = 3.0.13
 +
| Laboratoriumresultaten = 2.0.13
 +
| Medicatieproces = 9.0.7
 +
| MedicatieprocesVerstrekkingenvertaling = 9.A.7
 +
| AllergieIntolerantie1 = 2.0.12
 +
| AllergieIntolerantie = 3.0.12
 +
| AllergieIntolerantieVertaling = 2.A.11
 +
| eAfspraak = 2.0.13
 +
| Zelfmetingen = 2.0.13
 +
| PDFA = 3.0.13
 +
| PDFA1 = 3.0.13
 +
| Huisartsgegevens = 2.0.13
 +
| BgGGZ = 2.0.13
 +
| BgLZ = 2.0.12
 +
| Beelden = 2.0.13
 +
| Vragenlijsten = 2.0.13
 +
| Vragenlijsten1 = 1.0.13
 +
| package = 2.1.7
 +
| nictiz.fhir.nl.stu3.zib2017 = 2.1.7
 +
| nictiz.fhir.nl.stu3.eafspraak = 1.0.1
 +
| nictiz.fhir.nl.stu3.images = 1.0.1
 +
| nictiz.fhir.nl.stu3.questionnaires = 2.0.4
 +
| nictiz.fhir.nl.stu3.bgz = 1.0.1
 +
}}
 +
 +
| MedMij:V2020.02 = {{#switch: {{{1}}}
 +
| BgLZ = 3.0.10
 +
| package = 2.1.7
 +
| nictiz.fhir.nl.stu3.zib2017 = 2.1.7
 +
}}
 +
 +
| mp:V9.1 = {{#switch: {{{1}}}
 +
| mp = 9.1
 +
| Medicatieproces = 9.1.0
 +
| MedicatieprocesVerstrekkingenvertaling = 9.A.5
 +
| package = 2.0.0
 +
| nictiz.fhir.nl.stu3.zib2017 = 2.0.0
 +
| nictiz.fhir.nl.stu3.medicationprocess= 9.1.0-beta
 +
}}
 +
 +
| mp:V9_2.0 = {{#switch: {{{1}}}
 +
| mp9 = 2.0.0-beta2
 +
| Medicatieproces = 9 2.0.0-beta2
 
  | MedicatieprocesVerstrekkingenvertaling = 9.A.5
 
  | MedicatieprocesVerstrekkingenvertaling = 9.A.5
−
  | AllergieIntolerantie1 = 1.1.11
+
  | package = 0.1.0-beta1
−
| AllergieIntolerantie = 2.0.9
+
  | nictiz.fhir.nl.r4.zib2020 = 0.1.0-beta1
−
| AllergieIntolerantieVertaling = 1.A.5
 
−
| eAfspraak = 1.1.12
 
−
| Zelfmetingen = 1.2.13
 
−
| PDFA = 2.0.9
 
−
| PDFA1 = 1.2.11
 
−
  | Huisartsgegevens = 1.1.14
 
−
| BgGGZ = 1.1.13
 
−
| BgLZ = 1.0.10
 
−
| Beelden = 1.0.7
 
−
| Vragenlijsten = 1.0.3
 
−
| package = 1.3.9
 
 
}}
 
}}
  
Regel 24: Regel 74:
 
== Doel ==
 
== Doel ==
  
−
De MedMij-informatiestandaarden hebben allemaal een versienummer volgens semver (''major.minor.patch''). Dit versienummer wordt gebruikt:
+
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.
−
* in de titel van het FO
 
−
* in de titel van het TO
 
−
* voor versionering van systeemrolcodes
 
−
 
 
−
Dit sjabloon is bedoeld om het wat makkelijker te maken deze versienummers over alle verschillende pagina's heen te beheren.
 
  
 
== Gebruik ==
 
== Gebruik ==
  
−
Dit sjabloon koppelt simpelweg de naam van een informatiestandaard binnen een release aan een versienummer.
+
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:
 
Het sjabloon kan op pagina's ingezet worden met:
−
<pre>{{VersieInfo|[InformatieStandaard]|release=[release]}}</pre>
+
<pre>{{VersieInfo|[component](|release=[release])}}</pre>
−
Dit wordt dan vervangen door het bijbehorende versienummer. De naam van 'InformatieStandaard' dient uiteraard exact overeen te komen met de naam in dit sjabloon. 'Release' is bijvoorbeeld de MedMij-release, zoals 2019.01.
+
* <code>component</code>: de naam van het _gebruikte_ component, dus bv. de naam van het FHIR-package dat een standaard gebruikt.
 +
* <code>release</code>: 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 [https://www.mediawiki.org/wiki/Help:Magic_words#Page_names 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:
 +
 
 +
<pre>{{VersieInfo|BgZ|release=V2019.01)}}</pre>
  
 
=== Onderhoud versienummers ===
 
=== Onderhoud versienummers ===
  
−
Het sjabloon bestaat uit een geneste switch; de eerste tak kijkt naar de Release (de eerste parameter), de tweede naar de Informatiestandaard (de tweede parameter). Deze informatie is staat bovenaan de pagina wanneer deze bewerkt wordt.
+
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:
 
Wanneer het nodig is om een nieuwe release toe te voegen, volstaat het om het volgende stuk toe te voegen:
 
<pre>
 
<pre>
−
| <Release> = {{#switch: {{{2}}}
+
| NAMESPACE:<release> = {{#switch: {{{2}}}
−
  | <InformatieStandaard1> = x.x.x
+
  | <component1> = x.x.x
−
  | <InformatieStandaard2> = x.x.x
+
  | <component2> = x.x.x
 
  ...
 
  ...
−
  | <InformatieStandaardN> = x.x.x
+
  | <componentN> = x.x.x
  
 
}}
 
}}

Versie van 26 okt 2021 om 11:04

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.

Overgenomen van "https://informatiestandaarden.nictiz.nl/index.php?title=Sjabloon:VersieInfo&oldid=85614"