[geprüfte Version] | [Markierung ausstehend] |
|
|
| + | ==Zeit-Elemente== |
| + | Angaben von Zeiten sind in HL7 CDA auf vielerlei Arten möglich. Es können Zeitpunkte, Zeitintervalle bestehend aus Beginn- und Endzeitpunkt, Zeitintervalle bestehend aus Beginnzeitpunkt und Dauer und vielerlei mehr Varianten abgebildet werden. |
| + | |
| + | Damit nicht alle beliebigen Varianten implementiert werden müssen, werden die Varianten über den Leitfaden stark eingeschränkt. Weitere Spezifizierungen von Zeit-Elementen können von den speziellen Implementierungsleitfäden vorgenommen werden, z.B. spezifiziert der Implementierungsleitfaden e-Medikation den Datentyp GTS (General Timing Specification) für komplexe Zeitangaben mit Anfang, Ende und Häufigkeit bei den Einnahmeregeln für Medikamente. |
| + | {{BeginYellowBox}} |
| + | Allgemein gilt, dass nicht angegebene Datums- und Zeitanteile (also z.B. fehlende Sekunden) mit 0 (Null) angenommen werden. D.h. 201908071633 entspricht 20190807163300. |
| + | {{EndYellowBox}} |
| + | '''Normale Angabe von Datum und Zeit'''<br/> |
| + | 1) '''Zeitpunkte''': Die häufigsten Datums- und Zeitangaben werden über den Datentyp TS.AT.TZ <ref>Datentyp TS.AT.TZ https://art-decor.org/mediawiki/index.php?title=DTr1_TS.AT.TZ</ref> zusammengefasst und im Folgenden unter ''Einfaches Zeitelement TS'' beschrieben. |
| + | Hier kann der Wert für einen Zeitpunkt auf drei Arten angegeben werden: |
| + | * als taggenaues Datum |
| + | * als Datum mit sekundengenauer Uhrzeit und Zeitzone |
| + | * als ungenaue Zeitangabe (etwa nur Jahr oder Monat) - erfordert die Spezifikation als TS.AT.VAR<ref>Datentyp TS.AT.VAR https://art-decor.org/mediawiki/index.php?title=DTr1_TS.AT.TZ</ref> |
| + | |
| + | 2) '''Zeitintervalle''': Bestehen aus Anfangs- und Endpunkt, die wiederum als Zeitpunkt wie oben angegeben werden. Dieser Datentyp wird als ''Intervall-Zeitelement IVL_TS'' im Anschluss spezifiziert. |
| + | |
| ===Zeitpunkt: Einfaches Zeitelement TS=== | | ===Zeitpunkt: Einfaches Zeitelement TS=== |
| =====Nur Datum===== | | =====Nur Datum===== |
|
|
| |- | | |- |
| |} | | |} |
| + | |
| + | |
| + | ===Minimale Datumsangabe: TS.DATE=== |
| + | |
| + | Eine minimale Datumsangabe umfasst die möglichen Formate: YYYY, YYYYMM, YYYYMMDD. Dies wird mit dem Datentyp TS.DATE <ref>TS.DATE https://art-decor.org/mediawiki/index.php?title=DTr1_TS.DATE </ref> angezeigt. |
| + | |
| + | ====Strukturbeispiel==== |
| + | Datum: "Juni 2008" |
| + | <pre class="ilfbox_code"> |
| + | <effectiveTime value="200806"/> |
| + | </pre> |
| + | |
| + | ====Spezifikation==== |
| + | Beim Datum TS.DATE werden, sofern nicht anders spezifiziert, immer die folgenden Unterelemente/Attribute angegeben: |
| + | {| class="wikitable" width="100%" |
| + | |- |
| + | ! colspan="2" style="text-align:left" width="20%" | Element/Attribut ||style="text-align:left" width="5%" | DT ||style="text-align:left" width="5%" | Kard ||style="text-align:left" width="5%" | Konf ||style="text-align:left" width="65%" | Beschreibung |
| + | |
| + | |- style="background:#FFFFFF" |
| + | | colspan="2" style="text-align:left" | effectiveTime|| TS.DATE || || || |
| + | |
| + | |- style="background:#FFFFFF" |
| + | | || @value|| ts|| 1..1 || R || '''Datum im Format YYYY, YYYYMM, YYYYMMDD'''<br/>z.B. 20131224, 201312, 2013 |
| + | |- |
| + | |} |
| + | |
| + | ===Zeitintervall: Intervall-Zeitelement IVL_TS=== |
| + | ====Strukturbeispiel==== |
| + | <pre class="ilfbox_code"> |
| + | <effectiveTime> |
| + | <low value="..."/> <!-- Zeitpunkt von --> |
| + | <high value="..."/> <!-- Zeitpunkt bis --> |
| + | </effectiveTime> |
| + | </pre> |
| + | |
| + | ====Spezifikation==== |
| + | Bei Zeitintervallen werden, sofern nicht anders spezifiziert, immer die folgenden Unterelemente/Attribute angegeben: |
| + | {| class="wikitable" width="100%" |
| + | |- |
| + | ! colspan="3" style="text-align:left" width="20%" | Element/Attribut ||style="text-align:left" width="5%" | DT ||style="text-align:left" width="5%" | Kard ||style="text-align:left" width="5%" | Konf ||style="text-align:left" width="65%" | Beschreibung |
| + | |
| + | |- style="background:#FFFFFF" |
| + | | colspan="3" style="text-align:left" | effectiveTime|| IVL_TS || || || Zeitintervall |
| + | |
| + | |- style="background:#FFFFFF" |
| + | | || colspan="2" style="text-align:left" | low || TS.AT.TZ || 1..1 || R || Beginn des Intervalls<br/>Zugelassene nullFlavor: '''UNK''' |
| + | |
| + | |- style="background:#FFFFFF" |
| + | | || || @value || ts || 1..1 || R || '''Zeitpunkt des Beginns des Intervalls''' |
| + | |
| + | |- style="background:#FFFFFF" |
| + | | || colspan="2" style="text-align:left" | high|| TS.AT.TZ || 1..1 || R || Ende des Intervalls<br/>Zugelassene nullFlavor: '''UNK''' |
| + | |
| + | |- style="background:#FFFFFF" |
| + | | || || @value || ts || 1..1 || R || '''Zeitpunkt des Endes des Intervalls''' |
| + | |- |
| + | |} |
| + | |
| + | Ein Datum, das mit yyyymmdd angegeben wurde, wird gemäß Standard HL7 CDA Rel.2 interpretiert als yyyymmdd000000 – also der Tag um 0:00:00 Uhr. Wenn also als Zeitraum z.B.: der ganze 1.Dezember 2013 angegeben werden soll, MUSS das so erfolgen: |
| + | <pre class="ilfbox_code"> |
| + | <low value="20131201"/> |
| + | <high value="20131202"/> |
| + | </pre> |
| + | Für mehr Klarheit empfiehlt sich daher die zusätzliche Angabe der Zeit mit Zeitzone: |
| + | <pre class="ilfbox_code"> |
| + | <low value="20131201000000+0100"/> |
| + | <high value="20131201235959+0100"/> |
| + | </pre> |
| + | |
| + | ===Periodisches-Zeitintervall PIVL_TS=== |
| + | Ein periodisch wiederkehrendes Zeitintervall. Periodische Intervalle tragen die Elemente ''phase'' und ''period''. ''phase'' gibt den "Intervall-Prototypen" an, der jede ''period'' wiederholt wird. |
| + | |
| + | ====Spezifikation==== |
| + | Bei PIVL_TS Elementen können, sofern nicht durch einen speziellen Implementierungsleitfaden eingeschränkt, immer die folgenden Attribute angegeben werden: |
| + | {| class="wikitable" |
| + | |'''Element/Attribut''' |
| + | |'''DT''' |
| + | |'''Kard''' |
| + | |'''Konf''' |
| + | |'''Beschreibung''' |
| + | |- |
| + | |@operator |
| + | |cs |
| + | |0..1 |
| + | |R |
| + | |Wenn ein Element vom Typ PIVL_TS Teil eines Sets ist (d.h. child von einem parent-Element mit einem Set-Datentyp basierend auf SXCM) spezifiziert dieser Code die Set-Operation. Gängige Set-Operationen sind "I" für inkludieren, "E" für ausschließen und "A" für die Schnittmenge. |
| + | |- |
| + | |@alignment |
| + | |cs |
| + | |0..1 |
| + | |R |
| + | |Gibt an, in welcher Art und Weise die Wiederholung in ''phase'' einem bestimmten Kalenderzyklus zugeordnet ist. Gängige Zyklen sind "DW" für einen bestimmten Tag in der Woche oder "MY" für einen bestimmten Monat im Jahr. |
| + | |- |
| + | |@institutionSpecified |
| + | |bl |
| + | |0..1 |
| + | |R |
| + | |Gibt an, ob der Start des periodischen Zeitintervalls vom durchführenden bestimmt wird. |
| + | |- |
| + | |phase |
| + | |IVL_TS |
| + | |0..1 |
| + | |O |
| + | |Das Zeitintervall, das sich periodisch wiederholt. |
| + | |- |
| + | |period |
| + | |PQ |
| + | |0..1 |
| + | |O |
| + | |Zeitliche Frequenz, zu der das Zeitintervall in ''phase'' auftritt. |
| + | |} |
| + | ====Strukturbeispiele==== |
| + | <pre class="ilfbox_code"> |
| + | <!-- pro Tag --> |
| + | <effectiveTime xsi:type='PIVL_TS' institutionSpecified='true'> |
| + | <period value='1' unit='d'/> |
| + | </effectiveTime> |
| + | |
| + | <!-- 2x täglich, für 20 Minuten --> |
| + | <effectiveTime xsi:type='PIVL_TS'> |
| + | <phase> |
| + | <width value='20' unit='min'/> |
| + | </phase> |
| + | <period value='12' unit='h'/> |
| + | </effectiveTime> |
| + | |
| + | <!-- Jede Woche am Mittwoch, "20191113" ist ein Mittwoch --> |
| + | <effectiveTime xsi:type='PIVL_TS' alignment='DW'> |
| + | <phase value='20191113'/> |
| + | <period value='1' unit='wk'/> |
| + | </effectiveTime> |
| + | </pre> |
| + | |
| + | ===Periodisches-Zeitintervall EIVL_TS=== |
| + | Ein periodisch wiederkehrendes Zeitintervall, bei dem das Wiederauftreten auf einer bestimmten Aktivität des täglichen Lebens oder einem Ereignis basiert, das zwar zeitbezogen, aber nicht vollständig durch eine Zeitangabe bestimmbar ist (z.B. mittags). |
| + | |
| + | ====Spezifikation==== |
| + | Bei EIVL_TS Elementen können, sofern nicht durch einen speziellen Implementierungsleitfaden eingeschränkt, immer die folgenden Attribute angegeben werden: |
| + | {| class="wikitable" |
| + | |'''Element/Attribut''' |
| + | |'''DT''' |
| + | |'''Kard''' |
| + | |'''Konf''' |
| + | |'''Beschreibung''' |
| + | |- |
| + | |@operator |
| + | |cs |
| + | |0..1 |
| + | |R |
| + | |Wenn ein Element vom Typ EIVL_TS Teil eines Sets ist (d.h. child von einem parent-Element mit einem Set-Datentyp basierend auf SXCM) spezifiziert dieser Code die Set-Operation. Gängige Set-Operationen sind "I" für inkludieren, "E" für ausschließen und "A" für die Schnittmenge. |
| + | |- |
| + | |event |
| + | |CS |
| + | |0..1 |
| + | |O |
| + | |Code für eine gebräuchliche periodische Aktivität des täglichen Lebens, das den Start des Intervalls darstellt. Gängige Codes sind "ACM" für morgens, "ACD" für mittags und "ACV" für abends aus dem HL7 v3 Codesystem "TimingEvent" (2.16.840.1.113883.5.139). |
| + | |
| + | Das jeweils gültige Value Set ist in einem speziellen Implementierungsleitfaden festgelegt (wie z.B. für die e-Medikation das Value Set "ELGA_Einnahmezeitpunkte"). |
| + | |- |
| + | |offset |
| + | |IVL_TS |
| + | |0..1 |
| + | |O |
| + | |Zur Angabe einer Zeitspanne als Zeitversatz vor oder nach dem Eintreten des Ereignisses in event, z.B. 1 Stunde vor dem Frühstück |
| + | |} |
| + | |
| + | ====Strukturbeispiele==== |
| + | <pre class="ilfbox_code"> |
| + | <!-- morgens --> |
| + | <effectiveTime xsi:type='EIVL_TS'> |
| + | <event code='ACM'/> |
| + | <offset value="0" unit="s"/> |
| + | </effectiveTime> |
| + | |
| + | <!-- abends --> |
| + | <effectiveTime xsi:type='EIVL_TS'> |
| + | <event code='ACV'/> |
| + | <offset value="0" unit="s"/> |
| + | </effectiveTime> |
| + | |
| + | <!-- 1 Stunde vor dem Mittagessen --> |
| + | <effectiveTime xsi:type='EIVL_TS'> |
| + | <event code='ACD'/> |
| + | <offset> |
| + | <low value="1" unit="h"/> |
| + | </offset> |
| + | </effectiveTime> |
| + | </pre> |
| + | |
| + | ===Strukturierung von Zeitelementen SXPR_TS=== |
| + | Ein Element von diesem Datentyp repräsentiert ein Set von Komponenten zu Zeitangaben, das als eine Einheit zu betrachten ist. |
| + | ====Spezifikation==== |
| + | Bei SXPR_TS Elementen können, sofern nicht durch einen speziellen Implementierungsleitfaden eingeschränkt, immer die folgenden Attribute angegeben werden: |
| + | {| class="wikitable" |
| + | | colspan="2" |'''Element/Attribut''' |
| + | |'''DT''' |
| + | |'''Kard''' |
| + | |'''Konf''' |
| + | |'''Beschreibung''' |
| + | |- |
| + | | colspan="2" |@operator |
| + | |cs |
| + | |0..1 |
| + | |R |
| + | |Wenn ein Element vom Typ SXPR_TS teil eines Sets ist (d.h. child von einem parent-Element mit einem Set-Datentyp basierend auf SXCM) spezifiziert dieser Code die Set-Operation. Gängige Set-Operationen sind "I" für inkludieren, "E" für ausschließen und "A" für die Schnittmenge. |
| + | |- |
| + | | |
| + | |comp |
| + | |IVL_TS, |
| + | |
| + | PIVL_TS, |
| + | |
| + | EIVL_TS, |
| + | |
| + | SXPR_TS |
| + | |2..* |
| + | |R |
| + | |Komponente zur Strukturierung von Zeitangaben entsprechend dem jeweils festgelegten Datentyp. |
| + | |} |
| + | |
| + | ====Strukturbeispiele==== |
| + | <pre class="ilfbox_code"> |
| + | |
| + | <!-- 1 Zeitangabe bestehend aus 2 Zeit-Komponenten, jeden Dienstag und Donnerstag pro Woche --> |
| + | <effectiveTime xsi:type='SXPR_TS'> |
| + | <!-- Jeden Dienstag --> |
| + | <comp xsi:type='PIVL_TS' alignment='DW'> |
| + | <phase value="20131001"/> <!-- Der 1.Okt 2013 ist ein Dienstag --> |
| + | <period value="1" unit="wk"/> |
| + | </comp> |
| + | |
| + | <!-- Jeden Donnerstag --> |
| + | <comp xsi:type='PIVL_TS' alignment='DW'> |
| + | <phase value="20131003"/> <!-- Der 3.Okt 2013 ist ein Donnerstag --> |
| + | <period value="1" unit="wk"/> |
| + | </comp> |
| + | </effectiveTime> |
| + | |
| + | |
| + | <!-- 1 Zeitangabe bestehend aus 2 Zeit-Komponenten, morgens jeden Montag, der 21.Dezember ist ein Montag --><effectiveTime xsi:type='SXPR_TS'> |
| + | <comp xsi:type='EIVL_TS'> |
| + | <event code='ACM'/> |
| + | <offset value="0" unit="s"/> |
| + | </comp> |
| + | <comp xsi:type='PIVL_TS'> |
| + | <phase value="20151221"/> |
| + | <period value='1' unit='wk'/> |
| + | </comp> |
| + | </effectiveTime> |
| + | </pre> |