Hilfe:Terminologien: Unterschied zwischen den Versionen
K |
|||
(26 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt) | |||
Zeile 1: | Zeile 1: | ||
− | Im HL7-Wiki stehen (Zug um Zug) alle Terminologien zur Verfügung. | + | =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 | + | 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}} | ||
− | Beispiel | + | ===Beispiel STATIC=== |
− | < | + | Transklusion eines Value Sets in der Version vom 2012-07-24: |
− | {{:2.16.840.1.113883.1.11.16926/ | + | <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 | + | ===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]] | |
− | + | ==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: | ||
+ | {{fmbox | ||
+ | | image = none | ||
+ | | text = {{:Terminologiehinweis}} | ||
+ | }} |
Aktuelle Version vom 3. Dezember 2021, 11:27 Uhr
Inhaltsverzeichnis
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]]
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:
{{: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 | ||||||||||||||||||||||
| |||||||||||||||||||||||
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
- 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
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:
|