Hilfe:Art-Decor-Tabellen verstehen: Unterschied zwischen den Versionen

Aus HL7 Austria MediaWiki
Wechseln zu: Navigation, Suche
[unmarkierte Version][unmarkierte Version]
Zeile 37: Zeile 37:
 
#Anklickbare Zahlen
 
#Anklickbare Zahlen
 
rect  350 50  450 150  [[#Anker:1 Template-ID, Status und Template-Name]]
 
rect  350 50  450 150  [[#Anker:1 Template-ID, Status und Template-Name]]
rect  550 50  650 150  [[2 Versionsnummer ("effectiveDate"), Versionslabel und Anzeigename]]
+
rect  550 50  650 150  [[#Anker:2 Versionsnummer ("effectiveDate"), Versionslabel und Anzeigename]]
rect  700 150  800 250  [[3 Beschreibung des Templates]]
+
rect  700 150  800 250  [[#Anker:3 Beschreibung des Templates]]
rect  400 250  500 350  [[4 Offen oder geschlossenes Template]]
+
rect  400 250  500 350  [[#Anker:4 Offen oder geschlossenes Template]]
rect  580 320  680 420  [[5 Andere Templates, die dieses Template verwenden oder von diesem Template verwendet werden]]
+
rect  580 320  680 420  [[#Anker:5 Andere Templates, die dieses Template verwenden oder von diesem Template verwendet werden]]
rect  700 400  800 475  [[6 Beziehungen zu anderen Templates]]
+
rect  700 400  800 475  [[#Anker:6 Beziehungen zu anderen Templates]]
rect  700 480  800 550  [[7 XML-Fragment als Beispiel]]
+
rect  700 480  800 550  [[#Anker:7 XML-Fragment als Beispiel]]
 
</imagemap>
 
</imagemap>
 
Der obere rechte Teil der Template-Tabelle enthält die Template-Metadaten. Hier werden Template-ID, Status und der Template-Name angezeigt(1).{{Anker|1 Template-ID, Status und Template-Name}}  
 
Der obere rechte Teil der Template-Tabelle enthält die Template-Metadaten. Hier werden Template-ID, Status und der Template-Name angezeigt(1).{{Anker|1 Template-ID, Status und Template-Name}}  
Weiters werden die Version (effective date), ein mögliches Versionslabel und der Anzeigename dargestellt(2).
+
Weiters werden die Version (effective date), ein mögliches Versionslabel und der Anzeigename dargestellt(2).{{Anker|2 Versionsnummer ("effectiveDate"), Versionslabel und Anzeigename}}
 
<br/>
 
<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).
+
Die Beschreibung (einfach oder ein Akkordeon) enthält die Template-Beschreibungen/Zweck(3){{Anker|3 Beschreibung des Templates}}, gefolgt von der Klassifikationen und ob das Template als offen oder geschlossen definiert ist(4){{Anker|4 Offen oder geschlossenes Template}}.
 
<br/>
 
<br/>
Der Verwendungsteil (5) listet Templates auf, die dieses Template verwenden oder welche Templates in diesem Template inkludiert sind. <br/>
+
Der Verwendungsteil (5) listet Templates auf, die dieses Template verwenden oder welche Templates in diesem Template inkludiert sind. {{Anker|5 Andere Templates, die dieses Template verwenden oder von diesem Template verwendet werden}} <br/>
Die Beziehungsliste (6) enthält alle Beziehungen zu anderen Templates oder Modellen.
+
Die Beziehungsliste (6) enthält alle Beziehungen zu anderen Templates oder Modellen. {{Anker|6 Beziehungen zu anderen Templates}}
 
<br/>
 
<br/>
Beispiele zeigen die korrekte Verwendung der Templates durch ein XML-Fragment (7).
+
Beispiele zeigen die korrekte Verwendung der Templates durch ein XML-Fragment (7). {{Anker|7 XML-Fragment als Beispiel}}
 
<br/><br/>
 
<br/><br/>
[[Datei:Ref_template_artdecor.png|800px]]
+
<imagemap>
 +
Datei:Ref_template_artdecor.png|800px|Art-Decor
 +
#Anklickbare Zahlen
 +
rect  500 10  650 75    [[#Anker:8 referenziertes Template]]
 +
</imagemap>
 
<br/><br/>
 
<br/><br/>
Ein referenziertes Template ist erkennbar durch ein grau hinterlegtes "ref", gefolgt mit einen bunt hinterlegten Namen der verwendeten Quelle (8).
+
Ein referenziertes Template ist erkennbar durch ein grau hinterlegtes "ref", gefolgt mit einen bunt hinterlegten Namen der verwendeten Quelle (8). {{Anker|8 referenziertes Template}}
 
<br/><br/>
 
<br/><br/>
 
[[Datei:art-decor-2.png]]
 
[[Datei:art-decor-2.png]]

Version vom 17. Juni 2020, 09:09 Uhr

Wichtiger Hinweis: Informationen zur Erstellung von CDA-Leitfäden finden Sie in unserer Wissensbasis unter Prozess der CDA-Leitfadenerstellung in Art-Decor.

Art-Decor-Tabellen verstehen

Anleitung: Lesen der Tabellenansicht von Templates

Die Template Definitionen werden in einer Tabellenansicht angezeigt.
Diese besteht aus Template Meta Daten und dem Template Design.
Weitere Informationen finden Sie im HL7 Template-Austauschformat-Standard "Specification and Use of Reusable Information Constraint Templates, Release 1"[1] und auf der "How-To-Read"-Seite von Art-Decor[2].

Template Meta Daten

#Anker:1 Template-ID, Status und Template-Name#Anker:2 Versionsnummer ("effectiveDate"), Versionslabel und Anzeigename#Anker:3 Beschreibung des Templates#Anker:4 Offen oder geschlossenes Template#Anker:5 Andere Templates, die dieses Template verwenden oder von diesem Template verwendet werden#Anker:6 Beziehungen zu anderen Templates#Anker:7 XML-Fragment als BeispielArt-Decor
Über dieses Bild

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).
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).
Der Verwendungsteil (5) listet Templates auf, die dieses Template verwenden oder welche Templates in diesem Template inkludiert sind.
Die Beziehungsliste (6) enthält alle Beziehungen zu anderen Templates oder Modellen.
Beispiele zeigen die korrekte Verwendung der Templates durch ein XML-Fragment (7).

#Anker:8 referenziertes TemplateArt-Decor
Über dieses Bild



Ein referenziertes Template ist erkennbar durch ein grau hinterlegtes "ref", gefolgt mit einen bunt hinterlegten Namen der verwendeten Quelle (8).

Art-decor-2.png

Die Beziehungsliste zeigt alle Beziehungen zu anderen Templates oder Modellen für dieses Template auf. Diese Liste ist aufgeteilt in einen "Used By" Abschnitt, welcher eine Auflistung der Templates wiedergibt, die von diesem Template Gebrauch machen, und in einen "Used" Abschnitt, der alle Templates beinhaltet, die in diesem Template eingebunden sind (entweder einbezogen oder eingegrenzt). Indirekte Beziehungen, wie das übergeordnete Document Level Template für eine Section Level Template, sind mit einem Kettensymbol gekennzeichnet.
PDF-Versionen werden auf die gleiche Weise eingebunden, beinhalten aber eventuell andere Schriftarten etc., um konforme Publikationsanforderungen zu erfüllen.

Art-decor-3.png

Tabellenansicht vom Template Design

Art-decor-4.png

Die Überschriften der Tabellenansicht eines Template Designs sind:

  • Item (1) enthält die XML-Dokumentbaumansicht aller im Template-Design angegebenen Elemente und Attribute. Elemente werden durch ein vorangestelltes Dreieck gekennzeichnet und Attribute durch ein vorangestelltes "@".
  • DT (2) enthält den Datentyp des Elements.
  • Card / Conf (3) Kardinalität (Card) und Konformität (Conf) des Artikels.

Kardinalität gibt die min und max Anzahl der Vorkommen des Elements an. Attribute der Kardinalität 0..1 werden als optional bezeichnet, die Kardinalität 1..1 sagt aus, dass das Attribut erforderlich ist und NP sind verbotene Attribute. Die Konformität kann Werte, wie in der folgenden Tabelle gezeigt, enthalten.

Values of the conformance column
Conf Short Description
O optional Daten sind optional
R required Wenn Daten vorhanden sind und nicht geschützt sind (z. B. aus Datenschutzgründen), müssen sie bereitgestellt werden, andernfalls können sie weggelassen oder explizit der null flavor angegeben werden.

Sender und Empfänger müssen dieses Element unterstützen.

M mandatory Die Daten müssen mit einem gültigen Wert aus der zugehörigen Wertdomäne befüllt werden, andernfalls ist die Instanz nicht gültig und darf nicht kommuniziert werden.
Der Sender und der Empfänger müssen dieses Element unterstützen.
C conditional Es gibt Bedingungen, in denen Daten bereitgestellt werden müssen (z. B. Co-Constraints wie "Informationen über die Schwangerschaft, wenn der Patient" weiblich "ist.
Der Sender und der Empfänger müssen dieses Element unterstützen.
F fixed Die Daten haben einen festen Wert.
NP not present Daten sollen nicht aufscheinen


  • 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.


Details von der Tabellenansicht

Art-decor-5.png

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.
Elemente werden mit einem Dreieck bezeichnet, Attribute mit einem @ -Zeichen (2).
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.
Die Kardinalitäts- und Konformitätsspalte ist oben (4) erläutert.
Feste Werte für z.B. Attribute werden auch in der Spalte "Beschreibung" (5) angezeigt, denen ein "F" in der Spalte Conf folgt.
Konformitätserklärungen werden zusammen mit einer CONF-Box gezeigt, z.B. ein @code und ein @codeSystem mit festen und erforderlichen Werten (6).
Ein optionales Label wird in der rechten Spalte (7) angezeigt.
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.

Art-decor-6.png

Die Auswahl von Elementen wird als Auswahlliste mit den Elementen in Fragen dargestellt, die in einer Aufzählungsliste zusammengefasst sind.

Art-decor-7.png

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.

Art-decor-8.png

Wenn eine Einschränkung in Worten ausgedrückt wird, begleitet eine Box "Constraint" den Textausdruck der Einschränkung.

Art-decor-9.png

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.

  1. HL7 Templates Standard: Specification and Use of Reusable Information Constraint Templates, Release 1 [1]
  2. How to read ART-DECOR Definitions https://art-decor.org/mediawiki/index.php?title=How_to_read_ART-DECOR_Definitions