Hilfe:Template-Architektur: Unterschied zwischen den Versionen

Aus Hl7wiki
Wechseln zu: Navigation, Suche
(Die Seite wurde neu angelegt: „=Template-Architektur= Hier müsste die Beschreibung hin, wie die Seiten für Implementierungsleitfäden strukturiert sind....“)
 
Zeile 1: Zeile 1:
=Template-Architektur=
+
== Architektur der Wiki-Seiten ==
  
Hier müsste die Beschreibung hin, wie die Seiten für Implementierungsleitfäden strukturiert sind....
+
Nachfolgend eine kleine Grafik, die die Gesamtstruktur und damit die Verteilung der einzelnen Informationen über die einzelnen Seiten erläutert.
 +
 
 +
[[Datei:cdaab_gesamtstruktur.jpg|Gesamtstruktur|480px]]
 +
 
 +
;Legende:
 +
:Durchgezogene Kästchen = Wikiseiten
 +
:Gestrichelte Kästchen = Kategorien
 +
:Buchstaben in Kreisen = Kategorien, über die die Kategoriehauptseiten aufgebaut werden
 +
:Farben = verschiedene Namensräume
 +
 
 +
Im einfachsten Fall wird ein Implementierungsleitfaden durch eine einzige Seite dargestellt, auf die von der Hauptseite verwiesen wird. Dann kann man denselben Namensraum („IG“) verwenden.
 +
Wenn ein Leitfaden aber über verschiedene Seiten aufgeteilt werden soll – an der Stelle ist die weitere Struktur erstmal egal – dann bietet sich die Nutzung eines eigenen Namensraumes an. Damit können alle weiteren Seiten frei von einer weiteren Regelung erstellt werden.
 +
 
 +
Zur weiteren Aufteilung über verschiedene Seiten sollte aber eine Struktur erkennbar sein, die sich u.a. auch nach den Erfordernissen von CDA richtet. Also bspw. Sektionen und Entries darstellen.
 +
Hier bietet sich an, ebenfalls jeweils eine eigene Wiki-Seite einzurichten, auf die dann verlinkt wird.
 +
 
 +
=== Diskussionspunkte ===
 +
 
 +
* Es muss zwischen Seiten unterschieden werden, die für den Leitfaden gebraucht werden, und den Seiten für die CDA-„Einzelteile“.
 +
* Grundsätzlich lassen sich die Seiten jeweils über Namensräume trennen. Dann müsste die Namenskonvention darüber erfolgen. Dann bekäme jeder Implementierungsleitfaden seinen eigenen Namensraum – zumindest für die zu einem Leitfaden gehörenden Abschnitte wäre das eine Lösung. Dies ist bereits so für den Mutterpass eingerichtet worden.
 +
* Kategorisierung: Wie sollen die Seiten kategorisiert werden, damit eine automatische Aufzählung erfolgen kann?<br/>Optimal wäre eine inhaltliche Zuordnung, so dass die Seiten aus den Namensräumen dann gruppiert und automatisch aufgelistet werden können.
 +
 
 +
=== Namenskonvention für die Wikiseite ===
 +
 
 +
{| class="wikitable"
 +
!Seite
 +
!Kommentar
 +
|-
 +
|Implementierungsleitfäden
 +
|Startseite (über alles); Von hier aus werden die Implementierungsleitfäden verlinkt
 +
|-
 +
|IG:<LEITFADEN>
 +
|Alle Implementierungsleitfäden werden im Hauptnamensraum („IG“) erstellt.
 +
|-
 +
|<NAMESPACE>:<SEITE>
 +
|Die verlinkten Teile eines Implementierungsleitfadens werden in jeweils einem eigenem Namensraum erstellt; <br/> für die Seiten existieren keine dedizierten Vorgaben (so kann in jedem Namensraum eine Seite „Einleitung“ erstellt werden) <br/> Damit kann jede Gruppe frei arbeiten.
 +
|-
 +
|IG:CDA_Doc_Types
 +
|Übersicht Dokumenttypen; <br/> wird über Kategorie erstellt; <br/> alternativ über Referenzen bzw. Hyperlings (bei letzteren können noch Zusatzinformationen wie bspw. eine Hierarchbildung <br/> (s.u.) abgebildet werden)
 +
|-
 +
|IG:CDA_Sections
 +
|Übersicht über alle Sektionen; Einbindung über Kategorien
 +
|-
 +
|IG:CDA_Entries
 +
|Übersicht über alle Entries; Einbindung über Kategorien
 +
|-
 +
|V3dtr1
 +
|Gesamtseite Datentypen
 +
|-
 +
|V3dtr1:<NAME>
 +
|Abschnitte der Gesamtspezifikation bzw. spezieller Datentyp
 +
|-
 +
|IG:CDA_HL7_Mutterpass
 +
|Bereits existierender Satz von Seiten
 +
|-
 +
|IG:Übermittlung_melde- <br/> pflichtiger_Krankheiten
 +
|Bereits existierende Seite
 +
|}
 +
 
 +
=== Kategorien ===
 +
 
 +
{| class="wikitable"
 +
!Beschreibung
 +
!Kategorie
 +
|-
 +
|Implementierungsleitfaden <br/> (kann auch über eigenen Namensraum erfolgen)
 +
|align="right"|A
 +
|-
 +
|Dokumenttypen
 +
|align="right"|Documenttype 0
 +
|-
 +
|Abschnitt/Sektion (Template)
 +
|align="right"|Section B
 +
|-
 +
|Artefakt
 +
|align="right"|Artefakt C
 +
|-
 +
|Entry (Template)
 +
|align="right"|Entry D
 +
|}
 +
 
 +
=== Zuständigkeiten ===
 +
 
 +
Es gibt eine Reihe von Initiativen, die eigene Dokumenttypen spezifizieren wollen. Diesen muss ein Namensraum zugewiesen werden, damit diese frei arbeiten können. Nachfolgend eine anfängliche Liste:
 +
 
 +
{| class="wikitable"
 +
!IG-NAME
 +
!Namespace
 +
!Zuständig
 +
|-
 +
|Arztbrief 1.x
 +
|cdaab1
 +
|Heitmann
 +
|-
 +
|Arztbrief 2.0
 +
|cdaab2
 +
|Heitmann, Oemig
 +
|-
 +
|Mutterpass
 +
|cdaemp
 +
|Hellmuth
 +
|-
 +
|Übermittlung meldepflichtiger <br/> Krankheiten (Meldepflichtige <br/> Infektions-Krankheiten)
 +
|cdamik
 +
|Treinat
 +
|-
 +
|Trainingsplan
 +
|cdatp
 +
|Houta
 +
|-
 +
|CDA für die elektronische <br/> Fallakte (nur Sektionen)
 +
|cdaefa
 +
|Caumanns
 +
|-
 +
|Pathologiebefund
 +
|cdapath
 +
|Haroske, Schrader
 +
|-
 +
|Übermittlung onkologischer <br/> Daten (onkolog. Versorgung) <br/> (Meldungen an Krebsregister)
 +
|cdaonk
 +
|Altmann, Schütze, <br/> Lang, Ketterer
 +
|-
 +
|
 +
|IG
 +
|
 +
|}
 +
 
 +
=== Notwendige Korrekturen ===
 +
 
 +
Gemäß der vorhergehenden Aufstellung müssen einige Wiki-Seiten um-benannt sowie umstrukturiert werden:
 +
 
 +
{| class="wikitable"
 +
!URL (alt)
 +
!Namensraum
 +
!Kommentar
 +
|-
 +
|IG:Übermittlung_melde- <br/> pflichtiger_Krankheiten
 +
|cdaonko
 +
|Auf eigenen Namespace umheben, <br/> wenn der Implementierungsleitfaden <br/> über mehrere Seiten aufgeteilt werden sollte
 +
|}
 +
 
 +
== Konkrete Strukturelemente ==
 +
 
 +
=== Abschnitte des Dokumenten-Headers (Artefakte) ===
 +
 
 +
Diese werden auf eigenen Seiten erstellt, die beliebig innerhalb des eigenen Namensraumes benannt werden können. Seiten aus anderen Namensräumen können referenziert werden.
 +
 
 +
Nachfolgende Elemente repräsentieren eine Substruktur und sollten deshalb in eigene Seiten ausgelagert werden:
 +
 
 +
{| cellspacing="10"
 +
!Lvl
 +
!Bezeichnung
 +
!„CDA Name“
 +
|-
 +
|
 +
|Patient
 +
|recordTarget
 +
|}
 +
 
 +
<br/>
 +
Ergänzungen folgen im Laufe der nächsten Tage.

Version vom 11. September 2013, 13:53 Uhr

Architektur der Wiki-Seiten

Nachfolgend eine kleine Grafik, die die Gesamtstruktur und damit die Verteilung der einzelnen Informationen über die einzelnen Seiten erläutert.

Gesamtstruktur

Legende
Durchgezogene Kästchen = Wikiseiten
Gestrichelte Kästchen = Kategorien
Buchstaben in Kreisen = Kategorien, über die die Kategoriehauptseiten aufgebaut werden
Farben = verschiedene Namensräume

Im einfachsten Fall wird ein Implementierungsleitfaden durch eine einzige Seite dargestellt, auf die von der Hauptseite verwiesen wird. Dann kann man denselben Namensraum („IG“) verwenden. Wenn ein Leitfaden aber über verschiedene Seiten aufgeteilt werden soll – an der Stelle ist die weitere Struktur erstmal egal – dann bietet sich die Nutzung eines eigenen Namensraumes an. Damit können alle weiteren Seiten frei von einer weiteren Regelung erstellt werden.

Zur weiteren Aufteilung über verschiedene Seiten sollte aber eine Struktur erkennbar sein, die sich u.a. auch nach den Erfordernissen von CDA richtet. Also bspw. Sektionen und Entries darstellen. Hier bietet sich an, ebenfalls jeweils eine eigene Wiki-Seite einzurichten, auf die dann verlinkt wird.

Diskussionspunkte

  • Es muss zwischen Seiten unterschieden werden, die für den Leitfaden gebraucht werden, und den Seiten für die CDA-„Einzelteile“.
  • Grundsätzlich lassen sich die Seiten jeweils über Namensräume trennen. Dann müsste die Namenskonvention darüber erfolgen. Dann bekäme jeder Implementierungsleitfaden seinen eigenen Namensraum – zumindest für die zu einem Leitfaden gehörenden Abschnitte wäre das eine Lösung. Dies ist bereits so für den Mutterpass eingerichtet worden.
  • Kategorisierung: Wie sollen die Seiten kategorisiert werden, damit eine automatische Aufzählung erfolgen kann?
    Optimal wäre eine inhaltliche Zuordnung, so dass die Seiten aus den Namensräumen dann gruppiert und automatisch aufgelistet werden können.

Namenskonvention für die Wikiseite

Seite Kommentar
Implementierungsleitfäden Startseite (über alles); Von hier aus werden die Implementierungsleitfäden verlinkt
IG:<LEITFADEN> Alle Implementierungsleitfäden werden im Hauptnamensraum („IG“) erstellt.
<NAMESPACE>:<SEITE> Die verlinkten Teile eines Implementierungsleitfadens werden in jeweils einem eigenem Namensraum erstellt;
für die Seiten existieren keine dedizierten Vorgaben (so kann in jedem Namensraum eine Seite „Einleitung“ erstellt werden)
Damit kann jede Gruppe frei arbeiten.
IG:CDA_Doc_Types Übersicht Dokumenttypen;
wird über Kategorie erstellt;
alternativ über Referenzen bzw. Hyperlings (bei letzteren können noch Zusatzinformationen wie bspw. eine Hierarchbildung
(s.u.) abgebildet werden)
IG:CDA_Sections Übersicht über alle Sektionen; Einbindung über Kategorien
IG:CDA_Entries Übersicht über alle Entries; Einbindung über Kategorien
V3dtr1 Gesamtseite Datentypen
V3dtr1:<NAME> Abschnitte der Gesamtspezifikation bzw. spezieller Datentyp
IG:CDA_HL7_Mutterpass Bereits existierender Satz von Seiten
IG:Übermittlung_melde-
pflichtiger_Krankheiten
Bereits existierende Seite

Kategorien

Beschreibung Kategorie
Implementierungsleitfaden
(kann auch über eigenen Namensraum erfolgen)
A
Dokumenttypen Documenttype 0
Abschnitt/Sektion (Template) Section B
Artefakt Artefakt C
Entry (Template) Entry D

Zuständigkeiten

Es gibt eine Reihe von Initiativen, die eigene Dokumenttypen spezifizieren wollen. Diesen muss ein Namensraum zugewiesen werden, damit diese frei arbeiten können. Nachfolgend eine anfängliche Liste:

IG-NAME Namespace Zuständig
Arztbrief 1.x cdaab1 Heitmann
Arztbrief 2.0 cdaab2 Heitmann, Oemig
Mutterpass cdaemp Hellmuth
Übermittlung meldepflichtiger
Krankheiten (Meldepflichtige
Infektions-Krankheiten)
cdamik Treinat
Trainingsplan cdatp Houta
CDA für die elektronische
Fallakte (nur Sektionen)
cdaefa Caumanns
Pathologiebefund cdapath Haroske, Schrader
Übermittlung onkologischer
Daten (onkolog. Versorgung)
(Meldungen an Krebsregister)
cdaonk Altmann, Schütze,
Lang, Ketterer
IG

Notwendige Korrekturen

Gemäß der vorhergehenden Aufstellung müssen einige Wiki-Seiten um-benannt sowie umstrukturiert werden:

URL (alt) Namensraum Kommentar
IG:Übermittlung_melde-
pflichtiger_Krankheiten
cdaonko Auf eigenen Namespace umheben,
wenn der Implementierungsleitfaden
über mehrere Seiten aufgeteilt werden sollte

Konkrete Strukturelemente

Abschnitte des Dokumenten-Headers (Artefakte)

Diese werden auf eigenen Seiten erstellt, die beliebig innerhalb des eigenen Namensraumes benannt werden können. Seiten aus anderen Namensräumen können referenziert werden.

Nachfolgende Elemente repräsentieren eine Substruktur und sollten deshalb in eigene Seiten ausgelagert werden:

Lvl Bezeichnung „CDA Name“
Patient recordTarget


Ergänzungen folgen im Laufe der nächsten Tage.