HL7v3 Templating Guidelines

Templating in HL7v3

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 SharePoint en hierbij ook een locatie op internet.

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

When does a new design represent a new template as opposed to a new version of an existing template? If the intent/purpose of the template changes substantially or the design of template is substantively different, a new template needs to be created. Typical situations where a new template is required include:

• Different purpose, where the difference can be either a narrower or broader purpose from an existing template’s definition, or a substantively different purpose
• Value Set Bindings,
• Cardinality / conformance of template elements,
• Containment of other templates
• 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.
• 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

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, …