Hilfe:Terminologien: Unterschied zwischen den Versionen

Aus Hl7wiki
Wechseln zu: Navigation, Suche
K
 
(27 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
Im HL7-Wiki stehen (Zug um Zug) alle Terminologien zur Verfügung. Diese werden automatisch als Auszug aus einem Terminologiebestand (Terminologie-Server) mittels eines Bots (TermBot) gezogen.
+
=Aktuelle Arbeiten im Technischen Komitee "TC Terminologien"=
 +
Hier ein Link zu weiteren Wiki-Seiten des TC. https://github.com/hl7germany/TC-Terminologie/wiki
 +
 
 +
=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:
 
Terminologiebestände betreffen:
* Konzeptdomänen (D)
+
* Konzeptdomänen (D), zusammengefasst in der Kategorie ''Konzeptdomänen''
* Kodeysteme (C)
+
* Kodeysteme (C), zusammengefasst in der Kategorie ''[[:Kategorie:Kodesystem|Kodesystem]]''
* Value Sets (V).
+
* Value Sets (V), zusammengefasst in der Kategorie ''[[:Kategorie:Value Set|Value Set]]''.
  
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:
+
In Leitfäden werden nur und ausschließlich Value Sets verwendet und referenziert. Eine Bindung eines Attributes an ein Kodesystem oder eine Konzeptdomäne ist nicht vorgesehen.
 +
 
 +
==Einbindung mittels Transklusion==
 +
In den Wiki-Leitfäden werden Value Sets (und wenn notwendig Kodesysteme) 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.
 
* 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'' der Terminologie notwendig. STATIC beinhaltet, dass die Terminologien einer Spezifikation bei einer bestimmten Version "eingefroren" sind.
+
* 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 [[:Kategorie:Kodesystem|Kodesystem]] bzw. [[:Kategorie:Value Set|Value Set]].
 +
 
 +
Es gibt ein bis viele Unterseiten mit der Namenskonvention <tt>/static-YYYY-MM-DD</tt> für die jeweiligen statischen Versionen der Terminologie.
 +
 
 +
Eine Unterseite <tt>/dynamic</tt> weist nach der letzten gültigen (aktuellen) Terminologie über ein redirect.
 +
 
 +
Beispiel:
 +
<syntaxhighlight lang="text">
 +
#REDIRECT [[2.16.840.1.113883.5.1/static-2005-05-01]]
 +
</syntaxhighlight>
 +
 
 +
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:
 +
<syntaxhighlight lang="text">
 +
#REDIRECT [[2.16.840.1.113883.5.1]]
 +
[[Kategorie:Kodesystem]]
 +
</syntaxhighlight>
 +
{{AlertBox|Es ist zu beachten, dass diese Seiten '''nicht''' per Hand editiert werden, da sie vom TermBot automatisch erstellt und ggf. manuelle Änderungen überschrieben werden.}}
 +
 
 +
==Beispiele==
 +
===Beispiel DYNAMIC===
 +
Transklusion eines Value Sets in der neuesten Version:
 +
<syntaxhighlight lang="text">
 +
{{:2.16.840.1.113883.1.11.1/dynamic}}
 +
</syntaxhighlight>
 +
{{:2.16.840.1.113883.1.11.1/dynamic}}
  
Terminologien werden im HL7-Wiki über ihre OID identifiziert und können auch jederzeit als Wikiseite aufgerufen werden (inklusive aller Versionen).
+
===Beispiel STATIC===
 +
Transklusion eines Value Sets in der Version vom 2012-07-24:
 +
<syntaxhighlight lang="text">
 +
{{:2.16.840.1.113883.1.11.16926/static-2012-07-24}}
 +
</syntaxhighlight>
 +
{{:2.16.840.1.113883.1.11.16926/static-2012-07-24}}
  
Beispiel DYNAMIC: Transklusion eines Value Sets in der neuesten Version:
+
===Beispiele vollständiger Wikiseiten===
<pre>
+
Ein Beispiel einer vollständigen Wikiseite
{{:2.16.840.1.113883.1.11.16926/dynamic}}
+
* mit einem Value Set inklusive aller Versionen ist [[2.16.840.1.113883.1.11.16926]]
</pre>
+
* mit einem Kodesystem inklusive aller Versionen ist [[2.16.840.1.113883.5.1]]
  
Beispiel STATIC: Transklusion eines Value Sets in der Version vom 2010-04-21:
+
==Bot==
<pre>
+
===Arbeitsweise===
{{:2.16.840.1.113883.1.11.16926/static-v1-2010-04-21}}
+
Die Terminologien werden automatisch als Auszug aus einem Terminologiebestand (Terminologie-Server) mittels eines Bots (ADbot) gezogen. Das Vorgehen ist dabei, dass alle Dateien, die sich in der Kategorie Value Set oder Kodesystem befinden, automatisch vom Bot geupdatet werden.
</pre>
 
  
Ein Beispiel einer vollständigen Wikiseite mit einem Value Set inklusive aller Versionen ist [[2.16.840.1.113883.1.11.16926]]
+
===Hinweise===
 +
Auf den Terminologie-Seiten finden sich folgende Hinweise:
 +
{{fmbox
 +
| image = none
 +
| text = {{:Terminologiehinweis}}
 +
}}

Aktuelle Version vom 3. Dezember 2021, 11:27 Uhr

Aktuelle Arbeiten im Technischen Komitee "TC Terminologien"

Hier ein Link zu weiteren Wiki-Seiten des TC. https://github.com/hl7germany/TC-Terminologie/wiki

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.

In Leitfäden werden nur und ausschließlich Value Sets verwendet und referenziert. Eine Bindung eines Attributes an ein Kodesystem oder eine Konzeptdomäne ist nicht vorgesehen.

Einbindung mittels Transklusion

In den Wiki-Leitfäden werden Value Sets (und wenn notwendig Kodesysteme) 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}}
Id2.16.840.1.113883.1.11.1Gültigkeit2014‑03‑26
StatusKgreen.png DefinitivVersions-LabelDEFN=UV=VO=1360-20160323
NameAdministrativeGenderBezeichnungAdministrativeGender
BeschreibungEN-US.png

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/ TypCodeBezeichnungCodesystem
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 2012-07-24:

{{:2.16.840.1.113883.1.11.16926/static-2012-07-24}}
Value Set Name Value Set Id Version / Eingangsdatum Status
x_BasicConfidentialityKind 2.16.840.1.113883.1.11.16926 2012-07-24 definitiv
Quell-Kodesystem(e):
Level/Typ Code Anzeigename Kodesystem
0-L N normal Confidentiality
0-L R restricted Confidentiality
0-L V very restricted Confidentiality

Beispiele vollständiger Wikiseiten

Ein Beispiel einer vollständigen Wikiseite

Bot

Arbeitsweise

Die Terminologien werden automatisch als Auszug aus einem Terminologiebestand (Terminologie-Server) mittels eines Bots (ADbot) 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: