Quelltext der Seite Hilfe:Template-Architektur

{{Underconstruction}}

== Architektur der Wiki-Seiten ==

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="5"
!style="background-color:#e6e6e6;"|Lvl
!style="background-color:#e6e6e6;"|Bezeichnung 
!style="background-color:#e6e6e6;"|„CDA Name“
|-
|
|Patient
|recordTarget
|-
|
|Author
|Author
|-
|
|Unterzeichner
|legalAuthenticator
|-
|
|Informant
|Informant
|-
|
|Teilnehmer
|participant
|-
|
|Aufenthalt
|encounter
|-
|
|...
|
|}

Andere Informationen sind wesentlich einfacherer Natur und können in der Hauptseite selber untergebracht werden.

{| cellspacing="5"
!style="background-color:#e6e6e6;"|Lvl
!style="background-color:#e6e6e6;"|Bezeichnung 
|-
|0
|Document Type
|-
|0
|Document Template
|-
|0
|Document ID
|-
|0
|...
|}

=== Zusammenbindung der Teile des Dokumenten-Headers (Artefakte) ===

Die Artefakte im Header müssen zusammengestellt werden, um bspw. Konformanzaspekte zu berücksichtigen. Dies sollte nach folgendem Schema passieren.

{| cellspacing="5"
!style="background-color:#e6e6e6;"|Artefakt
!style="background-color:#e6e6e6;"|Bezeichnung
!style="background-color:#e6e6e6;"|Kardinalität
|}

Diese Aufstellung hat am Beginn der Header-Spezifikation zu erfolgen.