ON

Aus Hl7wiki
(Teildokument von V3 Datentypen Release 1)
Wechseln zu: Navigation, Suche
(ON (Organisationsname – Organization Name))
 
(7 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 2: Zeile 2:
 
== ON (Organisationsname – Organization Name) ==
 
== ON (Organisationsname – Organization Name) ==
  
Definition: Ein Name einer Organisation.
+
Definition: Ein Name einer Organisation.  
  
 
Attribut:
 
Attribut:
{{AttDesc | att | use | Benutzertype(n), nicht verwenden in DE | SET<CS> }}
+
{{AttDesc
 +
| ae = att
 +
| rim =
 +
| name = use
 +
| desc = Benutzertype(n), nicht verwenden in DE
 +
| dt = SET<CS>
 +
| card =
 +
| conf =
 +
}}
  
 
Element:
 
Element:
{{AttDesc | elm | validTime | Gültigkeitszeitraum | IVL<TS> }}
+
{{AttDesc
 +
| ae = elm
 +
| rim =
 +
| name = validTime
 +
| desc = Gültigkeitszeitraum
 +
| dt = IVL<TS>
 +
| card = 0..*
 +
| conf = O
 +
}}
  
 
Struktur:
 
Struktur:
Zeile 16: Zeile 32:
 
'''''XML-Beispiel'''''
 
'''''XML-Beispiel'''''
  
minimaal
+
minimal
{{HL7XML
+
<syntaxhighlight lang="xml">
| code =
+
<name>Universität zu Köln</name>
<name>
+
</syntaxhighlight>
    Universität zu Köln
 
</name>
 
}}
 
 
Beachten Sie, dass der Text des Namens ohne Anführungszeichen übermittelt wird.
 
Beachten Sie, dass der Text des Namens ohne Anführungszeichen übermittelt wird.
  
{{AttDesc | att | use | Benutzungstype(n) | }}
+
{{AttDesc | ae=att | rim= | name=use | desc=Benutzungstype(n) | dt= | card= | conf= }}
 
Im Prinzip kann von jedem ''Organization Name'' angegeben werden, in welcher Situation dieser benutzt werden kann. Für Deutschland wurde aber beschlossen, dass der Unterschied (noch) nicht relevant ist, so dass die Empfehlung lautet, das Attribut ''use'' nicht im XML-Tag zu benutzen.
 
Im Prinzip kann von jedem ''Organization Name'' angegeben werden, in welcher Situation dieser benutzt werden kann. Für Deutschland wurde aber beschlossen, dass der Unterschied (noch) nicht relevant ist, so dass die Empfehlung lautet, das Attribut ''use'' nicht im XML-Tag zu benutzen.
  
{{AttDesc | att | validTime | Gültigkeitszeitraum | }}
+
{{AttDesc | ae=att | rim= | name=validTime | desc=Gültigkeitszeitraum | dt= | card= | conf= }}
 
Dies ist ein '''optionales''' XML Element in ''Organization Name'', das die Periode angibt, in der dieser Name für die betreffende Organisation ‘in Gebrauch’/gültig war. Die Optionen sind:
 
Dies ist ein '''optionales''' XML Element in ''Organization Name'', das die Periode angibt, in der dieser Name für die betreffende Organisation ‘in Gebrauch’/gültig war. Die Optionen sind:
 
:* Es gibt kein ''validTime'' Element: Der betreffende Name ist im Prinzip universell gültig.
 
:* Es gibt kein ''validTime'' Element: Der betreffende Name ist im Prinzip universell gültig.
Zeile 36: Zeile 49:
  
 
'''''XML-Beispiele'''''
 
'''''XML-Beispiele'''''
Unter- und Obergrenze
+
 
{{HL7XML
+
Unter- und Obergrenze: Der Name war gültig vom 1.1.2003 bis vor dem 31.12.2004.
| code =
+
<syntaxhighlight lang="xml">
 
<name>
 
<name>
 
     <validTime>
 
     <validTime>
Zeile 45: Zeile 58:
 
     </validTime>
 
     </validTime>
 
     Medizinische Einrichtungen der Universität zu Köln
 
     Medizinische Einrichtungen der Universität zu Köln
     <nowiki><!-- der alte Name der Organisation --></nowiki>
+
     <!-- der alte Name der Organisation -->
 
</name>  
 
</name>  
}}
+
</syntaxhighlight>
Der Name war gültig vom 1.1.2003 bis einschl. 31.12.2004.
 
  
Nur Untergrenze
+
Nur Untergrenze: Der Name ist gültig seit dem 13.1.2005.
{{HL7XML
+
<syntaxhighlight lang="xml">
| code =
 
 
<name>
 
<name>
 
     <validTime>
 
     <validTime>
Zeile 59: Zeile 70:
 
     Klinikum der Universität zu Köln
 
     Klinikum der Universität zu Köln
 
</name>  
 
</name>  
}}
+
</syntaxhighlight>
Der Name ist gültig seit dem 1.1.2005.
 
  
Nur Obergrenze
+
Nur Obergrenze: Der Name ist gültig bis zum (und ausschließlich dem) 31.12.2005.
{{HL7XML
+
<syntaxhighlight lang="xml">
| code =
 
 
<name>
 
<name>
 
     <validTime>
 
     <validTime>
Zeile 71: Zeile 80:
 
     Medizinische Einrichtungen der Universität zu Köln
 
     Medizinische Einrichtungen der Universität zu Köln
 
</name>  
 
</name>  
}}
+
</syntaxhighlight>
Der Name ist gültig bis einschließlich 31.12.2005.
 
  
 
Sowohl die Untergrenze als auch die Obergrenze von ''validTime'' können in der Zukunft liegen, um einen geplanten neuen Namen oder ein geplantes Verfallsdatum für einen bestehenden Namens anzugeben.
 
Sowohl die Untergrenze als auch die Obergrenze von ''validTime'' können in der Zukunft liegen, um einen geplanten neuen Namen oder ein geplantes Verfallsdatum für einen bestehenden Namens anzugeben.
  
{{BeginEMBox}}
+
{{fmbox|
In allen Situationen, in denen ein oder mehrere ''Organization Names'' übermittelt werden, muss minimal der Name angegeben werden, der zum Zeitpunkt des Versendens gültig/aktuell ist. Nicht mehr gültige Namen können also nur übermittelt werden, wenn das betreffende Nachrichtenelement wiederholt benutzt wird (also mit max. Kardinalität > 1).
+
text =In allen Situationen, in denen ein oder mehrere ''Organization Names'' übermittelt werden, muss minimal der Name angegeben werden, der zum Zeitpunkt des Versendens gültig/aktuell ist. Nicht mehr gültige Namen können also nur übermittelt werden, wenn das betreffende Nachrichtenelement wiederholt benutzt wird (also mit max. Kardinalität > 1).
{{EndEMBox}}
+
}}
  
 
Wiederholter Name
 
Wiederholter Name
{{HL7XML
+
<syntaxhighlight lang="xml">
| code =
 
 
<name>
 
<name>
 
     <validTime>  
 
     <validTime>  
Zeile 102: Zeile 109:
 
     Zukunftsorganisation
 
     Zukunftsorganisation
 
</name>  
 
</name>  
}}
+
</syntaxhighlight>

Aktuelle Version vom 10. März 2013, 12:45 Uhr

Dieses Material ist Teil des Leitfadens V3 Datentypen Release 1.
  • Direkt im Wiki geändert werden sollten Schreibfehler, ergänzende Hinweise.
  • Offene Fragen, die der Diskussionen bedürfen, sollten auf der Diskussionsseite aufgenommen werden.
  • Liste der Seiten dieses Leitfadens: hier, Liste der Seiten, in denen dieses Material verwendet (transkludiert) siehe hier .

ON (Organisationsname – Organization Name)

Definition: Ein Name einer Organisation.

Attribut:

@ Attribut DT Card Conf Beschreibung
use SET<CS> Benutzertype(n), nicht verwenden in DE


Element:

< Element DT Card Conf Beschreibung
validTime IVL<TS> 0..* O Gültigkeitszeitraum


Struktur:

Der Datentyp ON ist eine Extension des Datentyps EN (Entity Name) und besteht demnach aus dem so genannten ‘mixed content’ Inhalt, in dem im Prinzip name parts angegeben werden können. Für Deutschland wurde vorläufig abgesprochen, keine organization name parts zu verwenden und den Namen immer als ein Text auszudrucken. Das heißt, dass ON in Deutschland faktisch identisch wird mit dem Datentyp TN (Trivial Name).

XML-Beispiel

minimal

<name>Universität zu Köln</name>

Beachten Sie, dass der Text des Namens ohne Anführungszeichen übermittelt wird.

@ Attribut DT Card Conf Beschreibung
use Benutzungstype(n)

Im Prinzip kann von jedem Organization Name angegeben werden, in welcher Situation dieser benutzt werden kann. Für Deutschland wurde aber beschlossen, dass der Unterschied (noch) nicht relevant ist, so dass die Empfehlung lautet, das Attribut use nicht im XML-Tag zu benutzen.

@ Attribut DT Card Conf Beschreibung
validTime Gültigkeitszeitraum

Dies ist ein optionales XML Element in Organization Name, das die Periode angibt, in der dieser Name für die betreffende Organisation ‘in Gebrauch’/gültig war. Die Optionen sind:

  • Es gibt kein validTime Element: Der betreffende Name ist im Prinzip universell gültig.
  • Es gibt eine Unter- und Obergrenze: Der Name war in der angegebenen Periode gültig.
  • Es gibt nur eine Untergrenze: Der Name ist seit dem angegebenen Datum gültig.
  • Es gibt nur eine Obergrenze: Der Name war bis einschließlich dem angegebenen Datum gültig.

XML-Beispiele

Unter- und Obergrenze: Der Name war gültig vom 1.1.2003 bis vor dem 31.12.2004.

<name>
    <validTime>
        <low value="20030101"/>
        <high value="20041231"/>
    </validTime>
    Medizinische Einrichtungen der Universität zu Köln
    <!-- der alte Name der Organisation -->
</name>

Nur Untergrenze: Der Name ist gültig seit dem 13.1.2005.

<name>
    <validTime>
        <low value="20050113"/>
    </validTime>
    Klinikum der Universität zu Köln
</name>

Nur Obergrenze: Der Name ist gültig bis zum (und ausschließlich dem) 31.12.2005.

<name>
    <validTime>
        <high value="20051231"/>
    </validTime>
    Medizinische Einrichtungen der Universität zu Köln
</name>

Sowohl die Untergrenze als auch die Obergrenze von validTime können in der Zukunft liegen, um einen geplanten neuen Namen oder ein geplantes Verfallsdatum für einen bestehenden Namens anzugeben.

Wiederholter Name

<name>
    <validTime> 
        <high value="20041231"/>
    </validTime>
    Altorganisation
</name>
<name>
    <validTime>
        <low value="20050101"/>
        <high value="20091231"/>
    </validTime>
    Jetzorganisation
</name>
<name>
    <validTime>
        <low value="20100101"/>
    </validTime>
    Zukunftsorganisation
</name>