Hilfe:Terminologien: Unterschied zwischen den Versionen
K |
|||
| (9 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
| + | =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= | =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. | 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. | ||
| Zeile 7: | Zeile 10: | ||
* Value Sets (V), zusammengefasst in der Kategorie ''[[:Kategorie:Value Set|Value Set]]''. | * Value Sets (V), zusammengefasst in der Kategorie ''[[:Kategorie:Value Set|Value Set]]''. | ||
| − | ==Transklusion== | + | 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. |
| − | In den Wiki-Leitfäden werden | + | |
| + | ==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'' (Format: YYYY-MM-DD) 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. | ||
| Zeile 22: | Zeile 27: | ||
Beispiel: | Beispiel: | ||
| − | < | + | <syntaxhighlight lang="text"> |
#REDIRECT [[2.16.840.1.113883.5.1/static-2005-05-01]] | #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. | 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: | Beispiel: | ||
| − | < | + | <syntaxhighlight lang="text"> |
#REDIRECT [[2.16.840.1.113883.5.1]] | #REDIRECT [[2.16.840.1.113883.5.1]] | ||
[[Kategorie:Kodesystem]] | [[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.}} | {{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.}} | ||
| Zeile 38: | Zeile 43: | ||
===Beispiel DYNAMIC=== | ===Beispiel DYNAMIC=== | ||
Transklusion eines Value Sets in der neuesten Version: | Transklusion eines Value Sets in der neuesten Version: | ||
| − | < | + | <syntaxhighlight lang="text"> |
{{:2.16.840.1.113883.1.11.1/dynamic}} | {{:2.16.840.1.113883.1.11.1/dynamic}} | ||
| − | </ | + | </syntaxhighlight> |
{{:2.16.840.1.113883.1.11.1/dynamic}} | {{:2.16.840.1.113883.1.11.1/dynamic}} | ||
===Beispiel STATIC=== | ===Beispiel STATIC=== | ||
| − | Transklusion eines Value Sets in der Version vom | + | Transklusion eines Value Sets in der Version vom 2012-07-24: |
| − | < | + | <syntaxhighlight lang="text"> |
| − | {{:2.16.840.1.113883.1.11.16926/static- | + | {{:2.16.840.1.113883.1.11.16926/static-2012-07-24}} |
| − | </ | + | </syntaxhighlight> |
| − | {{:2.16.840.1.113883.1.11.16926/static- | + | {{:2.16.840.1.113883.1.11.16926/static-2012-07-24}} |
===Beispiele vollständiger Wikiseiten=== | ===Beispiele vollständiger Wikiseiten=== | ||
| Zeile 55: | Zeile 60: | ||
* mit einem Kodesystem inklusive aller Versionen ist [[2.16.840.1.113883.5.1]] | * mit einem Kodesystem inklusive aller Versionen ist [[2.16.840.1.113883.5.1]] | ||
| − | == | + | ==Bot== |
===Arbeitsweise=== | ===Arbeitsweise=== | ||
| − | Die Terminologien werden automatisch als Auszug aus einem Terminologiebestand (Terminologie-Server) mittels eines Bots ( | + | 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=== | ===Hinweise=== | ||
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:
|
