Hilfe:Templates

Aus Hl7wiki
Wechseln zu: Navigation, Suche

Templates im HL7-Wiki

Im HL7-Wiki stehen (Zug um Zug) alle Templates zur Verfügung, die in den Leitfäden oder anderen Seiten erwähnt werden und inhaltlich, zum Beispiel als Tabelle, gezeigt werden sollen. Die Templates werden automatisch als Auszug aus dem Template-Repository (ART-DECOR Template-Server) mittels eines Bots (TermBot) gezogen.

Alle Templates sind zusammengefasst in der Kategorie Template.

Einbindung mittels Transklusion

In den Wiki-Leitfäden werden Templates 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 Template immer in der neuesten Fassung dargestellt wird; das beinhaltet auch, dass die Spezifikationen in Bezug auf transkludierte Templates immer auf dem neuesten Stand sind, aber eben auch, dass sie sich im Prinzip jederzeit ändern können.
  • STATIC, das heißt, dass das Template einer bestimmten Version transkludiert wird; hierzu ist die Angabe der Version in Form des effectiveDate (Format: YYYY-MM-DD) des Templates notwendig. STATIC beinhaltet, dass die Templates einer Spezifikation bei einer bestimmten Version "eingefroren" sind.

Templates 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 Template Beschreibungen, die aktuelle und ältere Versionen sowie Referenzen gezeigt.

Seitenstruktur

Jedes Template hat als Namen der Hauptseite die zugehörige OID. Diese Seiten befinden sich in den Kategorien Template.

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

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

Beispiel:

#REDIRECT [[1.2.276.0.76.10.2004/static-22013-07-17]]

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

Beispiel:

#REDIRECT [[1.2.276.0.76.10.2004]]
[[Kategorie:Template]]

Beispiele

Beispiel DYNAMIC

Transklusion eines Value Sets in der neuesten Version:

{{:1.2.276.0.76.10.2004/dynamic}}
Id1.2.276.0.76.10.2004Gültigkeit gültig ab 2013‑07‑17

Es gibt Versionen von Templates mit dieser Id:
  • HeaderCustodian vom 2013‑07‑17
  • HeaderCustodian vom 2013‑07‑07
StatusKyellow.png EntwurfVersions-Label
NameHeaderCustodianAnzeigenameCDA custodian
BeschreibungVerantwortliche Organisation für ein erstelltes Dokument (die das Dokument verwaltende Organisation). In der Regel ist es die erstellende Institution des Dokumentes.
KlassifikationCDA Header Level Template
Offen/GeschlossenOffen (auch andere als die definierten Elemente sind erlaubt)
ItemDTKardKonfBeschreibungLabel
hl7:custodian
(HeaderCustodian)
Treetree.png@typeCode
0 … 1FCST
 Beispiel<custodian typeCode="CST">
  <assignedCustodian classCode="ASSIGNED">
    <representedCustodianOrganization classCode="ORG" determinerCode="INSTANCE">
      <!-- ... -->
    </representedCustodianOrganization>
  </assignedCustodian>
</custodian>
Treetree.pnghl7:assignedCustodian
1 … 1M(HeaderCustodian)
Treeblank.pngTreetree.png@classCode
0 … 1FASSIGNED
Treeblank.pngTreetree.pnghl7:represented​Custodian​Organization
1 … 1M(HeaderCustodian)
Treeblank.pngTreeblank.pngTreetree.png@classCode
0 … 1FORG
Treeblank.pngTreeblank.pngTreetree.png@determiner​Code
0 … 1FINSTANCE
Treeblank.pngTreeblank.pngTreetree.pnghl7:id
II1 … 1(HeaderCustodian)
Treeblank.pngTreeblank.pngTreetree.pnghl7:name
ON1 … 1M(HeaderCustodian)
Treeblank.pngTreeblank.pngTreetree.pnghl7:telecom
TEL0 … *(HeaderCustodian)
Treeblank.pngTreeblank.pngTreetree.pnghl7:addr
AD0 … 1(HeaderCustodian)

Beispiel STATIC

Transklusion eines Templates in der Version vom 2012-07-24:

{{:1.2.276.0.76.10.2004/static-2013-07-17}}
Id1.2.276.0.76.10.2004Gültigkeit gültig ab 2013‑07‑17

Es gibt Versionen von Templates mit dieser Id:
  • HeaderCustodian vom 2013‑07‑17
  • HeaderCustodian vom 2013‑07‑07
StatusKyellow.png EntwurfVersions-Label
NameHeaderCustodianAnzeigenameCDA custodian
BeschreibungVerantwortliche Organisation für ein erstelltes Dokument (die das Dokument verwaltende Organisation). In der Regel ist es die erstellende Institution des Dokumentes.
KlassifikationCDA Header Level Template
Offen/GeschlossenOffen (auch andere als die definierten Elemente sind erlaubt)
ItemDTKardKonfBeschreibungLabel
hl7:custodian
(HeaderCustodian)
Treetree.png@typeCode
0 … 1FCST
 Beispiel<custodian typeCode="CST">
  <assignedCustodian classCode="ASSIGNED">
    <representedCustodianOrganization classCode="ORG" determinerCode="INSTANCE">
      <!-- ... -->
    </representedCustodianOrganization>
  </assignedCustodian>
</custodian>
Treetree.pnghl7:assignedCustodian
1 … 1M(HeaderCustodian)
Treeblank.pngTreetree.png@classCode
0 … 1FASSIGNED
Treeblank.pngTreetree.pnghl7:represented​Custodian​Organization
1 … 1M(HeaderCustodian)
Treeblank.pngTreeblank.pngTreetree.png@classCode
0 … 1FORG
Treeblank.pngTreeblank.pngTreetree.png@determiner​Code
0 … 1FINSTANCE
Treeblank.pngTreeblank.pngTreetree.pnghl7:id
II1 … 1(HeaderCustodian)
Treeblank.pngTreeblank.pngTreetree.pnghl7:name
ON1 … 1M(HeaderCustodian)
Treeblank.pngTreeblank.pngTreetree.pnghl7:telecom
TEL0 … *(HeaderCustodian)
Treeblank.pngTreeblank.pngTreetree.pnghl7:addr
AD0 … 1(HeaderCustodian)

Beispiele vollständiger Wikiseiten

Ein Beispiel einer vollständigen Wikiseite mit einem Template inklusive aller Versionen ist 1.2.276.0.76.10.2004

TermBot

Arbeitsweise

Die Templates (auch Terminologien) werden automatisch als Auszug aus einem Template-Repository mittels eines Bots (TermBot) gezogen. Das Vorgehen ist dabei, dass alle Dateien, die sich in der Kategorie "Template" befinden, automatisch vom Bot geupdatet werden.

Hinweise

Auf den Template-Seiten finden sich folgende Hinweise: