Template 2.16.840.1.113883.2.4.6.10.100.202 ControlAct Query Response / Acknowledgement

2012‑10‑01

Template 2.16.840.1.113883.2.4.6.10.100.202 - ControlActWrapperQUQI_MT120001
Id 2.16.840.1.113883.2.4.6.10.100.202
Context Padnaam hl7:ControlActProcess
Versie geldig vanaf 2012‑10‑01 status Actief
Omschrijving Dit is het template voor een control act wrapper in een reagerend opleverbericht. AuthorOrPerformer en Overseer worden hierin niet gecontroleerd. Deze worden in separate templates gedefinieerd
Gebruikt in
Gebruikt in 1 template
Id Naam vanaf
2.16.840.1.113883.2.4.6.10.100.17 OpleverenVaccinatiestatus  Opleveren vaccinatiestatus (interactie) 2012‑10‑01
Voorbeeld
<ControlActProcess moodCode="EVN">
  <code code="REPC_TE920000NL" codeSystem="2.16.840.1.113883.1.18"/>
  <authorOrPerformer typeCode="AUT">
    <!-- ... -->
  </authorOrPerformer>
  <overseer typeCode="RESP">
    <!-- ... -->
  </overseer>
  <subject>
    <!-- ... -->
  </subject>
</ControlActProcess>
Item DT Card Conf Desc Label
@moodCode
1 .. 1 F EVN
hl7:id
II 0 .. 1 R Trigger event identificatie (ControlActWrapperQUQI_MT120001)
hl7:code
CV 0 .. 1 R Trigger event code (ControlActWrapperQUQI_MT120001)
treetree @codeSystem
1 .. 1 F 2.16.840.1.113883.1.18 (HL7-Trigger Events)
hl7:text
NP (ControlActWrapperQUQI_MT120001)
hl7:effectiveTime
TS 0 .. 1 R Datum/tijd waarop het trigger event plaatsvond dat leidde tot dit bericht (ControlActWrapperQUQI_MT120001)
hl7:reasonCode
NP (ControlActWrapperQUQI_MT120001)
hl7:languageCode
NP (ControlActWrapperQUQI_MT120001)
hl7:informationRecipient
NP (ControlActWrapperQUQI_MT120001)
hl7:dataEnterer
NP (ControlActWrapperQUQI_MT120001)
hl7:reasonOf
0 .. * (ControlActWrapperQUQI_MT120001)
hl7:queryAck
0 .. 1 R Bevat de metakenmerken van het antwoord (ControlActWrapperQUQI_MT120001)
treetree hl7:queryId
II 1 .. 1 M Bevat de unieke identificatie van de vraag. De waarde van dit attribuut is gelijk aan de waarde van QueryByParameter/queryId uit de vraag De aanvrager kan hierdoor de antwoordberichten relateren aan de vraag. (ControlActWrapperQUQI_MT120001)
treetree hl7:statusCode
CS 0 .. 1 R Bevat de (nieuwe) status van de query. De te gebruiken waarden in dit attribuut zijn gedefinieerd in de valueset QueryStatusCode. (ControlActWrapperQUQI_MT120001)
Constraint @code moet, indien aanwezig, de waarde “aborted” bevatten als de antwoordinteractie het antwoord vormt op een verzoek om de vraagsessie af te breken.
Constraint @code moet, indien aanwezig, de waarde “deliveredResponse” bevatten in alle andere gevallen.
CONF
@code moet "aborted" zijn
of
@code moet "deliveredResponse" zijn
treetree hl7:queryResponseCode
CS 1 .. 1 M Bevat een statusmelding betreffende het antwoord. Waarden zijn ‘OK’ (Data found), ‘NF’ (Nothing found, No errors), ‘AE’ (Applicatie probleem, beantwoording afgebroken) en ‘QE’ (Query Parameter Error, beantwoording afgebroken). De te gebruiken waarden zijn gedefinieerd in de QueryResponse vocabulaire. Indien er geen zoekresultaten bij een vraag opgeleverd kunnen worden, omdat bijvoorbeeld de in de vraag geleverde parameters niet tot een zoekresultaat leiden, dan bevat het antwoordbericht nul opgeleverde antwoorden en het queryResponseCode de waarde “NF”. Het vinden van nul antwoorden is op zichzelf geen fout, Acknowledgement/@typeCode bevat om die reden “AA” indien queryResponseCode/@code “NF” is. (ControlActWrapperQUQI_MT120001)
Constraint @code moet “OK” bevatten als de resultaten op basis van de vraag geheel of gedeeltelijk worden opgeleverd
Constraint @code moet “NF” bevatten als op basis van de opgegeven filterparameters geen resultaten konden worden gevonden, maar verder ook geen fouten zijn opgetreden.
Constraint @code moet “QE” bevatten als er problemen zijn met de verwerking van de filterparameters, zoals zoeken op UZI-nummer in een parameter welke bedoeld is voor zoeken op UZI-registerabonneenummmers, zoeken op gegevenssoort met een parameter die bedoeld is voor rolcode, of zoeken in een periode die ligt buiten een gespecificeerd bereik. Er zijn in dit geval geen resultaten en de vraagsessie is afgebroken.
Constraint @code moet “AE” bevatten als er applicatieproblemen zijn opgetreden. Er zijn in dit geval geen resultaten en de vraagsessie is afgebroken.
CONF
@code moet "OK" zijn
of
@code moet "NF" zijn
of
@code moet "QE" zijn
of
@code moet "AE" zijn
treetree hl7:resultTotalQuantity
INT 1 .. 1 R Bevat de totale hoeveelheid zoekresultaten die geleverd (kunnen) worden als antwoord op de vraag.

Merk op dat een antwoordend systeem, ook in het geval van een ongedoseerde vraag de omvang van het antwoord kan beperken, bijvoorbeeld om resource-technische redenen. In dat geval moet de vraagsteller vervolgvragen sturen om alle antwoorden te verkrijgen.
Als een systeem geen vervolgvragen kan beantwoorden, moet een systeem omwille van de volledigheid alle gevraagde zoekresultaten in één keer opleveren.
Merk op dat het “doseermechanisme” op dit moment in AORTA niet gebruikt mag worden. Het element QueryByParameter/initialQuantity attribuut mag om die reden niet gebruikt worden. Opleverende systemen dienen alle zoekresultaten in één antwoordbericht op te leveren.

(ControlActWrapperQUQI_MT120001)
Constraint @value moet een waarde bevatten, of als de totale hoeveelheid zoekresultaten (nog) niet bekend is moet @nullFlavor de waarde “NAV” bevatten.
treetree hl7:resultCurrentQuantity
INT 1 .. 1 R Bevat de hoeveelheid antwoorden die opgenomen zijn in het huidige bericht. Een antwoordbericht kan meerdere antwoorden bevatten. Bevat de hoeveelheid antwoorden die opgenomen zijn in het huidige bericht. (ControlActWrapperQUQI_MT120001)
Constraint @value moet een waarde bevatten.
treetree hl7:resultRemainingQuantity
INT 1 .. 1 R Bevat de hoeveelheid zoekresultaten die (nog) niet verstuurd zijn aan de aanvrager. De aanwezigheid van de @nullFlavor met waarde “NAV” mag niet worden geïnterpreteerd als “0”.

Uitgaande van de oplevering van een reeks antwoordberichten zonder foutmeldingen:
In de reeks antwoordberichten (al dan niet gebundeld) dient resultTotalQuantity in alle berichten dezelfde waarde te bevatten en resultRemainingQuantity (in grootte zoals opgegeven in het resultCurrentQuantity element) af te nemen naar de waarde 0.
De elementen resultTotalQuantity en resultRemainingQuantity kunnen aan het begin van de reeks antwoordberichten worden gevuld met een null-waarde indien de waarden nog niet bekend zijn. Het laatste bericht in de reeks antwoordberichten mag echter geen null-waarden in deze elementen bevatten.

(ControlActWrapperQUQI_MT120001)
Constraint @value moet een waarde bevatten, of als de totale hoeveelheid zoekresultaten (nog) niet bekend is moet @nullFlavor de waarde “NAV” bevatten.