v3dtr1:PIVL

PIVL (Periodisches Zeitintervall – Periodic Interval of Time)

Definition: Ein Zeitintervall (oder Zeitpunkt) das/der sich periodisch wiederholt.

Attribute:

			DT	Card	Conf	Beschreibung

			DT	Card	Conf	Beschreibung

			DT	Card	Conf	Beschreibung

Elemente:

			DT	Card	Conf	Beschreibung

			DT	Card	Conf	Beschreibung

Struktur:

Der Datentyp PIVL ist eine Erweiterung des Datentyps SXCM (Set Component) und gilt daher als ein Teil einer Menge. In diesem speziellen Fall setzt sich eine solche Menge aus Zeitspezifikationen zusammen, die gemeinsam die Beschreibung eines bestimmten Zeitschemas darstellen. Die Zeitspezifikationen werden dabei zusammengesetzt mit Operatoren (Set Operators), wie ‘Vereinigung’, ‘Differenz’ und ‘Durchschnitt’. Ohne Beispiele ist das schwierig zu erklären. Deshalb wird dies nachstehend anhand ausführlicher Beispiele demonstriert.

Anwendung:

Nachrichtenelemente mit dem Datentyp PIVL kommen ausschließlich als Teil des (abstrakten) Datentyps GTS vor. General Timing Specification nutzt eine sehr allgemeine Methode zur Darstellung von Zeitschemas und besteht grundsätzlich aus einer Menge zusammengesetzter Komponenten. Eine der wichtigsten Komponentenarten ist der Datentyp PIVL. Hiermit werden Zeitphasen angegeben, die sich wiederholen, wie z.B. ‘2x täglich’, oder ‘alle 2 Wochen Montags von 10:00 bis 10:30’.

XML Beispiele

2x täglich

<comp xsi:type="PIVL_TS">
	<period value="0.5" unit="d"/>
</comp>

Alle 2 Wochen Montags von 10:00 bis 10:30

<comp xsi:type="PIVL_TS" alignment="DW">
	<phase>
		<low value="200508291000"/>
		<width value="30" unit="min"/>
	</phase>
	<period value="2" unit="wk"/>
</comp>

Anmerkung:

In den beiden vorstehenden Beispielen hat das Nachrichtenelement den Namen <comp>. Damit wird angegeben, dass es sich um Elemente binnen des Datentyps SXPR (Paranthectic Set Expression) handelt. Das ist die Form, in der PIVL meistens vorkommt. Nähere Erläuterungen zu SXPR finden Sie unter Datentyp GTS (General Timing Specification) an anderer Stelle in diesem Dokument.

			DT	Card	Conf	Beschreibung

Wie gesagt fungiert PIVL als Teil einer Menge Komponenten. Wenn diese Komponenten zusammengesetzt werden, ergibt sich ein Zeitschema. Dies lässt sich am besten anhand praktischer Beispiele erklären.

Beispiel: Ein Rezept hat eine Gültigkeitsdauer von 90 Tagen ab 1.9.2005 (d.h. die geplante Verabreichungsperiode läuft vom 1.9.2005 bis einschl. 29.11.2005). Das Attribut effectiveTime in der Gebrauchsanweisung besitzt den Datentyp GTS und besteht aus einer Menge des Datentyps SXPR_TS (Paranthetic Set Expression), die mit dem Intervall zwischen diesen beiden Daten beginnt. Es handelt sich also um eine Menge, die ein IVL_TS enthält.

XML Beispiele

Geplante Verabreichungsperiode

<effectiveTime xsi:type="SXPR_TS">
	<comp xsi:type="IVL_TS">
		<low value="20050901"/>
		<width value="90" unit="d"/>
	</comp>
<effectiveTime/>

Bemerkung: In vorstehendem Beispiel kommt der Datentyp PIVL selbst noch gar nicht vor, aber es soll deutlich machen, wie der Operator im PIVL benutzt wird, um die Menge zu definieren. Siehe auch die Beschreibung des allgemeinen Datentyps GTS.

Angenommen, dass in der betreffenden Periode alle 2 Tage eine Arznei verabreicht werden muss. De facto muss dann der Durchschnitt des angegebenen Intervalls genommen werden, sowie ein sich periodisch wiederholendes ‘Etwas’, von nur bekannt ist, dass es alle 2 Tage stattfindet.

Alle 2 Tage innerhalb des angegebenen Intervalls

<effectiveTime xsi:type="SXPR_TS">
	<comp xsi:type="IVL_TS">
		<low value="20050901"/>
		<width value="90" unit="d"/>
	</comp>
	<comp xsi:type="PIVL_TS" operator="A">
		<period value="2" unit="d"/>
	</comp>
<effectiveTime/>

Der Operator “A” in der vorstehend zugefügten PIVL Komponente hat die Definition: ‘Nehmen sie den Durchschnitt der zuvor angegebenen Zeiten (Intervall von 90 Tagen ab 1.9.2005) mit der Wiederholungsperiode (period) die danach angegeben wird. Das Ergebnis ist also ‘alle 2 Tage vom 1.9.2005 bis einschl. 29.11.2005’. Dies ergibt also 45 Verabreichungszeitpunkte, ohne dass genau definiert wird, an welchen Tageszeitpunkten diese Ereignisse stattfinden sollen.

Die gültigen Operatoren bei PIVL_TS (und aller anderen Komponenten eines SXPR_TS) sind:

Tabelle: Domäne SetOperator

Code	Definition
I	Nehmen Sie die Vereinigung mit dem vorigen Zeitschema.
E	Nehmen Sie die Differenz mit dem vorigen Zeitschema.
A	Nehmen Sie den Durchschnitt mit dem vorigen Zeitschema.

Vorlage:BeginEMBox Das Attribut operator ist in einem PIVL Nachrichtenelement verpflichtend in allen Fällen, in denen es als Teil einer SXPR Menge fungiert und nicht das erste Element ist. Bei zweiten und weiteren Elementen einer SXPR Menge muss schließlich die Beziehung zu den vorigen Elementen angegeben werden (oder besser gesagt zu der bis dahin aufgebauten Menge). Vorlage:EndEMBox Siehe auch die allgemeine Beschreibung bei GTS über die Anwendung von set operator.

			DT	Card	Conf	Beschreibung

Das Element phase ist eigentlich ein Beispiel (Prototyp) eines Basisintervalls (oder Basiszeitpunkt), das im PIVL Datentyp periodisch wiederholt wird. Dabei kann in PIVL z. B. ‘täglich um 14:00’ angegeben werden, indem man den Zeitpunkt ‘14:00’ an einem willkürlichen Tag als phase andeutet und bei period angibt, dass dies sich täglich wiederholt.

Das Element phase ist nicht verpflichtend, weil es auch vorkommt, dass nur eine Wiederholungsperiode angegeben werden muss und ein Basiszeitpunkt oder Basisintervall nicht nötig ist. So ist phase bei ‘alle zwei Tage’ im Beispiel weiter oben nicht nötig, weil es nicht relevant ist, an welchem Zeitpunkt innerhalb der zwei Tage das Ereignis (z.B. die Verabreichung der Arznei) stattfindet. Nachstehend finden Sie einige Beispiele von Situationen, in denen dies der Fall ist.

Täglich um 8:00

<comp xsi:type="PIVL_TS">
	<phase>
		<center value="200509010800"/>
	</phase>
	<period value="1" unit="d"/>
</comp>

Zu beachten ist, dass die Tatsache, dass hier der 1. September 2005 eingetragen ist, de facto unrelevant ist! Phase ist nur angegeben, weil der Zeitpunkt 08:00 übermittelt werden muss und dient insofern als Prototyp eines solchen Zeitpunkts. Dabei muss aber ein Datum angegeben werden, weil die Übermittlung eines separaten Zeitpunkts in der HL7 Version 3 (Datentyp TS) nicht möglich ist. Es hätte dort also auch <center value="198812040800"> stehen können, woraus die Verarbeitungssoftware exakt die gleiche Schlussfolgerung ziehen muss (täglich um 08:00).

Zu beachten ist auch, dass phase immer die Form eines Intervalls hat (Datentyp IVL_TS). Wenn also ein separater Zeitpunkt (oder ein separater Tag) angegeben werden muss, geschieht dies am besten, indem man das Element <center> von IVL_TS anwendet. Damit wird das Intervall praktisch auf einen Zeitpunkt reduziert, behält aber die Struktur von IVL.

Täglich um 8:00, während 10 Minuten

<comp xsi:type="PIVL_TS">
	<phase>
		<low value="200509010800"/>
		<width value="10" unit="min"/>
	</phase>
	<period value="1" unit="d"/>
</comp>

Der einzige Unterschied zu dem vorigen Beispiel ist, dass phase jetzt ein ‘echtes’ Intervall ist, anstatt ein einfacher Zeitpunkt. Dies ist z.B. der Fall, wenn eine Arzneiverabreichung, eine physiotherapeutische Behandlung oder eine andere Aktivität in einer bestimmten Zeitspanne ausgeführt werden muss. Dies kann auch vorkommen, wenn der Zeitpunkt im Grunde nicht relevant ist:

Täglich, während 10 Minuten

<comp xsi:type="PIVL_TS">
	<phase>
		<width value="10" unit="min"/>
	</phase>
	<period value="1" unit="d"/>
</comp>

In diesem Beispiel ist von phase nur noch die Dauer (width) relevant.

			DT	Card	Conf	Beschreibung

Das Attribut alignment wird benutzt, um anzugeben, welcher Aspekt von phase (das Basisintervall) relevant ist zum Festlegen des Wiederholungsmusters. Das klingt in erster Instanz sehr verwirrend, bietet aber die Möglichkeit, Wiederholungsmuster, wie ‘jeden Montag’ oder ‘an jedem 14e eines Monats’ oder ‘jeden 2. Mai’ relativ einfach anzugeben.

Jeden Montag

<effectiveTime xsi:type="PIVL_TS" alignment="DW">
	<phase> 
		<center value="20050829"/>
	</phase>
	<period value="1" unit="wk"/>
</effectiveTime>

Das alignment ‘DW’ gibt hier an, dass der relevante Aspekt der angegebenen phase ‘day of the week’ is. Angesichts der Tatsache, dass 29.8.2005 ein Montag war, steht hier also nichts anderes wie ‘jeden Montag’. Wie bereits zuvor erwähnt, ist der exakte Wert von phase nicht relevant.

Die gültigen alignment Varianten bei PIVL_TS beschränken sich in den Niederlanden auf:

Tabelle: Domäne CalendarCycle

Name	Code	Definition
day of the week	DW	Jeden Montag, Dienstag, Mittwoch, …
day of the month	DM	Jeden 1e, 2e, 3e, 4e, … des Monats
day of the year	DY	Jeden 1/1, 2/1, 3/1, 4/1, … des Jahres

Zu beachten ist also, dass alignment nur dann sinnvoll ist, wenn phase die Form eines einfachen Zeitpunkts oder eines Intervalls hat, die innerhalb eines Tages liegt.

Jeden 15. des Monats

<effectiveTime xsi:type="PIVL_TS" alignment="DM">
	<phase> 
		<center value="20050915"/>
	</phase>
	<period value="1" unit="mo"/>
</effectiveTime>

Jeden 1/3 und 1/8, von 14:00 bis 16:00

<effectiveTime xsi:type="SXPR_TS">
	<comp xsi:type="PIVL_TS" alignment="DY"> 
		<phase> 
			<low value="200503011400"/>
			<width value="2" unit="h"/>
		</phase>
		<period value="1" unit="a"/>
	</comp>
	<comp xsi:type="PIVL_TS" operator="I" alignment="DY"> 
		<phase> 
			<low value="200508011400"/>
			<width value="2" unit="h"/>
		</phase>
		<period value="1" unit="a"/>
	</comp>
</effectiveTime>