HL7v3 Templating Guidelines - Bewerkingsoverzicht

Wetering: /* Template id's */

2021-06-16T08:37:32Z

Template id's

← Oudere versie		Versie van 16 jun 2021 08:37
Regel 3:		Regel 3:

	== Template id's ==		== Template id's ==
	Hoe template id's te gebruiken staat beschreven in een document dat gepubliceerd is door HL7. Dit document is voor Nictiz medewerkers te vinden via [https://nictiznl.sharepoint.com/:b:/r/sites/~~HL7Team~~/Gedeelde%20documenten/~~General/HL7v3~~/HL7_TEMPLATES_R1_2018MAY.pdf?csf=1&web=1&e=~~n2rxQL~~ SharePoint] en hierbij ook een [http://www.hl7.org/documentcenter/private/standards/HL7_TEMPLATES_R1_2018MAY.pdf locatie op internet].		Hoe template id's te gebruiken staat beschreven in een document dat gepubliceerd is door HL7. Dit document is voor Nictiz medewerkers te vinden via [https://nictiznl.sharepoint.com/:b:/r/sites/Standaarden/Gedeelde%20%20documenten/HL7/HL7_TEMPLATES_R1_2018MAY.pdf?csf=1&web=1&e=QIKlg3 SharePoint] en hierbij ook een [http://www.hl7.org/documentcenter/private/standards/HL7_TEMPLATES_R1_2018MAY.pdf locatie op internet].

	Het meest relevante stuk tekst staat in §2.13 van dat document.		Het meest relevante stuk tekst staat in §2.13 van dat document.

Wetering: /* Template id's */

2021-06-16T08:35:08Z

Template id's

← Oudere versie		Versie van 16 jun 2021 08:35
Regel 17:		Regel 17:

	'''3.4.8 Backwards compatibility'''		'''3.4.8 Backwards compatibility'''

	Indicates that a template is considered to be backward compatible to a previous version of the template. A template version is backwards compatible if all instances of data which are compliant under the prior version also are compliant under the new version.		Indicates that a template is considered to be backward compatible to a previous version of the template. A template version is backwards compatible if all instances of data which are compliant under the prior version also are compliant under the new version.
	Determining true backward compatibility can be complex. A new version of a template defined as “open” may reject instances constructed using the older version as “open”, which means other elements are allowed in an instance beyond those explicitly defined. In other words, older instances may contain legal additional input that fails to validate against a newer version of the template. On the other hand loosening constraints would generally be backward compatible.		Determining true backward compatibility can be complex. A new version of a template defined as “open” may reject instances constructed using the older version as “open”, which means other elements are allowed in an instance beyond those explicitly defined. In other words, older instances may contain legal additional input that fails to validate against a newer version of the template. On the other hand loosening constraints would generally be backward compatible.
Regel 22:		Regel 23:

	'''3.4.9 Forward compatibility'''		'''3.4.9 Forward compatibility'''

	This relationship indicates that a template version is compatible with a newer version of the template. Forward compatibility means that an instances of data created under the newer template can be used with applications designed to work with data created under the prior template.. Instances conforming to the new template should also conform to all the old templates.		This relationship indicates that a template version is compatible with a newer version of the template. Forward compatibility means that an instances of data created under the newer template can be used with applications designed to work with data created under the prior template.. Instances conforming to the new template should also conform to all the old templates.

Wetering: /* Template id's */

2021-06-16T08:34:48Z

Template id's

← Oudere versie		Versie van 16 jun 2021 08:34
Regel 21:		Regel 21:
	True backward compatibility can be determined more reliably with templates defined as “closed” only		True backward compatibility can be determined more reliably with templates defined as “closed” only

	3.4.9 Forward compatibility~~'''Vetgedrukte tekst~~'''		'''3.4.9 Forward compatibility'''
	This relationship indicates that a template version is compatible with a newer version of the template. Forward compatibility means that an instances of data created under the newer template can be used with applications designed to work with data created under the prior template.. Instances conforming to the new template should also conform to all the old templates.		This relationship indicates that a template version is compatible with a newer version of the template. Forward compatibility means that an instances of data created under the newer template can be used with applications designed to work with data created under the prior template.. Instances conforming to the new template should also conform to all the old templates.

Wetering: /* 3.4.9 Forward compatibility */

2021-06-16T08:34:15Z

3.4.9 Forward compatibility

← Oudere versie		Versie van 16 jun 2021 08:34
Regel 21:		Regel 21:
	True backward compatibility can be determined more reliably with templates defined as “closed” only		True backward compatibility can be determined more reliably with templates defined as “closed” only

	~~===~~3.4.9 Forward compatibility~~===~~		3.4.9 Forward compatibility'''Vetgedrukte tekst'''
	This relationship indicates that a template version is compatible with a newer version of the template. Forward compatibility means that an instances of data created under the newer template can be used with applications designed to work with data created under the prior template.. Instances conforming to the new template should also conform to all the old templates.		This relationship indicates that a template version is compatible with a newer version of the template. Forward compatibility means that an instances of data created under the newer template can be used with applications designed to work with data created under the prior template.. Instances conforming to the new template should also conform to all the old templates.

Wetering: /* 3.4.8 Backwards compatibility */

2021-06-16T08:34:04Z

3.4.8 Backwards compatibility

← Oudere versie		Versie van 16 jun 2021 08:34
Regel 16:		Regel 16:
	En dan §3.4.8 en §3.4.9 over backward en forward compatibility.		En dan §3.4.8 en §3.4.9 over backward en forward compatibility.

	~~===~~3.4.8 Backwards compatibility~~===~~		'''3.4.8 Backwards compatibility'''
	Indicates that a template is considered to be backward compatible to a previous version of the template. A template version is backwards compatible if all instances of data which are compliant under the prior version also are compliant under the new version.		Indicates that a template is considered to be backward compatible to a previous version of the template. A template version is backwards compatible if all instances of data which are compliant under the prior version also are compliant under the new version.
	Determining true backward compatibility can be complex. A new version of a template defined as “open” may reject instances constructed using the older version as “open”, which means other elements are allowed in an instance beyond those explicitly defined. In other words, older instances may contain legal additional input that fails to validate against a newer version of the template. On the other hand loosening constraints would generally be backward compatible.		Determining true backward compatibility can be complex. A new version of a template defined as “open” may reject instances constructed using the older version as “open”, which means other elements are allowed in an instance beyond those explicitly defined. In other words, older instances may contain legal additional input that fails to validate against a newer version of the template. On the other hand loosening constraints would generally be backward compatible.
	True backward compatibility can be determined more reliably with templates defined as “closed” only		True backward compatibility can be determined more reliably with templates defined as “closed” only

	===3.4.9 Forward compatibility===		===3.4.9 Forward compatibility===
	This relationship indicates that a template version is compatible with a newer version of the template. Forward compatibility means that an instances of data created under the newer template can be used with applications designed to work with data created under the prior template.. Instances conforming to the new template should also conform to all the old templates.		This relationship indicates that a template version is compatible with a newer version of the template. Forward compatibility means that an instances of data created under the newer template can be used with applications designed to work with data created under the prior template.. Instances conforming to the new template should also conform to all the old templates.

Wetering: Added international sections on backward and forward compatibility

2021-06-16T08:33:41Z

Added international sections on backward and forward compatibility

← Oudere versie		Versie van 16 jun 2021 08:33
Regel 13:		Regel 13:
	* Containment of other templates		* Containment of other templates
	* Backward compatibility invalidation (see also section 3.4.8 about “backward compatibility”).		* Backward compatibility invalidation (see also section 3.4.8 about “backward compatibility”).

			En dan §3.4.8 en §3.4.9 over backward en forward compatibility.

			===3.4.8 Backwards compatibility===
			Indicates that a template is considered to be backward compatible to a previous version of the template. A template version is backwards compatible if all instances of data which are compliant under the prior version also are compliant under the new version.
			Determining true backward compatibility can be complex. A new version of a template defined as “open” may reject instances constructed using the older version as “open”, which means other elements are allowed in an instance beyond those explicitly defined. In other words, older instances may contain legal additional input that fails to validate against a newer version of the template. On the other hand loosening constraints would generally be backward compatible.
			True backward compatibility can be determined more reliably with templates defined as “closed” only
			===3.4.9 Forward compatibility===
			This relationship indicates that a template version is compatible with a newer version of the template. Forward compatibility means that an instances of data created under the newer template can be used with applications designed to work with data created under the prior template.. Instances conforming to the new template should also conform to all the old templates.

	== Template associaties ==		== Template associaties ==

Wetering: /* TODO lijst */

2021-03-04T17:17:54Z

TODO lijst

← Oudere versie		Versie van 4 mrt 2021 17:17
Regel 29:		Regel 29:
	== TODO lijst ==		== TODO lijst ==

	Hier volgt uitleg over ~~template-id’s,~~ naamgeving~~, wanneer een nieuwe/eigen template en wanneer niet~~, relatie tussen het hl7 algemene model en de invulling voor de informatiestandaard (verplichte waarden t.o.v. zib/datasetspec), infraonafhankelijkheid, gebruik van een CDA component of een entry, verplicht gebruik van html, …		Hier volgt uitleg over naamgeving, relatie tussen het hl7 algemene model en de invulling voor de informatiestandaard (verplichte waarden t.o.v. zib/datasetspec), infraonafhankelijkheid, gebruik van een CDA component of een entry, verplicht gebruik van html, …

Wetering: /* Template associaties */

2021-01-21T17:42:08Z

Template associaties

← Oudere versie		Versie van 21 jan 2021 17:42
Regel 25:		Regel 25:
	** het kan ook nodig zijn om een dergelijk concept te associëren met een attribuut, denk aan @negationInd		** het kan ook nodig zijn om een dergelijk concept te associëren met een attribuut, denk aan @negationInd
	* Een dataset concept van type 'datum' of 'datumtijd' associeer je meestal met een HL7 XML element van type TS.		* Een dataset concept van type 'datum' of 'datumtijd' associeer je meestal met een HL7 XML element van type TS.
			* Het kan ook zijn dat de dataset de eenheid (@unit) apart heeft gedefinieerd omdat er een waardelijst aan moest worden gehangen. Eigenlijk is het datatype 'hoeveelheid' dan handmatig gemaakt met een getal en een bijbehorend concept van type code. In dat geval associeer je die losse concepten met de @value en @unit attributen van het bijbehorende HL7 concept van type PQ.

	== TODO lijst ==		== TODO lijst ==

	Hier volgt uitleg over template-id’s, naamgeving, wanneer een nieuwe/eigen template en wanneer niet, relatie tussen het hl7 algemene model en de invulling voor de informatiestandaard (verplichte waarden t.o.v. zib/datasetspec), infraonafhankelijkheid, gebruik van een CDA component of een entry, verplicht gebruik van html, …		Hier volgt uitleg over template-id’s, naamgeving, wanneer een nieuwe/eigen template en wanneer niet, relatie tussen het hl7 algemene model en de invulling voor de informatiestandaard (verplichte waarden t.o.v. zib/datasetspec), infraonafhankelijkheid, gebruik van een CDA component of een entry, verplicht gebruik van html, …

Wetering: /* Templating in HL7v3 */

2021-01-21T17:39:33Z

Templating in HL7v3

← Oudere versie		Versie van 21 jan 2021 17:39
Regel 13:		Regel 13:
	* Containment of other templates		* Containment of other templates
	* Backward compatibility invalidation (see also section 3.4.8 about “backward compatibility”).		* Backward compatibility invalidation (see also section 3.4.8 about “backward compatibility”).

			== Template associaties ==
			Template associaties leggen verband tussen een dataset concept en een HL7 element of attribuut. Het dataset concept komt dus terecht in het stuk HL7 waarnaar een connectie wordt gelegd.
			Deze associaties kunnen zowel op een XML element als een XML attribuut gelegd worden. Het heeft daarbij in principe de voorkeur dit te doen op het element, maar soms is er geen keuze en moet de associatie gelegd worden naar een attribuut.

			Voorbeelden:
			* Een dataset concept van type 'code' associeer je meestal met een HL7 XML element van type CD. Beide types kennen onderliggende kenmerken/attributen als code, codeSystem, displayName et cetera.
			* Een dataset concept van type 'hoeveelheid' associeer je meestal met een HL7 XML element van type PQ. Beide types kennen onderliggende kenmerken/attributen als value en unit.
			* Een dataset concept van type 'boolean':
			** kan je associeren met een HL7 XML element van type BL
			** het kan ook nodig zijn om een dergelijk concept te associëren met een attribuut, denk aan @negationInd
			* Een dataset concept van type 'datum' of 'datumtijd' associeer je meestal met een HL7 XML element van type TS.


	== TODO lijst ==		== TODO lijst ==

	Hier volgt uitleg over template-id’s, naamgeving, wanneer een nieuwe/eigen template en wanneer niet, relatie tussen het hl7 algemene model en de invulling voor de informatiestandaard (verplichte waarden t.o.v. zib/datasetspec), infraonafhankelijkheid, gebruik van een CDA component of een entry, verplicht gebruik van html, …		Hier volgt uitleg over template-id’s, naamgeving, wanneer een nieuwe/eigen template en wanneer niet, relatie tussen het hl7 algemene model en de invulling voor de informatiestandaard (verplichte waarden t.o.v. zib/datasetspec), infraonafhankelijkheid, gebruik van een CDA component of een entry, verplicht gebruik van html, …

Wetering: Link naar HL7 document toegevoegd.

2021-01-11T17:17:08Z

Link naar HL7 document toegevoegd.

← Oudere versie		Versie van 11 jan 2021 17:17
Regel 3:		Regel 3:

	== Template id's ==		== Template id's ==
	Hoe template id's te gebruiken staat beschreven in een document dat gepubliceerd is door HL7. Dit document is voor Nictiz medewerkers te vinden via [https://nictiznl.sharepoint.com/:b:/r/sites/HL7Team/Gedeelde%20documenten/General/HL7v3/HL7_TEMPLATES_R1_2018MAY.pdf?csf=1&web=1&e=n2rxQL SharePoint].		Hoe template id's te gebruiken staat beschreven in een document dat gepubliceerd is door HL7. Dit document is voor Nictiz medewerkers te vinden via [https://nictiznl.sharepoint.com/:b:/r/sites/HL7Team/Gedeelde%20documenten/General/HL7v3/HL7_TEMPLATES_R1_2018MAY.pdf?csf=1&web=1&e=n2rxQL SharePoint] en hierbij ook een [http://www.hl7.org/documentcenter/private/standards/HL7_TEMPLATES_R1_2018MAY.pdf locatie op internet].

	Het meest relevante stuk tekst staat in §2.13 van dat document.		Het meest relevante stuk tekst staat in §2.13 van dat document.