Hilfe:Terminologien

Terminologien im HL7-Wiki

Im HL7-Wiki stehen (Zug um Zug) alle Terminologien zur Verfügung, die in den Leitfäden oder anderen Seiten erwähnt werden und inhaltlich, zum Beispiel als Tabelle von Kodes, gezeigt werden sollen. Die Terminologien werden automatisch als Auszug aus einem Terminologiebestand (Terminologie-Server) mittels eines Bots (TermBot) gezogen.

Terminologiebestände betreffen:

• Konzeptdomänen (D), zusammengefasst in der Kategorie Konzeptdomänen
• Kodeysteme (C), zusammengefasst in der Kategorie Kodesystem
• Value Sets (V), zusammengefasst in der Kategorie Value Set.

Transklusion

In den Wiki-Leitfäden werden Kodesysteme und Value Sets in aller Regel transkludiert, das heißt nicht in den laufenden Text hineinkopiert, sondern über Transklusion dargestellt. Dazu stehen zwei Möglichkeiten zur Verfügung:

• DYNAMIC, das heißt, dass das Kodesystem oder Value Set immer in der neuesten Fassung dargestellt wird; das beinhaltet auch, dass die Spezifikationen in Bezug auf transkludierte Terminologien immer auf dem neuesten Stand sind, aber eben auch, dass sie sich im Prinzip jederzeit ändern können.
• STATIC, das heißt, dass das Kodesystem oder Value Set einer bestimmten Version transkludiert wird; hierzu ist die Angabe der Version in Form des effectiveDate (Format: YYYY-MM-DD) der Terminologie notwendig. STATIC beinhaltet, dass die Terminologien einer Spezifikation bei einer bestimmten Version "eingefroren" sind.

Terminologien werden im HL7-Wiki über ihre OID identifiziert und können auch jederzeit als Wikiseite aufgerufen werden. Als Dokumentenname gilt die OID selbst. Dort werden zum Kodesystem bzw. Value Set Beschreibungen, die aktuelle und ältere Versionen sowie Referenzen gezeigt.

Seitenstruktur

Jedes Kodesystem oder Value Set hat als Namen der Hauptseite die zugehörige OID. Diese Seiten befinden sich in den Kategorien Kodesystem bzw. Value Set.

Es gibt ein bis viele Unterseiten mit der Namenskonvention /static-YYYY-MM-DD für die jeweiligen statischen Versionen der Terminologie.

Eine Unterseite /dynamic weist nach der letzten gültigen (aktuellen) Terminologie über ein redirect.

Beispiel:

#REDIRECT [[2.16.840.1.113883.5.1/static-2005-05-01]]

Zudem ist eine Seite angelegt, die den Namen des Kodesystems oder Value Sets enthält, zusammen mit dem in Klammern geschrieben Typ ("Kodesystem" bzw. "Value Set"). Diese Seite verweist direkt zur OID-Seite der Terminologie. Sie ist außerdem in die entsprechende Kategorie eingeordnet, so dass sie bei den Kategorielisten mit aufgezählt wird.

Beispiel:

#REDIRECT [[2.16.840.1.113883.5.1]]
[[Kategorie:Kodesystem]]

Beispiele

Beispiel DYNAMIC

Transklusion eines Value Sets in der neuesten Version:

{{:2.16.840.1.113883.1.11.1/dynamic}}

Id	2.16.840.1.113883.1.11.1	Gültigkeit	2014‑03‑26
Status	Definitiv	Versions-Label	DEFN=UV=VO=1360-20160323
Name	AdministrativeGender	Bezeichnung	AdministrativeGender
Beschreibung	History description 2014-03-26: Lock all vaue sets untouched since 2014-03-26 to trackingId 2014T1_2014_03_26 description: The gender of a person used for adminstrative purposes (as opposed to clinical gender)
Quell-Codesystem	2.16.840.1.113883.5.1 - Administrative Gender - http://terminology.hl7.org/CodeSystem/v3-AdministrativeGender
Level/ Typ Code Bezeichnung Codesystem 0‑L F Female Administrative Gender 0‑L M Male Administrative Gender 0‑L UN Undifferentiated Administrative Gender
Legende: Typ L=leaf, S=specializable, A=abstract, D=deprecated. NullFlavors werden im @nullFlavor Attribut statt in @code angegeben. NullFlavor OTH (other) schlägt Text in originalText vor.

Beispiel STATIC

Transklusion eines Value Sets in der Version vom 2010-04-21:

{{:2.16.840.1.113883.1.11.16926/static-2010-04-21}}

Value Set Name			Value Set Id	Effective date
BasicConfidentialityKind			2.16.840.1.113883.1.11.16926	2010-04-21
Source Code System: 2.16.840.1.113883.5.25 (Confidentiality)
Level/ Type	Code	Codesystem	Kurzbezeichnung	Beschreibung
0-L	N	Confidentiality	normal	Normale Vertraulichkeitsregeln sind anzuwenden. Nur autorisiertes Personal im Bereich Medizin, darf auf die Daten zugreifen.
0-L	R	Confidentiality	restricted	Eingeschränkter Zugriff, nur Personal in einer zeitnahen medizinischen Dienstleistungsfunktion darf auf die Daten zugreifen.
0-L	V	Confidentiality	very restricted	Stark eingeschränkter Zugriff, Zugriffsregeln gibt der „Privacy Officer" des Daten-Anbieters vor.

Beispiele vollständiger Wikiseiten

Ein Beispiel einer vollständigen Wikiseite

• mit einem Value Set inklusive aller Versionen ist 2.16.840.1.113883.1.11.16926
• mit einem Kodesystem inklusive aller Versionen ist 2.16.840.1.113883.5.1

TermBot

Arbeitsweise

Die Terminologien werden automatisch als Auszug aus einem Terminologiebestand (Terminologie-Server) mittels eines Bots (TermBot) gezogen. Das Vorgehen ist dabei, dass alle Dateien, die sich in der Kategorie Value Set oder Kodesystem befinden, automatisch vom Bot geupdatet werden.

Hinweise

Auf den Terminologie-Seiten finden sich folgende Hinweise: