Änderungen

Wechseln zu: Navigation, Suche

Hilfe:Art-Decor-Tabellen verstehen

3.317 Bytes entfernt, 13:59, 14. Jul. 2020
Details von der Tabellenansicht
{{#customtitle:Art-Decor - Wichtige Hinweise}}
{{#css:
.toc{
width: 20%;
float: right !important;
margin: 10px 0px 10px 30px !important;
border: 1px solid #AAA;
background-color: #F9F9F9;
display: table;
padding: 7px !important;
}
}}
<!--
{{Infobox Dokument
|Title = Art-Decor
|Short = Art-Decor
|Version = 0.1
|Date = 07.11.2019
|Copyright = 2019 - 2022
|Status = Draft
|Period = 07.11.2019
|OID = TODO
|Realm = Österreich
|Submitted = 07.11.2019}}
-->
{{#seo:
|title=Art-Decor
|titlemode=append
|keywords=Art-Decor, Tabellen, Grundlagen, Prozess
|description= Hier finden Sie eine Erklärung zu den Art-Decor Tabellen und deren Aufbau.
}}
 
=Art-Decor-Tabellen verstehen=
<div style="border: thin #C9302C solid;width:100%; margin-left: 10px">
<div style="width:100%;">
<p style="padding-left:10px; padding-top: 10 px>
Die Template Definitionen werden in einer Tabellenansicht angezeigt. <br/>Diese besteht aus Template Meta Daten und dem Template Design. <br/> Weitere Informationen finden Sie im HL7 Template-Austauschformat-Standard "Specification and Use of Reusable Information Constraint Templates, Release 1"<ref> HL7 Templates Standard: Specification and Use of Reusable Information Constraint Templates, Release 1 [http://www.hl7.org/implement/standards/product_brief.cfm?product_id=377] < /ref name=> und auf der "teitsHow-To-Read"-Seite von Art-Decor<ref>How to read ART-DECOR Definitions https://>art-decor.<brorg/mediawiki/>index.php?title=How_to_read_ART-DECOR_Definitions<br/ref>. <b>==Template Meta Daten</b><br/><br/>==
<imagemap>
Datei:art-decor-1.png|800px|Art-Decor
#Anklickbare Zahlen
rect 350 50 450 150 [[#Template Meta Daten|1 Template-ID, Status und Template-Name]]rect 550 50 650 150 [[#Template Meta Daten|2 Versionsnummer ("effectiveDate"), Versionslabel und Anzeigename]]rect 700 150 800 250 [[#Template Meta Daten|3 Beschreibung des Templates]]rect 400 250 500 350 [[#Template Meta Daten|4 Offen oder geschlossenes Template]]rect 580 320 680 420 [[#Template Meta Daten|5 Andere Templates, die dieses Template verwenden oder von diesem Template verwendet werden]]rect 700 400 800 475 [[#Template Meta Daten|6 Beziehungen zu anderen Templates]]rect 700 480 800 550 [[#Template Meta Daten|7 XML-Fragment als Beispiel]]
</imagemap>
  <br/><br/>Der obere rechte Teil der Template-Tabelle enthält die Template-Metadaten. Hier werden Template-ID, Status und der Template-Name angezeigt(1). Weiters werden die Version (effective date), ein mögliches Versionslabel und der Anzeigename dargestellt(2).
<br/>
Die Beschreibung (einfach oder ein Akkordeon) enthält die Template-Beschreibungen/Zweck(3), gefolgt von der Klassifikationen und ob das Template als offen oder geschlossen definiert ist(4).
<br/>
Beispiele zeigen die korrekte Verwendung der Templates durch ein XML-Fragment (7).
<br/><br/>
<imagemap>
Datei:Ref_template_artdecor.png|800px|Art-Decor
#Anklickbare Zahlen
rect 500 10 650 75 [[#Template Meta Daten|8 referenziertes Template]]
</imagemap>
Ein referenziertes Template ist erkennbar durch ein grau hinterlegtes "ref", gefolgt mit einen bunt hinterlegten Namen der verwendeten Quelle (8).
<br/><br/>
[[Datei:art-decor-2.png]]
<br/><br/>
[[Datei:art-decor-3.png]]
<br/><br/><b>==Tabellenansicht vom Template Design</b><br/><br/>==
[[Datei:art-decor-4.png]]
<br/><br/>
* '''Description (4)''' enthält eine Textbeschreibung des Elements und kann auch Einschränkungen und Werte für feste Attribute enthalten.
* '''Label (5)''' ist ein menschlich lesbares Label, das bei Fehlern, Warnungen oder Notizen während der Validierung angezeigt wird.
<br/><b>==Details von der Tabellenansicht</b><br/><br/>==
[[Datei:art-decor-5.png]]
<br/><br/>Das eigentliche Template-Design zeigt die XML-Struktur in einer hierarchischen Liste von Elementen (Items), die typischerweise einen Namespace "hl7:" oder "cda:" (1) vorangestellt haben.Diese im Art-Decor angegebenen Namespaces werden nicht in den letztendlichen eHealth-Austria Dokumenten genutzt! Das HL7-International-Namespace, welches im Art-Decor unter "hl7:" oder "cda:" geführt wird, ist in den eHealth-Austria Dokumenten als Standard-Namespace für alle eHealth-Austria-Dokumente geführt: "<br/ClinicalDocument '''xmlns="urn:hl7-org:v3"''' ... >" 
Elemente werden mit einem Dreieck bezeichnet, Attribute mit einem @ -Zeichen (2).
<br/>
Datentypen werden nach der Liste der unterstützten Datentypen (3) angegeben. Es können einfache Datentypen (Kleinbuchstaben), reguläre Datentypen (Großbuchstaben) oder flavors sein.
<br/>
Die Kardinalitäts- und Konformitätsspalte ist oben (4) erläutert.
<br/>
Feste Werte für z.B. Attribute werden auch in der Spalte "Beschreibung" (5) angezeigt, denen ein "F" in der Spalte Conf folgt.
<br/>
Konformitätserklärungen werden zusammen mit einer CONF-Box gezeigt, z.B. ein @code und ein @codeSystem mit festen und erforderlichen Werten (6).
<br/>
Ein optionales Label wird in der rechten Spalte (7) angezeigt.
<br/>
Einbeziehung oder Eingrenzung von anderen Templates, z.B. ein Eintrag innerhalb eines Abschnitts, werden entsprechend (8) zusammen mit ihrer Template-ID, dem Anzeigenamen und der Flexibilität/Stabilitätsanzeige angezeigt, d.h. "DYNAMIC" (die neueste Version) oder STATIC zusammen mit dem Versionsdatum.
<br/><br/>
[[Datei:art-decor-6.png]]
<br/><br/>
Die Auswahl von Elementen wird als Auswahlliste mit den Elementen in Fragen dargestellt, die in einer Aufzählungsliste zusammengefasst sind.
<br/><br/>
[[Datei:art-decor-7.png]]
<br/><br/>
Eine typische Konformitätserklärung ist die Bindung eines codierten Elements an einen Wert. Dies wird in der dargestellten Weise ausgedrückt. Der Wert wird mit der ID, dem Anzeigenamen und der Flexibilität/Stabilität der Bindung dargestellt.
<br/><br/>
[[Datei:art-decor-8.png]]
<br/><br/>
Wenn eine Einschränkung in Worten ausgedrückt wird, begleitet eine Box "Constraint" den Textausdruck der Einschränkung.
<br/><br/>
[[Datei:art-decor-9.png]]
<br/><br/>
In Fällen, in denen Einschränkungen durch formalisierte Regeln in ISO Schematron ausgedrückt werden, wird die Regel zusammen mit der Rolle (Fehler, Warnung), der Test und die Assertionsmeldung angezeigt.
</p>
</div>
</div>
=Prozess der CDA-Leitfadenerstellung in Art-Decor=
Folgende Vorgehensweise wird bei der Erstellung von Leitfadenerstellung als Best Practice empfohlen.
==Neues Projektverzeichnis erstellen==
Ein neuer CDA-Leitfaden soll in einem eigenen Projektverzeichnis angelegt werden. Dies muss gegebenenfalls beim Support beantragt werden.
 
==Datasets in Art-Decor modellieren==
Die Modellierung der Datasets muss in enger Abstimmung mit Experten der Arbeitsgruppe erfolgen, bereits unter Einbeziehung potentiell zu verwendender Standards (IHE Profile).
 
==Szenarios festlegen==
*Für jede Dokument-Ausprägung eine Transaktion erstellen (Kürzel + Name des Szenarios)
*Die Transaktion dient nur der Erstellung der Schematronregeln (kein direkter Zusammenhang mit ILF)
 
==Referenzen auf andere Projektverzeichnisse setzen==
*Damit deren Templates referenziert werden können (Empfehlung: ATCDABBR, IHE-PCC- hinzufügen)
*Keine unnötigen Referenzen angeben! (Beim späteren Entfernen kann es zu Fehlern kommen)
==Document Level Template erstellen==
*Für jedes Szenario (jede Dokumentart) ein Document Level Template (DLT) erstellen (nach Vorgaben der Governance)
Anmerkung: Solange DLT noch nicht in Szenario verlinkt ist, wird das Label als oranges Dreieck mit Pfeilen angezeigt, sonst als oranges Viereck/Buch.
*Anschließend OID ändern (mittels GUI: „Template bearbeiten“ und mit „#“ (ID-Management) OID ändern (nach Vorgaben der Governance). Der Name eines Templates kann später nur mittels „Temple“ geändert werden! Die Änderung hat des Namens hat keinen Einfluss auf die Referenzierung von anderen Templates -> hier gilt die OID). Wird die OID geändert, wenn das Template bereits durch andere Templates refereziert wird, werden alle bestehenden Referenzen ungültig! Daher vor der Änderung der OID alle referenzierenden Templates kopieren und diese mit der neuen OID anpassen.
*Kopieren der Inhalte des DLT eines ähnlichen Leitfadens (XML via Temple), einfügen in das neue DTL. Obere Zeilen bleiben erhalten (Zeitpunkt (effectiveDate) und OID dürfen nicht verändert werden), alle weiteren Inhalte entsprechend anpassen.
*Alle „Included Templates“ aus DTL-Header mit Kettensymbol zum Projekt hinzufügen (zwecks Vollständigkeit – Schematron benötigt dies nicht, hier reicht „include“ im xml und Referenzierung des Projektes.
==Alle weiteren Templates erstellen==
Bevor ein neues Template erstellt wird, müssen alle Templates über die Governance Seite aufgelistet, deren Wiederverwendbarkeit geprüft werden bzw. welche OID als nächstes vergeben werden muss. Wenn möglich, aus vorhandenen Templates ableiten! („+“-Symbol in der Templateansicht im Projektverzeichnis).
Ein neues Basistemplate muss im ATCDABBR angelegt werden und soll so allgemein definiert sein, dass es für andere Leitfäden verwendbar ist (ohne Value Sets, ohne projektspezifischen Angaben!)*. Alle Projekte sollen von dort ableiten (genauer spezifizieren, Value Sets angeben usw.). z.B. Section-Template im ATCDABBR: „Durchgemachte Krankheiten“ abgeleitet in Section-Template „Impfrelevante Erkrankungen - kodiert“ im e-Impfpass.
TemplateIDs müssen mit IHE-Vorgaben übereinstimmen
Optionalitäten und Reihenfolge der Elemente einhalten
*bei fehlender Berechtigung können Basistemplates im Projektverzeichnis erstellt werden und später durch berechtigte Personen in das ATCDABBR verschoben werden.
==Sektionen entsprechend dem IHE Profil modellieren==
(siehe TODO)
==Schematron erstellen==
(TODO)
 
==Fehlerbehebung==
==Asserts erstellen==
(TODO)
 
==Beispielbefunde erstellen und testen==
 
=Versionierung von Templates=
585
Bearbeitungen

Navigationsmenü