v3dtr1:PN: Unterschied zwischen den Versionen

Aus Hl7wiki
Wechseln zu: Navigation, Suche
(Die Seite wurde neu angelegt: = PN (Personenname – Person Name) = Ein Name einer Person. Attribut: {{AttDesc | att | use | Benutzertyp(en) | SET<CS> }} Elemente: {{AttDesc | elm | validTime | G...)
 
(PN (Personenname – Person Name))
Zeile 1: Zeile 1:
 
= PN (Personenname – Person Name) =
 
= PN (Personenname – Person Name) =
 
Ein Name einer Person.
 
Ein Name einer Person.
 +
  
 
Attribut:
 
Attribut:
Zeile 23: Zeile 24:
 
Nähere Erläuterungen finden Sie bei den verschiedenen ''person name parts''.
 
Nähere Erläuterungen finden Sie bei den verschiedenen ''person name parts''.
 
{{EndEMBox}}
 
{{EndEMBox}}
 +
 +
== XML Beispiel ==
 +
 +
Personennamen als Freitext:
 +
 +
{{HL7XML
 +
| code =
 +
<name>
 +
Jan Meier
 +
</name>
 +
}}
 +
 +
Der Name wurde ohne interne Struktur übermittelt.
 +
 +
 +
Personenname mit name parts:
 +
{{HL7XML
 +
| code =
 +
<name>
 +
<given>Jan</given>
 +
<family>Meier</family>
 +
</name>
 +
}}
 +
Die beiden Bestandteile des Namens werden benannt und erhalten einen qualifier: “Jan” ist ein ‘Name, der bei der Geburt gegeben wurde’, bzw. ein Vorname (voll aus-geschrieben). “Meier” ist ein ‘Familienname, der bei der Geburt empfangen wurde’, bzw. der eigene Nachname.
 +
 +
 +
Ungültiger Personenname:
 +
{{HL7XML
 +
| code =
 +
<name>
 +
Jan <family>Meier</family>
 +
</name>
 +
| error = true
 +
}}
 +
Dies ist kein gültiger Personenname, da Freitext mit einem name part kombiniert wurde.
 +
 +
{{AttDesc | att | use | Namenverwendungstyp | en }}
 +
Im Prinzip kann von jedem Person Name angegeben werden, in welcher Situation dieser verwendet werden kann. Für Deutschland wurde beschlossen, dass die folgenden Verwendungstypen für Namen zugelassen sind:
 +
 +
{| class="wikitable"
 +
|+ Tabelle: Domäne EntityNameUse Attribut Werte
 +
! Code !! Name !! Definition
 +
|-
 +
|L|| Regulärer Name ||Der Name, den die Person (Entität) führt. Die Abkürzung ‘L’ stand ursprünglich für Legal (gesetzlich), Tatsache ist aber, dass in dem Namen auch Komponenten vorkommen dürfen (z.B. ein Rufname), die nicht gesetzlich festgelegt sind. Dieser Namenverwendungstyp ist der '''Default''', wenn kein Typ durchgegeben wird.
 +
|-
 +
|A|| Pseudonym|| Ein Künstlername, ‘Deckname’ oder zeitlicher Name für eine Person (Entität). Dieser weicht also von dem regulär geführten Namen ab und wird z.B. benutzt, um die Identität einer Person zu tarnen (Privacy) oder als temporärer Name, wenn der echte unbekannt ist (‘John Doe’).
 +
|-
 +
|OR|| Gesetzlich registrierter Name|| Der Name mit den exakten Komponenten, der im Einwohnermeldeamt des betreffenden Landes registriert ist.
 +
|}
 +
 +
{{BeginEMBox}}
 +
Beachten Sie, dass ein Name auch zwei ''use'' Attribute haben darf. Das kann z.B. vorkommen, wenn der gesetzlich registrierte Name (‘OR’) auch als regulärer Name geführt wird (siehe nachstehendes Beispiel). Achten Sie aber darauf, dass dann keine einzige Komponente vorkommen darf (wie Rufname oder ein Partnername) die nicht Teil des gesetzlich registrierten Namens ist. 
 +
{{EndEMBox}}
 +
 +
{{BeginHL7Box}}
 +
Der use code ‘OR’ ist noch nicht im offiziellen HL7 Standard aufgenommen. Er wurde aber, vorauslaufend auf die internationale Harmonisierung, bereits hinzugefügt.
 +
{{EndHL7Box}}
 +
 +
 +
== XML Beispiele ==
 +
 +
Der reguläre Name als default, also kein ''use'' Attribut
 +
{{HL7XML
 +
| code =
 +
<name>
 +
<!-- Name, unterverteilt in Komponenten -->
 +
</name>
 +
}}
 +
 +
Ein Pseudonym eines Patienten
 +
{{HL7XML
 +
| code =
 +
<name use=”A”>
 +
<!-- Name, unterverteilt in Komponenten -->
 +
</name>
 +
}}
 +
 +
Der gesetzlich registrierte Name
 +
{{HL7XML
 +
| code =
 +
<name use=”OR”>
 +
<!-- Name, unterverteilt in Komponenten -->
 +
</name>
 +
}}
 +
 +
Der geführte Name stimmt exakt mit dem gesetzlich registrierten Namen überein
 +
{{HL7XML
 +
| code =
 +
<name use=”OR L”>
 +
<!-- Name, unterverteilt in Komponenten -->
 +
</name>
 +
}}
 +
 +
{{AttDesc | elm | validTime | Gültigkeitszeitraum | }}
 +
Dies ist ein '''optionales''' XML Element innerhalb ''Person Name'', welches die Periode angibt, in der dieser Name für die betreffende Person ‘in Gebrauch’/gültig war. Die Optionen sind:
 +
:*Es gibt kein ''validTime'' Element: Der betreffende Name ist im Prinzip unbegrenzt 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 einschl. angegebenem Datum gültig.
 +
 +
Dieses Element von ''Person Name'' kann verwendet werden, um anzugeben, dass im Leben einer Person einmal oder mehrmals eine Namensänderung stattgefunden hat. Dies geschieht u.a bei:
 +
:*Adoption eines Babys, das den Nachnamen der Adoptiveltern erhält.
 +
:*Eheschließung, wobei der Name des Partners an den eigenen Namen angefügt wird.
 +
:*Ehescheidung, wobei ein vorher angenommener Name wieder abgelegt wird.
 +
:*Personen, die aus anderen Gründen ihren Vor- oder Nachnamen ändern. 
 +
 +
{{BeginEMBox}}
 +
In allen Situationen, in denen ein oder mehrere ''Person Names'' durchgegeben werden, muss minimal der Name angegeben werden, der zum Zeitpunkts des Versendens gültig/aktuell ist. Nicht mehr gültige Namen können also nur angegeben werden, wenn das betreffende Nachrichtenelement wiederholt benutzt wird (also mit einer Kardinalität > 1).
 +
{{EndEMBox}}
 +
 +
 +
Zu beachten ist, dass viele Patientenerfassungssysteme keine wirkliche Historie (mit Anfangsdatum) der Patientennamen führen. Wohl wird häufig ein allgemeines ‘audit trail’ (Änderungshistorie) der Patientendaten geführt. Im Bedarfsfall könnte daraus die Historie des Personennamens abgeleitet werden, obwohl es natürlich auch möglich ist, nur den aktuellen Namen durchzugeben (also kein ''validTime'' zu verwenden).
 +
 +
 +
{{BeginEMBox}}
 +
Im Gegensatz zu der Situation bei ''Organization Name'' ist es nicht zugelassen, dass die Unter- oder Obergrenze einer ''validTime'' Angabe bei ''Person Name'' in de Zukunft liegt. Es kann also kein ‘geplanter’ neuer Name oder ein ‘geplantes Verfallsdatum’ des heutigen Namens für Personennamen durchgegeben werden.
 +
{{EndEMBox}}
 +
 +
 +
Der aktuelle Name ist gültig seit dem 12. Juli 2005
 +
{{HL7XML
 +
| code =
 +
<name>
 +
<validTime>
 +
<low value="20050712"/>
 +
</validTime>
 +
<!-- Name, unterverteilt in Komponenten -->
 +
</name>
 +
}}
 +
Obenstehende Situation kann z.B. bei einem System vorkommen, das nur den aktuellen Namen übermittelt, aber auch die Historie führt. Die oben genannte Person kann z.B. am 12. Juli geheiratet haben und dabei den Namen des Partners angenommen haben.
 +
 +
 +
Alte Namen plus aktueller Name
 +
{{HL7XML
 +
| code =
 +
<name>
 +
<validTime>
 +
<high value="19850412"/>
 +
</validTime>
 +
<!-- “Nicole de Vries” als Name des Babys vor der Adoption -->
 +
</name>
 +
 +
 +
<name>
 +
<validTime>
 +
<low value="19850413"/>
 +
<high value="20050824"/>
 +
</validTime>
 +
<!-- “Nicolette Scheick” als Name nach der Adoption, aber vor Eheschließung -->
 +
</name>
 +
}}
 +
{{HL7XML
 +
| code =
 +
<name>
 +
<validTime>
 +
<low value="20050825"/>
 +
</validTime>
 +
<!-- “Nicolette Scheick-Jansen” als Name nach der Eheschließung -->
 +
</name>
 +
}}
 +
In vorstehendem Beispiel wird das Baby Nicole de Vries von der Familie Scheick adoptiert, wobei sich also ihr Nachname ändert. Weil den Adoptiveltern dieser Name besser gefällt, wird auch ihr Vorname (oder auf jeden Fall ihr Rufname) geändert in Nicolette. Nach ihrer Eheschließung nimmt sie den Nachnamen ihres Partners (Jansen) an. Das sendende System sendet in diesem Fall die gesamte Namenshistorie mit.
 +
 +
{{AttDesc | elm | delimiter | Trennzeichen | }}
 +
Ein ''delimiter'' hat keine spezielle Bedeutung als Bestandteil eines ''Person Name'', im Gegensatz zur Übermittlung eines (Stückchens) wörtlichem Text, der in dem geschriebenen Namen vorkommt.
 +
 
 +
Ein ''delimiter'' muss immer an der Stelle in ''Person Name'' stehen, an der man auch den Text schreiben würde. Es gibt keine impliziten Leerstellen. Wenn man also normalerweise eine Leerstelle davor oder dahinter schreibt, muss diese explizit angegeben werden.
 +
 +
Beispiele von ''delimiters'' in ''Person Names'' sind:
 +
:*Der Bindestrich ‘-‘ zwischen dem eigenen Nachnamen und dem Partnernamen (oder umgekehrt).
 +
:*Das Komma plus Leerstelle ‘, ‘ zwischen dem Namen und bestimmten Nachsilben.
 +
:*Der Text ‘, geb. ’ oder ‘, E.v. ‘ (Ehefrau von), der manchmal benutzt wird bei dem eigenen, bzw. Partnernamen.

Version vom 12. April 2009, 22:36 Uhr

PN (Personenname – Person Name)

Ein Name einer Person.


Attribut:

DT Card Conf Beschreibung


Elemente:

DT Card Conf Beschreibung
DT Card Conf Beschreibung
DT Card Conf Beschreibung
DT Card Conf Beschreibung
DT Card Conf Beschreibung
DT Card Conf Beschreibung

Struktur: Der Daten-Typ PN ist eine Extension des Daten-Typs EN (Entity Name) und besitzt folglich einen sogenannten ‘mixed content’, wobei im Prinzip Freitext mit name parts kombiniert werden kann. Für Deutschland gilt, dass die Verwendung von ‘mixed content’ bei Personennamen begrenzt ist. Zugelassen sind:

  • Der vollständige Personenname als Freitext (es gibt also keine person name parts), wenn es dem Sender nicht möglich ist, Teile des Namen zu benennen.
  • Alle Teileinheiten sind als person name part definiert. In einem solchen Fall darf also kein Text vorkommen, der nicht von einem der nachstehend beschriebenen Tags begleitet wird.

Vorlage:BeginEMBox Die Sequenz der person name parts ist relevant! Als Richtlinie gilt, dass diese in der ‘natürlichen’ Sequenz der Benutzung des Namens angegeben werden. Die angegebene Sequenz ist besonders in den folgenden Fällen wichtig:

  • Präfixe (prefix) müssen immer vor dem Namen stehen, zu dem sie gehören.
  • Suffixe (suffix) müssen immer hinter dem Namen stehen, zu dem sie gehören.
  • Vornamen (given) müssen immer in der offiziellen (gesetzlichen) Sequenz stehen.
  • Nachnamen (family) und ein eventuelles Trennzeichen (meistens ‘-‘) müssen in der offiziellen Sequenz stehen, abhängig von der Wahl bei der Eheschließung.

Nähere Erläuterungen finden Sie bei den verschiedenen person name parts. Vorlage:EndEMBox

XML Beispiel

Personennamen als Freitext:

<name>
	Jan Meier
</name>

Der Name wurde ohne interne Struktur übermittelt.


Personenname mit name parts:

<name>
	<given>Jan</given>
	<family>Meier</family>
</name>

Die beiden Bestandteile des Namens werden benannt und erhalten einen qualifier: “Jan” ist ein ‘Name, der bei der Geburt gegeben wurde’, bzw. ein Vorname (voll aus-geschrieben). “Meier” ist ein ‘Familienname, der bei der Geburt empfangen wurde’, bzw. der eigene Nachname.


Ungültiger Personenname:

<name>
	Jan <family>Meier</family>
</name>

Dies ist kein gültiger Personenname, da Freitext mit einem name part kombiniert wurde.

DT Card Conf Beschreibung

Im Prinzip kann von jedem Person Name angegeben werden, in welcher Situation dieser verwendet werden kann. Für Deutschland wurde beschlossen, dass die folgenden Verwendungstypen für Namen zugelassen sind:

Tabelle: Domäne EntityNameUse Attribut Werte
Code Name Definition
L Regulärer Name Der Name, den die Person (Entität) führt. Die Abkürzung ‘L’ stand ursprünglich für Legal (gesetzlich), Tatsache ist aber, dass in dem Namen auch Komponenten vorkommen dürfen (z.B. ein Rufname), die nicht gesetzlich festgelegt sind. Dieser Namenverwendungstyp ist der Default, wenn kein Typ durchgegeben wird.
A Pseudonym Ein Künstlername, ‘Deckname’ oder zeitlicher Name für eine Person (Entität). Dieser weicht also von dem regulär geführten Namen ab und wird z.B. benutzt, um die Identität einer Person zu tarnen (Privacy) oder als temporärer Name, wenn der echte unbekannt ist (‘John Doe’).
OR Gesetzlich registrierter Name Der Name mit den exakten Komponenten, der im Einwohnermeldeamt des betreffenden Landes registriert ist.

Vorlage:BeginEMBox Beachten Sie, dass ein Name auch zwei use Attribute haben darf. Das kann z.B. vorkommen, wenn der gesetzlich registrierte Name (‘OR’) auch als regulärer Name geführt wird (siehe nachstehendes Beispiel). Achten Sie aber darauf, dass dann keine einzige Komponente vorkommen darf (wie Rufname oder ein Partnername) die nicht Teil des gesetzlich registrierten Namens ist. Vorlage:EndEMBox

Vorlage:BeginHL7Box Der use code ‘OR’ ist noch nicht im offiziellen HL7 Standard aufgenommen. Er wurde aber, vorauslaufend auf die internationale Harmonisierung, bereits hinzugefügt. Vorlage:EndHL7Box


XML Beispiele

Der reguläre Name als default, also kein use Attribut

<name>
</name>

Ein Pseudonym eines Patienten

<name use=”A”>
</name>

Der gesetzlich registrierte Name

<name use=”OR”>
</name>

Der geführte Name stimmt exakt mit dem gesetzlich registrierten Namen überein

<name use=”OR L”>
</name>
DT Card Conf Beschreibung

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

  • Es gibt kein validTime Element: Der betreffende Name ist im Prinzip unbegrenzt 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 einschl. angegebenem Datum gültig.

Dieses Element von Person Name kann verwendet werden, um anzugeben, dass im Leben einer Person einmal oder mehrmals eine Namensänderung stattgefunden hat. Dies geschieht u.a bei:

  • Adoption eines Babys, das den Nachnamen der Adoptiveltern erhält.
  • Eheschließung, wobei der Name des Partners an den eigenen Namen angefügt wird.
  • Ehescheidung, wobei ein vorher angenommener Name wieder abgelegt wird.
  • Personen, die aus anderen Gründen ihren Vor- oder Nachnamen ändern.

Vorlage:BeginEMBox In allen Situationen, in denen ein oder mehrere Person Names durchgegeben werden, muss minimal der Name angegeben werden, der zum Zeitpunkts des Versendens gültig/aktuell ist. Nicht mehr gültige Namen können also nur angegeben werden, wenn das betreffende Nachrichtenelement wiederholt benutzt wird (also mit einer Kardinalität > 1). Vorlage:EndEMBox


Zu beachten ist, dass viele Patientenerfassungssysteme keine wirkliche Historie (mit Anfangsdatum) der Patientennamen führen. Wohl wird häufig ein allgemeines ‘audit trail’ (Änderungshistorie) der Patientendaten geführt. Im Bedarfsfall könnte daraus die Historie des Personennamens abgeleitet werden, obwohl es natürlich auch möglich ist, nur den aktuellen Namen durchzugeben (also kein validTime zu verwenden).


Vorlage:BeginEMBox Im Gegensatz zu der Situation bei Organization Name ist es nicht zugelassen, dass die Unter- oder Obergrenze einer validTime Angabe bei Person Name in de Zukunft liegt. Es kann also kein ‘geplanter’ neuer Name oder ein ‘geplantes Verfallsdatum’ des heutigen Namens für Personennamen durchgegeben werden. Vorlage:EndEMBox


Der aktuelle Name ist gültig seit dem 12. Juli 2005

<name>
	<validTime>
		<low value="20050712"/>
	</validTime>
</name>

Obenstehende Situation kann z.B. bei einem System vorkommen, das nur den aktuellen Namen übermittelt, aber auch die Historie führt. Die oben genannte Person kann z.B. am 12. Juli geheiratet haben und dabei den Namen des Partners angenommen haben.


Alte Namen plus aktueller Name

<name>
	<validTime>
		<high value="19850412"/>
	</validTime>
</name>


<name>
	<validTime>
		<low value="19850413"/>
		<high value="20050824"/>
	</validTime>
</name>
<name>
	<validTime>
		<low value="20050825"/>
	</validTime>
</name>

In vorstehendem Beispiel wird das Baby Nicole de Vries von der Familie Scheick adoptiert, wobei sich also ihr Nachname ändert. Weil den Adoptiveltern dieser Name besser gefällt, wird auch ihr Vorname (oder auf jeden Fall ihr Rufname) geändert in Nicolette. Nach ihrer Eheschließung nimmt sie den Nachnamen ihres Partners (Jansen) an. Das sendende System sendet in diesem Fall die gesamte Namenshistorie mit.

DT Card Conf Beschreibung

Ein delimiter hat keine spezielle Bedeutung als Bestandteil eines Person Name, im Gegensatz zur Übermittlung eines (Stückchens) wörtlichem Text, der in dem geschriebenen Namen vorkommt.

Ein delimiter muss immer an der Stelle in Person Name stehen, an der man auch den Text schreiben würde. Es gibt keine impliziten Leerstellen. Wenn man also normalerweise eine Leerstelle davor oder dahinter schreibt, muss diese explizit angegeben werden.

Beispiele von delimiters in Person Names sind:

  • Der Bindestrich ‘-‘ zwischen dem eigenen Nachnamen und dem Partnernamen (oder umgekehrt).
  • Das Komma plus Leerstelle ‘, ‘ zwischen dem Namen und bestimmten Nachsilben.
  • Der Text ‘, geb. ’ oder ‘, E.v. ‘ (Ehefrau von), der manchmal benutzt wird bei dem eigenen, bzw. Partnernamen.