Terug naar index  <<  Terug naar templates

draft Template  QueryByParameter - QUMT_MT900008NL02

Id 2.16.840.1.113883.2.4.3.111.3.10.10.8 Ingangsdatum 2024‑05‑28 15:48:53
Andere versies met dit id:
Status draft Ontwerp Versielabel
Naam QueryByParameter-QUMT_MT900008NL Weergavenaam QueryByParameter - QUMT_MT900008NL02
Omschrijving
FAQ: Welke parameters zijn bestemd voor gebruik door ZIM ten behoeve van efficiënt routeren van indirecte vraagberichten? – "Patiënt-id", "Actualiteit", "Beheerverantwoordelijke"en eventueel een "Gegevenssoort" code die specifieker is dan welke afleidbaar is uit het interactie-id. Een toepassing dient te specificeren welke van de door de toepassing gespecificeerde filterparameters mappen op deze concepten. In het verleden zijn er geen afspraken gemaakt over filterparameternaamgeving en zijn ook vaak internationaal geaccepteerde vraagberichten overgenomen. Dat maakt generieke interpretatie door de ontvanger lastiger. Nieuwe vraagberichten moeten zich aan de volgende conventie houden, waarbij geldt dat het vraagbericht niet noodzakelijk alle vraagparameters moet ondersteunen: er mag echter geen vraagparameter zijn met dezelfde functie als een van de onderstaande vraagparameters, maar onder een andere naam. Internationale vraagberichten moeten worden aangepast op deze lijst alvorens ze binnen Nederland toe te passen:
  • actReferenceCreationTime – voor een filterparameter op basis van gegevens met een aanmaaktijd binnen de opgegeven periode, los van de actualiteit in VWI. Gegevens met een aanmaaktijd in GBZ binnen de opgegeven periode worden opgeleverd. Merk op dat ZIM hier alleen op kan filteren indien de aanmaaktijd van het gegeven is geregistreerd in de VWI. Datatype is IVL<TS>;
  • actReferenceLastUpdateTime – voor een filterparameter op basis van gegevens die zijn gewijzigd binnen de opgegeven periode, los van de actualiteit VWI. Indexgegevens met een laatste bijwerktijd GBZ binnen de opgegeven periode worden opgeleverd. Merk op dat ZIM hier alleen op kan filteren indien de aanmaaktijd van het gegeven is geregistreerd in de VWI. Datatype is IVL<TS>;
  • authorId - voor een filterparameter op basis van Author-id met datatype II. Het gaat hier om de auteur/inhoudverantwoordelijke van het gegeven. Auteurs worden normalerwijs geïdentificeerd met hun UZI-nummer (OID: 2.16.528.1.1007.3.1);
  • authorRoleCode - voor een filterparameter op basis van Author-role code met datatype CV. Het gaat hier om de UZI-rolcode (OID: 2.16.840.1.113883.2.4.15.111) van de auteur/inhoudverantwoordelijke van het gegeven;
  • patientId – voor een filterparameter op basis van Patiënt-id met datatype II. Patiënten worden normalerwijs geïdentificeerd met hun burgerservicenummer (OID: 2.16.840.1.113883.2.4.6.3);
  • custodianApplicationId – voor een filterparameter op basis van Beherende-applicatie-id met datatype II. Beherende applicaties zijn normalerwijs AORTA-applicaties (OID: 2.16.840.1.113883.2.4.6.6);
  • custodianId – voor een filterparameter op basis van Beherende-zorgverlener-id met datatype II. Het gaat hier om de beheerverantwoordelijke persoon voor het gegeven. Beheerverantwoordelijken worden normalerwijs geïdentificeerd met hun UZI-nummer (OID: 2.16.528.1.1007.3.1);
  • custodianOrganizationId – voor een filterparameter op basis van Beherende-organisatie-id met datatype II. Het gaat hier om de beheerverantwoordelijke organisatie voor het gegeven. Organisaties worden normalerwijs geïdentificeerd met hun UZI-registerabonneenummer (OID:2.16.528.1.1007.3.3): als andere organisatietypen ook bronsysteem kunnen zijn voor bepaalde gegevens dan worden er ook andere typen identificatie van toepassing;
  • registrationProcessCreationTime – voor een filterparameter op basis van indexgegevens die zijn aangemeld binnen de opgegeven periode, los van de actualiteit van de indexgegevens zelf. Indexgegevens met een eerste aanmelddatum in VWI binnen de opgegeven periode worden opgeleverd. Datatype is IVL<TS>;
  • registrationProcessLastUpdateTime – voor een filterparameter op basis van indexgegevens die zijn gewijzigd binnen de opgegeven periode, los van de actualiteit van de indexgegevens zelf. Indexgegevens met een laatste bijwerktijd in VWI binnen de opgegeven periode worden opgeleverd. Datatype is IVL<TS>;
  • registrationProcessActCode – voor een filterparameter op basis van Gegevenssoort met datatype CV. Gegevenssoorten komen uit valueset ActRegistryCode: x_DataDomainNL waarin codes uit verschillende codesystemen voorkomen.

Meerdere parameter-elementen moeten worden verwerkt als logische AND terwijl meerdere value elementen binnen een parameter moeten worden verwerkt als een logische OR.

Classificatie HL7v3 Payload level template
Open/gesloten Open (ook andere dan gedefinieerde elementen zijn toegestaan)
Koppelingen met
Koppelingen met 4 concepten
Id Naam Dataset
abr-dataelement-1 final Abonnement final Abonnementenregister
abr-dataelement-11 final Abonnementaanvrager final Abonnementenregister
abr-dataelement-2 final Abonnement-id final Abonnementenregister
abr-dataelement-8 final Abonnee final Abonnementenregister
Gebruikt door / Gebruikt
Gebruikt door 0 transacties en 2 templates, Gebruikt 1 template
Gebruikt door als Naam Versie
2.16.840.1.113883.2.4.3.111.3.10.10.9 Inclusie draft QUQI_MT021001 - QUMT_MT900008NL02 2024‑05‑28 15:55:06
2.16.840.1.113883.2.4.3.111.3.10.10.7 link draft QUMT_IN900008NL02 2024‑05‑22 11:12:36
Gebruikt als Naam Versie
2.16.840.1.113883.2.4.3.111.3.7.10.2 Inclusie draft Registreren Abonnement DYNAMISCH
Relatie Specialisatie: template 2.16.840.1.113883.2.4.3.111.3.7.10.5 QueryByParameter - QUMT_MT900008NL (2021‑12‑09 13:35:12)
Versie: template 2.16.840.1.113883.2.4.3.111.3.7.10.5 QueryByParameter - QUMT_MT900008NL (2017‑04‑06 10:14:26)
Specialisatie: template 2.16.840.1.113883.2.4.3.11.60.102.10.505 QueryByParameter Stub (2012‑09‑01)
ref
hl7m-
Voorbeeld
Voorbeeld
<queryByParameter>
  <queryId extension="extdummy" root="1.2.3.4.5"/>  <statusCode code="executing"/>  <responseModalityCode code="B"/>  <responsePriorityCode code="I"/>  <executionAndDeliveryTime value="20130102100000"/>  <patientId>
    <value extension="123456782" root="2.16.840.1.113883.2.4.6.3"/>  </patientId>  <!-- ParameterX -->
  <!-- ParameterY -->
</queryByParameter>
Item DT Card Conf Omschrijving Label
hl7:queryByParameter
 		Bevat de kenmerken van de vraag (Quedots8NL)
 
target
abr-dataelement-1 final Abonnement final Abonnementenregister
abr-dataelement-11 final Abonnementaanvrager final Abonnementenregister
abr-dataelement-8 final Abonnee final Abonnementenregister
  Schematron assert role orange warning  
  test not(.//hl7:semanticsText)  
  Melding Control Act: het element semanticsText onder queryparameters bij voorkeur niet gebruiken  
  Schematron assert role red error  
  test not(hl7:sortControl)  
  Melding Control Act: queryByParameter/sortControl mag niet gebruikt worden  
hl7:queryId
 		II 1 … 1 M Bevat de unieke identificatie van de vraag zoals geformuleerd in de vragende applicatie, los van de identificatie van de interactie waarin de vraag wordt aangeboden. De waarde van dit attribuut wordt in het antwoord teruggeleverd, zodat de antwoordberichten kunnen worden gerelateerd aan de vraag. De OID voor het identificatiesysteem kan bijvoorbeeld worden afgeleid van de URA van de zorgaanbieder, het AORTA applicatie-id, maar dit is geen verplichting. Iedere OID die voldoet aan het principe van uniekheid is geldig. (Quedots8NL)
 
target
abr-dataelement-2 final Abonnement-id final Abonnementenregister
  Constraint Deze identificatie is uniek en kan nooit nogmaals worden uitgedeeld, noch door dezelfde applicatie, noch door een andere applicatie. Het identificatiesysteem waaruit de vraagidentificaties worden gegenereerd wordt geïdentificeerd door een OID in het attribuut @root. Het attribuut @extension moet de gegenereerde identificatie bevatten.
hl7:statusCode
 		CS (required) 1 … 1 M Bevat de (nieuwe) status van de query. De te gebruiken waarden in dit attribuut zijn gedefinieerd in de valueset QueryStatusCode. (Quedots8NL)
  Constraint @code moet bij initiële vragen de waarde "executing" bevatten.
  CONF
De waarde van @code moet komen uit waardelijst 2.16.840.1.113883.1.11.18899 QueryStatusCode (2011‑07‑26)
hl7:modifyCode
 		CS (required) 0 … 1 Alleen relevant bij gebruik van het publish/subscribe mechanisme zoals in Signaleringen. Geeft aan of het abonnement (indien het vraagbericht als onderdeel van een publish/subscribe mechanisme gebruikt wordt) nieuw is ("N") dan wel gewijzigd wordt ("M"). De waarden van dit attribuut zijn afkomstig uit de vocabulaire ModifyIndicator. (Quedots8NL)
  CONF
De waarde van @code moet komen uit waardelijst 2.16.840.1.113883.1.11.395 ModifyIndicator (2011‑07‑26)
hl7:responseModalityCode
 		CS (required) 1 … 1 M Bevat code voor opleverwijze. Verplicht in AORTA met als mogelijkheden "gebundeld" (B - van toepassing bij indirect opvragen via de ZIM waarbij gebundeld moet worden opgeleverd), of "discreet" (R - van toepassing bij direct opvragen bij het bronsysteem, alle vragen van de ZIM bevatten deze opleverwijze.) (Quedots8NL)
  Constraint
  • Indien de interactie van het type indirect opvragen is, en de interactie gaat van een GBx naar de ZIM, dan moet @code de waarde "B" bevatten.
  • Indien de interactie van het type indirect opvragen is, en de interactie gaat van ZIM naar een GBx, dan moet @code de waarde "R" bevatten.
  • Indien de interactie van het type direct opvragen is, dan moet @code de waarde "R" bevatten.
  CONF
De waarde van @code moet komen uit waardelijst 2.16.840.1.113883.1.11.394 ResponseModality (2011‑07‑26)
hl7:responsePriorityCode
 		CS (required) 1 … 1 M Bevat de code voor oplevertiming. De standaardwaarde is "I" (Immediate) voor synchrone, directe beantwoording. Merk op dat ook het tijdstip van beantwoording van de vraag in het vraagbericht zelf kan worden beïnvloed: zie de beschrijving van executionAndDeliveryTime. (Quedots8NL)
  CONF
De waarde van @code moet komen uit waardelijst 2.16.840.1.113883.1.11.91 QueryPriority (2011‑07‑26)
hl7:initialQuantity
 		INT 0 … 1 (Quedots8NL)
hl7:initialQuantityCode
 		CE (extensible) 0 … 1 (Quedots8NL)
  CONF
De waarde van @code moet indien mogelijk komen uit waardelijst 2.16.840.1.113883.1.11.19911 QueryRequestLimit (2011‑07‑26)
hl7:executionAndDeliveryTime
 		TS 0 … 1 C Bevat het tijdstip waarop het antwoord uiterlijk moet zijn opgeleverd aan het vragende systeem. Het tijdstip wordt relatief aan de aanmaaktijd van de interactie. Het verschil tussen de twee tijdstippen moet liggen tussen de configuratieparameter responsetijd-ZIM (zie [Config inst]) en 60 seconden. Bij afwezigheid van het element executionAndDeliveryTime geldt maximale oplevertimeout zoals beschreven in de Programma’s van Eisen.

FAQ: Hoe bepaalt een zender van een ‘Immediate’ vraagbericht een redelijke waarde voor de oplevertimeout?
- De complexiteit of grootte van het verwachte antwoord is van invloed op het op te geven tijdstip. Indien een volledig overzicht van de medicatiehistorie van een patiënt opgevraagd wordt, dan ligt een ruimere timeout voor de hand dan bij het opvragen van één laboratoriumuitslag.

(Quedots8NL)
  Constraint
  • @value moet de maximale timeout bevatten, indien de toepassing voor de betreffende interactie specificeert dat een maximale timeout moet kunnen worden opgegeven, en deze in de zendende applicatie ook werkelijk een waarde heeft.
  • @value moet, indien deze een waarde heeft, tenminste tot op de minuut nauwkeurig worden opgegeven.
  • Het verschil tussen executionAndDeliveryTime/@value en Message/creationTime/@value moet, indien beide een waarde hebben, liggen tussen responsetijd-ZIM en 60 seconden.
Inclusie van 2.16.840.1.113883.2.4.3.111.3.7.10.2 Registreren Abonnement (DYNAMISCH)
Dit is een voorbeeldparameter, maar een vraagbericht moet exact deze parameter ondersteunen indien het patiëntgebonden vraag is.
hl7:assignedDeviceId
 		0 … 1 Identificatie van de applicatie in het geval dat het abonnement geregistreerd wordt voor een andere applicatie dan de applicatie vanwaar het registratieverzoek wordt verstuurd. (Quedots8NL)
Inclusie 1 … 1 M van 2.16.840.1.113883.2.4.3.111.3.4.10.2 AORTA Application ID Value (2017‑07‑25 14:24:11)
Bevat de waarde van de parameter assignedDeviceId – applicatie-id (anders dan de zendende applicatie)
hl7:value
 		II 1 … 1 M AORTA Applicatie-id (Quedots8NL)
@extension
 		st 1 … 1 R Bevat het applicatie-id
@root
 		uid 1 … 1 F 2.16.840.1.113883.2.4.6.6
hl7:effectiveTime
 		0 … 1 Geldigheidsperiode van het abonnement. (Quedots8NL)
  Constraint

Dit hoeft niet gebruikt te worden als een patiënt een abonnement neemt.
hl7:value
 		IVL_TS 1 … 1 M Bevat het tijdstip van het einde van de abonnementgeldigheidsduur. (Quedots8NL)
hl7:high
 		TS 1 … 1 M (Quedots8NL)
 
target
abr-dataelement-7 final Abonnement-einddatum final Abonnementenregister
@value
 		cs 1 … 1 R

moet in de toekomst liggen en mag ten opzichte van het moment van het registratieverzoek niet meer dan 1,5 jaar verschillen.

hl7:eventCode
 		0 … 1 abonnement-gebeurtenis-type. Identificatie van het gebeurtenistype waarop een abonnement wordt gevraagd. (Quedots8NL)
hl7:value
 		CV (extensible) 1 … 1 M abonnement-gebeurtenis-type. Bevat de waarde van de parameter eventCode (gebeurtenis-type). (Quedots8NL)
 
target
abr-dataelement-3 final Abonnement-gebeurtenis-type final Abonnementenregister
  CONF
De waarde van @code moet indien mogelijk komen uit waardelijst 2.16.840.1.113883.2.4.3.111.3.7.11.1 GebeurtenistypeAbonneerbaar (2016‑09‑19 13:12:38)
hl7:objectCode
 		0 … 1 C abonnement-gebeurtenis-object. Identificatie van het gebeurtenisobject waarop een abonnement wordt gevraagd. (Quedots8NL)
  Constraint

Dit moet bij voorkeur gevuld worden met de AORTA Context Code van de betreffende zorgtoepassing.

Eventueel kan met terugwerkende kracht nog gebruik worden gemaakt van gegevenssoort.
hl7:value
 		CD (extensible) 1 … 1 M
abonnement-gebeurtenis-object. Bevat de waarde van de parameter objectCode (objectCode).
 (Quedots8NL)
 
target
abr-dataelement-4 final Abonnement-gebeurtenis-object final Abonnementenregister
  CONF
De waarde van @code moet indien mogelijk komen uit waardelijst 2.16.840.1.113883.2.4.3.11.60.102.11.8 ActRegistryCode: x_DataDomainNL (2010‑01‑01)
of
De waarde van @code moet indien mogelijk komen uit waardelijst 2.16.840.1.113883.2.4.3.111.3.3.11.1 AORTA Context Code (DYNAMISCH)
hl7:subjectId
 		0 … 1 abonnement-gebeurtenis-subject. Identificatie van het gebeurtenissubject waarop een abonnement wordt gevraagd. (Quedots8NL)
  Constraint

Het is NIET zinnig om een abonnement te registreren onder gebeurtenissubject.

Tijdens signaleren, is het subject is namelijk het onderwerp op wie de gebeurtenis betrekking heeft.

Keuze 1 … 1 Elementen om uit te kiezen:
  • hl7:value[@root = '2.16.528.1.1007.3.1']
  • hl7:value[@root = '2.16.528.1.1007.3.3']
  • hl7:value ingevoegd uit template 2.16.840.1.113883.2.4.3.111.3.4.10.1 Burgerservicenummer (BSN) Value (2017‑07‑24 13:46:47)
hl7:value
 		II 0 … 1 R abonnement-gebeurtenis-subject. Bevat de waarde van de parameter subjectId uit de vocabulaire Gebeurtenis-subject als UZI-nummer (Quedots8NL)
 
target
abr-dataelement-5 final Abonnement-gebeurtenis-subject final Abonnementenregister
@root
 		uid 1 … 1 F 2.16.528.1.1007.3.1
@extension
 		st 1 … 1 R
hl7:value
 		II 0 … 1 R abonnement-gebeurtenis-subject. Bevat de waarde van de parameter subjectId uit de vocabulaire Gebeurtenis-subject als URA-nummer (Quedots8NL)
 
target
abr-dataelement-5 final Abonnement-gebeurtenis-subject final Abonnementenregister
@root
 		uid 1 … 1 F 2.16.528.1.1007.3.3
@extension
 		st 1 … 1 R
Inclusie 0 … 1 R van 2.16.840.1.113883.2.4.3.111.3.4.10.1 Burgerservicenummer (BSN) Value (2017‑07‑24 13:46:47)
abonnement-gebeurtenis-subject. Bevat de waarde van de parameter subjectId uit de vocabulaire Gebeurtenis-subject als patiënt-id.
hl7:value
 		II.NL.BSN 0 … 1 R Burgerservicenummer (BSN) (Quedots8NL)
 
target
abr-dataelement-5 final Abonnement-gebeurtenis-subject final Abonnementenregister
vwi-dataelement-6 final Patiënt-id final Verwijsindex
@extension
 		st 1 … 1 R
@root
 		oid 1 … 1 F 2.16.840.1.113883.2.4.6.3
  Schematron assert role red error  
  test string-length(@extension) = 9  
  Melding Het BSN dient altijd 9 cijfers te bevatten. Het BSN kan ook voorloopnullen bevatten, oftewel beginnen met een nul.