MedMij:Vissue-MMTM-974/Landingspagina MedMij - Bewerkingsoverzicht

Niek van Galen: /* Versiebeleid */ fix "dependency's" --> "dependencies"

2022-12-07T09:57:38Z

Versiebeleid: fix "dependency's" --> "dependencies"

← Oudere versie		Versie van 7 dec 2022 09:57
Regel 203:		Regel 203:
	* Een versienummer kan een toevoeging hebben in de vorm van '-alfa.x', '-beta.x' of '-rc.x'. Dit betekent dat de versie nog niet stabiel is. Informatiestandaarden zijn dan ook nog niet opgenomen in een MedMij-gegevensdienst.		* Een versienummer kan een toevoeging hebben in de vorm van '-alfa.x', '-beta.x' of '-rc.x'. Dit betekent dat de versie nog niet stabiel is. Informatiestandaarden zijn dan ook nog niet opgenomen in een MedMij-gegevensdienst.
	* Tijdens de levensduur van een release kunnen nieuwe (versies van) informatiestandaarden worden toegevoegd. Dit heeft per definitie geen invloed op de reeds aanwezige standaarden binnen de release. Informatiestandaarden kunnen ook binnen een release worden uitgefaseerd.		* Tijdens de levensduur van een release kunnen nieuwe (versies van) informatiestandaarden worden toegevoegd. Dit heeft per definitie geen invloed op de reeds aanwezige standaarden binnen de release. Informatiestandaarden kunnen ook binnen een release worden uitgefaseerd.
	* Er kan geen nieuwe informatiestandaard geïntroduceerd worden in een publicatie wanneer de ~~dependency's~~ niet compatibel zijn. Dat zal pas kunnen bij een andere MedMij-release.		* Er kan geen nieuwe informatiestandaard geïntroduceerd worden in een publicatie wanneer de dependencies niet compatibel zijn. Dat zal pas kunnen bij een andere MedMij-release.
	* Het is in principe wél mogelijk dat verschillende incompatibele versies van dezelfde informatiestandaard binnen een release worden opgenomen, dus met met verschillende majorversies. Zolang ze wel dezelfde ''dependency's'' hebben.		* Het is in principe wél mogelijk dat verschillende incompatibele versies van dezelfde informatiestandaard binnen een release worden opgenomen, dus met met verschillende majorversies. Zolang ze wel dezelfde ''dependency's'' hebben.

	Welke versie van een informatiestandaard er gebruikt moet worden, wordt bepaald door de MedMij-gegevensdienst die in de MedMij-catalogus vermeld staat. Elke gegevensdienst is gekoppeld aan één specifieke versie van een informatiestandaard (of meer specifiek, naar een systeemrol binnen een versie van de informatiestandaard).		Welke versie van een informatiestandaard er gebruikt moet worden, wordt bepaald door de MedMij-gegevensdienst die in de MedMij-catalogus vermeld staat. Elke gegevensdienst is gekoppeld aan één specifieke versie van een informatiestandaard (of meer specifiek, naar een systeemrol binnen een versie van de informatiestandaard).

	==Gearchiveerde releases==		==Gearchiveerde releases==

Pieter Edelman op 6 dec 2022 om 20:10

2022-12-06T20:10:25Z

← Oudere versie		Versie van 6 dec 2022 20:10
Regel 3:		Regel 3:

	=Inleiding=		=Inleiding=
	~~Volgt~~. ~~Met bijvoorbeeld~~ een ~~link naar~~ MedMij op de ~~Nictiz~~-~~website~~.		Hieronder staan de informatiestandaarden die Nictiz ontwikkelt en beheert voor gebruik binnen [https://medmij.nl/ MedMij]. Welke versie van een informatiestandaard er gebruikt dient te worden, wordt bepaald door de MedMij-gegevensdienst die in [https://afsprakenstelsel.medmij.nl/display/MMCatalogus/Actuele+Catalogus de MedMij-catalogus] vermeld staat. Elke gegevensdienst is gekoppeld aan één specifieke versie van een informatiestandaard (of meer specifiek: aan een systeemrol binnen een versie van de informatiestandaard).

	=Releases=		=Releases=

Pieter Edelman op 6 dec 2022 om 20:02

2022-12-06T20:02:13Z

← Oudere versie		Versie van 6 dec 2022 20:02
Regel 6:		Regel 6:

	=Releases=		=Releases=
	~~Hier kan een mooi stukje inleidende tekst~~ over ~~releases komen~~ te ~~staan~~.		De informatiestandaarden voor MedMij zijn gebaseerd op generieke componenten zoals zibs, SNOMED, FHIR, et cetera. Het streven is om de standaarden zoveel mogelijk op ''dezelfde'' (versies) van deze componenten te baseren, zodat oplossingen over standaarden heen te gebruiken zijn. Om deze reden worden MedMij-informatiestandaarden uitgebracht binnen een "pakketje" met gelijke ''dependencies''.

	~~==Releaseoverzicht==~~		In het overzicht hieronder is bijvoorbeeld te zien dat alle standaarden binnen MedMij 6 gebaseerd zijn op zib-publicatie 2020 en op FHIR R4. Ze gebruiken ook hetzelfde overkoepelende functionele ontwerp en dezelfde FHIR-implementatiegids. Aan de andere kant is te zien dat een oplossing ontwikkeld voor MedMij 5 niet zonder meer te gebruiken is binnen MedMij 6 omdat deze gebaseerd zijn op verschillende zib-versies, verschillende FHIR-versies, et cetera.
	In de ~~onderstaande tabel (~~meer ~~tekst volgt) ..~~.

	<table class="releases">		<table class="releases">
Regel 197:		Regel 196:

	==Versiebeleid==		==Versiebeleid==
	~~De informatiestandaarden en andere ontwerpen (zoals~~ de ~~FHIR IG) die Nictiz voor gebruik binnen MedMij publiceert zijn voorzien van een versienummer volgens~~ [https://semver.org~~/lang/nl~~/ SemVer], ~~dit is volgens het~~ [https://~~www.~~nictiz.nl/~~standaardisatie~~/duurzaam-releasebeleid/ ~~uniforme beleid~~] ~~wat Nictiz hanteert~~ voor ~~het toekennen en beheren van versies~~.		Nictiz gebruikt de [https://semver.org/ SemVer-methodiek] voor versienummers, zoals vastgelegd in [https://nictiz.nl/wat-we-doen/zorginformatiestelsel/duurzaam-releasebeleid/ het Duurzaam Releasebeleid]. Deze aanpak is bedoeld om duidelijk te maken welke versies van een product compatibel zijn met elkaar. Alle informatiestandaarden en alle deelproducten hebben een versienummer gebaseerd op SemVer. Vanaf MedMij-release 6 is deze aanpak ook doorgevoerd voor de releases zelf (de "pakketjes" met gelijke dependencies). De oudere actieve releases, die gebaseerd waren op jaartallen, hebben met terugwerkende kracht een SemVer-releasenummer gekregen: 2020.0x = 5, 2019.01 = 4.

	~~MedMij~~-~~informatiestandaarden~~ worden ~~uitgebracht als "pakketje"~~, ~~zo is makkelijk zien welke~~ MedMij-informatiestandaarden ~~compatibel~~ met ~~elkaar zijn en welke gezamenlijke afhankelijkheden (~~''~~dependencies~~''~~) ze hebben~~. ~~Deze pakketjes noemen we releases~~. ~~Vóór 2022 werden deze~~ release op ~~basis van jaartallen geversioneerd, maar daarna is~~ de ~~versioneringsstrategie~~ in ~~lijn gebracht met het uniforme beleid~~. ~~Op deze manier~~ is ~~het~~ mogelijk ~~om voorspelbaar te versioneren en nieuwe informatiestandaarden toe te voegen die compatibel zijn met huidige informatiestandaarden~~ binnen een release ~~(en~~ dus dezelfde ''~~dependencies~~'' hebben~~) zonder dat er een nieuwe ''majorversie'' geïntroduceerd wordt~~.		Deze aanpak heeft onder meer de volgende implicaties:
			* Alle versienummers bestaan uit drie getallen: ''major''.''minor''.''patch''. Wanneer er verwezen wordt naar een bepaalde versie, kan elke hogere versie met hetzelfde ''major''-nummer net zo goed gebruikt worden. [Wanneer bijvoorbeeld een gegevensdienst verwijst naar een systeemrolcode met versie '3.2', dan mag daar ook versie '3.3' of '3.4' voor gelezen worden, maar niet '3.0' of '4.1'.]
			* ''Binnen'' een release hebben informatiestandaarden elk een eigen versienummer. Dit versienummer heeft geen directe relatie met het versienummer van de overkoepelende MedMij-release; informatiestandaarden hebben binnen de kaders van een release hun eigen levenscyclus en ontwikkeltempo. Het versienummer heeft ook geen relatie met de versie van het MedMij-Afsprakenstelsel.
			* Een versienummer kan een toevoeging hebben in de vorm van '-alfa.x', '-beta.x' of '-rc.x'. Dit betekent dat de versie nog niet stabiel is. Informatiestandaarden zijn dan ook nog niet opgenomen in een MedMij-gegevensdienst.
			* Tijdens de levensduur van een release kunnen nieuwe (versies van) informatiestandaarden worden toegevoegd. Dit heeft per definitie geen invloed op de reeds aanwezige standaarden binnen de release. Informatiestandaarden kunnen ook binnen een release worden uitgefaseerd.
			* Er kan geen nieuwe informatiestandaard geïntroduceerd worden in een publicatie wanneer de dependency's niet compatibel zijn. Dat zal pas kunnen bij een andere MedMij-release.
			* Het is in principe wél mogelijk dat verschillende incompatibele versies van dezelfde informatiestandaard binnen een release worden opgenomen, dus met met verschillende majorversies. Zolang ze wel dezelfde ''dependency's'' hebben.

	Oudere releases, genummerd met jaartallen, hebben met terugwerkende kracht een SemVer-releasenummer gekregen: 2020.0x = 5, 2019.01 = 4 en zo voorts. De eerste release volgens het nieuwe beleid is dus release 6.		Welke versie van een informatiestandaard er gebruikt moet worden, wordt bepaald door de MedMij-gegevensdienst die in de MedMij-catalogus vermeld staat. Elke gegevensdienst is gekoppeld aan één specifieke versie van een informatiestandaard (of meer specifiek, naar een systeemrol binnen een versie van de informatiestandaard).

	Welke versie van een informatiestandaard er gebruikt moet worden, wordt bepaald door de MedMij-gegevensdienst die in ~~[https://afsprakenstelsel.medmij.nl/display/MMCatalogus/Actuele+gegevensdiensten~~ de MedMij-catalogus] vermeld staat. Elke gegevensdienst is gekoppeld aan één specifieke versie van een informatiestandaard (of meer specifiek, naar een systeemrol binnen een versie van de informatiestandaard).

	==Gearchiveerde releases==		==Gearchiveerde releases==
	~~MedMij-releases en de daarbij behorende informatiestandaarden~~ worden ~~na een bepaalde tijd buiten gebruik gesteld en gearchiveerd, dit hangt samen met de einddatum~~ van ~~de gegevensdiensten in de MedMij-catalogus~~. ~~De laatst buiten gebruik gestelde release~~ blijft beschikbaar in het releaseoverzicht~~, de oudere releases zijn te zien in het onderstaande overzicht~~. ~~Gearchiveerde releases blijven~~ beschikbaar ~~maar zijn niet meer geschikt voor implementatie en uitwisseling~~.		Informatiestandaarden worden aan het eind van hun levensduur uitgefaseerd. Voor historisch inzicht blijft de voorlaatste actieve versie beschikbaar in het releaseoverzicht. Eerdere versies van informatiestandaarden worden alleen nog als zip-archief beschikbaar gesteld.

	{{Collapse top\|bg=#D7D2CB\|Gearchiveerde releases}}		{{Collapse top\|bg=#D7D2CB\|Gearchiveerde releases}}

Niek van Galen: Gekopieerd van MedMij:Vissue-MMTM-976/Landingspagina MedMij, versie 142705

2022-11-11T06:54:28Z

Gekopieerd van MedMij:Vissue-MMTM-976/Landingspagina MedMij, versie 142705

Nieuwe pagina

__NOINDEX__
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard MedMij.svg|100px|rechts|link=]]

=Inleiding=
Volgt. Met bijvoorbeeld een link naar MedMij op de Nictiz-website.

=Releases=
Hier kan een mooi stukje inleidende tekst over releases komen te staan.

==Releaseoverzicht==
In de onderstaande tabel (meer tekst volgt) ...

<table class="releases">
<tr class="greylinebottom">
<th class="grey"></th>
<th class="orange" colspan="2">In ontwikkeling</th>
<th colspan="4" class="green">Actueel</th>
</tr>
<tr>
<th class="grey"></th>
<th class="greylineright">Release 7</th>
<th colspan="2" class="greylineright">Release 6</th>
<th colspan="2" class="greylineright">Release 5</th>
<th>Release 4</th>
</tr>
<tr>
<th class="grey"></th>
<th class="greylineright">7.0.0-alpha</th>
<th>6.2.0</th>
<th class="greylineright">6.1.3</th>
<th>2020.02</th>
<th class="greylineright">2020.01</th>
<th>2019.01</th>
</tr>
<tr>
<th class="grey">AllergieIntolerantie</th>
<td class="greylineright">-</td>
<td>-</td>
<td class="greylineright">-</td>
<td>-</td>
<td class="greylineright">3.0.19</td>
<td class="deprecated">[[MedMij:V2019.01_VerlopenGD|2.1.2]]</td>
</tr>
<tr>
<th class="grey">Basisgegevens GGZ</th>
<td class="greylineright">-</td>
<td>-</td>
<td class="greylineright">-</td>
<td>-</td>
<td class="greylineright">2.0.20</td>
<td class="deprecated">[[MedMij:V2019.01_VerlopenGD|1.2.2]]</td>
</tr>
<tr>
<th class="grey">Beelden</th>
<td class="greylineright">-</td>
<td>-</td>
<td class="greylineright">-</td>
<td>-</td>
<td class="greylineright">2.0.20</td>
<td class="deprecated">[[MedMij:V2019.01_VerlopenGD|1.1.2]]</td>
</tr>
<tr>
<th class="grey">BgLZ</th>
<td class="greylineright">-</td>
<td>-</td>
<td class="greylineright">-</td>
<td>3.1.1</td>
<td class="deprecatedgreylineright">2.0.19</td>
<td class="deprecated">[[MedMij:V2019.01_VerlopenGD|1.1.2]]</td>
</tr>
<tr>
<th class="grey">BgZ</th>
<td class="greylineright">-</td>
<td>4.0.0-rc</td>
<td class="greylineright">-</td>
<td>-</td>
<td class="greylineright">3.1.2</td>
<td class="deprecated">[[MedMij:V2019.01_VerlopenGD|2.2.2]]</td>
</tr>
<tr>
<th class="grey">Dossierwijzigingsverzoek</th>
<td class="greylineright">-</td>
<td>[[Vissue-MM-3503/Landingspagina_Dossierwijzigingsverzoek|1.0.3]]</td>
<td class="greylineright">[[Vissue-MM-3503/Landingspagina_Dossierwijzigingsverzoek|1.0.3]]</td>
<td>-</td>
<td class="greylineright">-</td>
<td>-</td>
</tr>
<tr>
<th class="grey">eAfspraak</th>
<td class="greylineright">-</td>
<td>-</td>
<td class="greylineright">-</td>
<td>-</td>
<td class="greylineright">2.0.20</td>
<td class="deprecated">[[MedMij:V2019.01_VerlopenGD|1.2.2]]</td>
</tr>
<tr>
<th class="grey">Huisartsgegevens</th>
<td class="greylineright">-</td>
<td>-</td>
<td class="greylineright">-</td>
<td>-</td>
<td class="greylineright">2.0.20</td>
<td class="deprecated">[[MedMij:V2019.01_VerlopenGD|1.2.2]]</td>
</tr>
<tr>
<th class="grey">Laboratoriumresultaten</th>
<td class="greylineright">-</td>
<td>-</td>
<td class="greylineright">-</td>
<td>-</td>
<td class="greylineright">2.0.20</td>
<td class="deprecated">[[MedMij:V2019.01_VerlopenGD|1.2.2]]</td>
</tr>
<tr>
<th class="grey">Medicatieproces</th>
<td class="greylineright">10.0.0-beta</td>
<td></td>
<td class="greylineright">-</td>
<td>-</td>
<td class="greylineright">-</td>
<td>9.0.7</td>
</tr>
<tr>
<th class="grey">PDF/A</th>
<td class="greylineright">-</td>
<td>-</td>
<td class="greylineright">-</td>
<td>-</td>
<td class="greylineright">3.0.20</td>
<td class="deprecated">[[MedMij:V2019.01_VerlopenGD|2.1.2]]</td>
</tr>
<tr>
<th class="grey">Vaccinaties</th>
<td class="greylineright">-</td>
<td>1.0.1</td>
<td class="greylineright">1.0.1</td>
<td>-</td>
<td class="greylineright">-</td>
<td>-</td>
</tr>
<tr>
<th class="grey">Vragenlijsten</th>
<td class="greylineright">-</td>
<td>3.0.0-rc</td>
<td class="greylineright">-</td>
<td>-</td>
<td class="greylineright">2.0.20</td>
<td class="deprecated">[[MedMij:V2019.01_VerlopenGD|1.1.2]]</td>
</tr>
<tr>
<th class="grey">Zelfmetingen</th>
<td class="greylineright">-</td>
<td>3.0.0-rc</td>
<td class="greylineright">-</td>
<td>-</td>
<td class="greylineright">2.0.20</td>
<td class="deprecated">[[MedMij:V2019.01_VerlopenGD|1.3.2]]</td>
</tr>
<tr class="dependencies">
<th>MedMij functioneel ontwerp</th>
<td class="greylineright">2.0.0-alpha</td>
<td colspan="2" class="greylineright">1.0.1</td>
<td>[[MedMij:V2020.02/Ontwerpen|2020.02]]</td>
<td class="greylineright">[[MedMij:V2020.01/Ontwerpen|2020.01]]</td>
<td class="greylineright">[[MedMij:V2019.01_Ontwerpen|2019.01]]</td>
</tr>
<tr class="dependencies">
<th>Zib-publicatie</th>
<td class="greylineright">2023</td>
<td colspan="2" class="greylineright">[https://zibs.nl/wiki/ZIB_Publicatie_2020(NL) 2020]</td>
<td colspan="3">[https://zibs.nl/wiki/ZIB_Publicatie_2017(NL) 2017]</td>
</tr>
<tr class="dependencies">
<th>FHIR-versie</th>
<td colspan="3" class="greylineright">[https://www.hl7.org/fhir/r4/ R4]</td>
<td colspan="3">[https://www.hl7.org/fhir/stu3/ STU3]</td>
</tr>
<tr class="dependencies">
<th>MedMij FHIR IG</th>
<td class="greylineright">2.0.0-alpha</td>
<td colspan="2" class="greylineright">1.0.2</td>
<td>[[MedMij:V2020.02/FHIR_IG|2020.02]]</td>
<td class="greylineright">[[MedMij:V2020.01/FHIR_IG|2020.01]]</td>
<td>[[MedMij:V2019.01_FHIR_IG|2019.01]]</td>
</tr>
<tr class="dependencies">
<th>MedMij-kwalificatiepagina</th>
<td class="greylineright">2.0.0-alpha</td>
<td colspan="2" class="greylineright">1.0.1</td>
<td>[[MedMij:V2020.02/Kwalificatie|2020.02]]</td>
<td class="greylineright">[[MedMij:V2020.01/Kwalificatie|2020.01]]</td>
<td>[[MedMij:V2019.01_Kwalificatie|2019.01]]</td>
</tr>
</table>

==Versiebeleid==
De informatiestandaarden en andere ontwerpen (zoals de FHIR IG) die Nictiz voor gebruik binnen MedMij publiceert zijn voorzien van een versienummer volgens [https://semver.org/lang/nl/ SemVer], dit is volgens het [https://www.nictiz.nl/standaardisatie/duurzaam-releasebeleid/ uniforme beleid] wat Nictiz hanteert voor het toekennen en beheren van versies.

MedMij-informatiestandaarden worden uitgebracht als "pakketje", zo is makkelijk zien welke MedMij-informatiestandaarden compatibel met elkaar zijn en welke gezamenlijke afhankelijkheden (''dependencies'') ze hebben. Deze pakketjes noemen we releases. Vóór 2022 werden deze release op basis van jaartallen geversioneerd, maar daarna is de versioneringsstrategie in lijn gebracht met het uniforme beleid. Op deze manier is het mogelijk om voorspelbaar te versioneren en nieuwe informatiestandaarden toe te voegen die compatibel zijn met huidige informatiestandaarden binnen een release (en dus dezelfde ''dependencies'' hebben) zonder dat er een nieuwe ''majorversie'' geïntroduceerd wordt.

Oudere releases, genummerd met jaartallen, hebben met terugwerkende kracht een SemVer-releasenummer gekregen: 2020.0x = 5, 2019.01 = 4 en zo voorts. De eerste release volgens het nieuwe beleid is dus release 6.

Welke versie van een informatiestandaard er gebruikt moet worden, wordt bepaald door de MedMij-gegevensdienst die in [https://afsprakenstelsel.medmij.nl/display/MMCatalogus/Actuele+gegevensdiensten de MedMij-catalogus] vermeld staat. Elke gegevensdienst is gekoppeld aan één specifieke versie van een informatiestandaard (of meer specifiek, naar een systeemrol binnen een versie van de informatiestandaard).

==Gearchiveerde releases==
MedMij-releases en de daarbij behorende informatiestandaarden worden na een bepaalde tijd buiten gebruik gesteld en gearchiveerd, dit hangt samen met de einddatum van de gegevensdiensten in de MedMij-catalogus. De laatst buiten gebruik gestelde release blijft beschikbaar in het releaseoverzicht, de oudere releases zijn te zien in het onderstaande overzicht. Gearchiveerde releases blijven beschikbaar maar zijn niet meer geschikt voor implementatie en uitwisseling.

{{Collapse top|bg=#D7D2CB|Gearchiveerde releases}}
'''Release 3'''
*Functionele ontwerpen
**[[MedMij:V2018.06_Ontwerpen|2018.06]]
**[[MedMij:V2018.05_Ontwerpen|2018.05]]
**[[MedMij:V2018.04_Ontwerpen|2018.04]]
**[[MedMij:V2018.03_Ontwerpen|2018.03]]
**[[MedMij:V2018.02_Ontwerpen|2018.02]]
**[[MedMij:V2018.01_Ontwerpen|2018.01]]
*Technische ontwerpen
**[[MedMij:V2018.06_FHIR_IG|2018.06]]
**[[MedMij:V2018.05_FHIR_IG|2018.05]]
**[[MedMij:V2018.04_FHIR_IG|2018.04]]
**[[MedMij:V2018.03_FHIR_IG|2018.03]]
**[[MedMij:V2018.02_FHIR_IG|2018.02]]
**[[MedMij:V2018.01_FHIR_IG|2018.01]]

'''Release 2'''
*Functionele ontwerpen
**[[MedMij:V2017.04_Ontwerpen|2017.04]]
**[[MedMij:V2017.03_Ontwerpen|2017.03]]
**[[MedMij:V2017.02_Ontwerpen|2017.02]]
**[[MedMij:V2017.01_Ontwerpen|2017.01]]
*Technische ontwerpen
**[[MedMij:v2017.04_FHIR_IG|2017.04]]
**[[MedMij:v2017.03_FHIR_IG|2017.03]]
**[[MedMij:v2017.01_FHIR_IG|2017.01]]

'''Release 1'''
*[[MedMij:V1.0_Standards|1.0]]
{{Collapse bottom}}

=Kwalificatie=
Op MedMij-informatiestandaarden zijn Nictiz-kwalificaties van toepassing. Kwalificatie vindt plaats per systeemrol.

Kwalificatiescripts en meer informatie over de kwalificatie is te vinden op de kwalificatiepagina: ...

=Ondersteuning=
Hier komt een verwijzing naar BITS voor ondersteuning en wijzigingsverzoeken.