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

Aus HL7 Austria MediaWiki
Wechseln zu: Navigation, Suche
[unmarkierte Version][unmarkierte Version]
Zeile 6: Zeile 6:
 
   <div style="width:100%;">
 
   <div style="width:100%;">
 
     <p style="padding: 15px;">  
 
     <p style="padding: 15px;">  
The template definitions are shown in a table view. It is comprised of ''Template Meta data'' and the ''Template Design''. For further information please refer to the HL7 Templates Standard: Specification and Use of Reusable Information Constraint Templates, Release 1<ref name="teits"/>.
+
Die Template Definitionen werden in einer Tabellenansicht angezeigt. Diese besteht aus Template Meta Daten und dem Template Design. Weitere Informationen finden Sie im HL7 Templates Standard: Specification and Use of Reusable Information Constraint Templates, Release 1<ref name="teits"/>.
  
Templates may also be included in the hierarchical graph view (often used for CDA), see below.
+
<br/>
 
+
<b>Template Meta Daten</b>
<b>Template Meta data</b>
 
  
 
[[Datei:art-decor-1.png|750px|100%]]
 
[[Datei:art-decor-1.png|750px|100%]]
 +
Der obere rechte Teil der Template-Tabelle enthält die Template-Metadaten. Template-ID, Status und der Template-Name werden angezeigt(1). Weiters werden die Version (effective date), ein mögliches Versionslabel und der Anzeigename angezeigt(2).
  
The upper right part of the template table contains the template meta data. Template id, status and the template name are shown (1). Furthermore the Version (effective date), a possible version label and the display name are shown (2).
+
Die Beschreibung (einfach oder ein Akkordeon) enthält die Template-Beschreibungen / Zweck(3), gefolgt von Klassifikationen und ob die Vorlage als offen oder geschlossen definiert ist(4).
 
 
The description area (plain or an accordion) contains the template descriptions/purpose (3), followed by classifications and whether the template is defined as open or closed (4).  
 
  
The usage part (5) may list templates that uses this template or what templates this templates uses. A relationship list (6) may show all relationships to other templates or models.
+
Der Verwendungsteil (5) kann Templates auflisten, die diese Vorlage verwenden oder welche Templates diese Templates verwenden. Eine Beziehungsliste (6) enthält alle Beziehungen zu anderen Temlates oder Modellen.
  
Examples may show the correct use of the template by an XML fragment (7).
+
Beispiele zeigen die korrekte Verwendung der Templates durch ein XML-Fragment (7).
  
 
[[Datei:art-decor-2.png]]
 
[[Datei:art-decor-2.png]]
  
The relationship list shows all relationships to other templates or models for this template. It is divided in the "Used by" part listing templates that make use of this template, and a "Uses" listing all templates that are used by this templates, either as inclusion or containment. Indirect relationships like the parent Document Level Template for a Section Level Template are marked with a chain symbol.
+
Die Beziehungsliste zeigt alle Beziehungen zu anderen Templates oder Modellen für dieses Template. Diese ist aufgeteilt in den "Used By" Abschnitt, welcher eine Auflistung der Templates wiedergibt, die von diesem Template Gebrauch machen, und in einen "Used" Abschnitt, der alle Templates behinhaltet, die in diesem Template eingebunden sind (entweder einbezogen oder eingegrenzt). Indirekte Beziehungen, wie die übergeordnete Document Level Template für eine Section Level Template, sind mit einem Kettensymbol markiert.
  
The PDF version is rendered in the same way, but maybe with different fonts etc. to fit customized publication requirements.
+
PDF-Version werden auf die gleiche Weise eingebunden, aber beinhalten eventuell andere Schriftarten etc., um konforme Publikationsanforderungen zu erfüllen.
  
 
[[Datei:art-decor-3.png]]
 
[[Datei:art-decor-3.png]]
  
<b>Table view of Template Design</b>
+
<b>Tabellenansicht vom Template Design</b>
  
 
[[Datei:art-decor-4.png]]
 
[[Datei:art-decor-4.png]]
  
The headings of the table view of a template design are:
+
Die Überschriften der Tabellenansicht eines Template Designs sind:
  
'''Item (1)''' contains the XML document tree view of all elements and attributes specified in the template design. Elements are denoted by a preceding triangle and attributes by a preceding "@".
+
'''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)''' data types, contains the data type of the item, for more information on valid data types for element and attributes (see <ref name="teits"/>).
+
'''DT (2)''' Datentyp, enthält den Datentyp des Elements, für weitere Informationen zu gültigen Datentypen von Element und Attribute (siehe <ref name = "teits" />).
  
'''Card / Conf (3)''' cardinality (Card) and conformance (Conf) of the item.
+
'''Card / Conf (3)''' Kardinalität (Karte) und Konformität (Conf) des Artikels.
Cardinality is the usual notion of min and max occurrences of the element. For attributes 0..1 denotes optionality, 1..1 say that the attribute is required and NP denotes prohibited attributes.
+
Kardinalität ist die übliche Vorstellung von min und max Vorkommen des Elements. Für Attribute der Kardinalität 0..1 werden als optional bezeichnet, Kardinatliät 1..1 sagt, dass das Attribut erforderlich ist und NP sind verbotene Attribute.
Conformance may display values as shown in the following table.
+
Die Konformität kann Werte wie in der folgenden Tabelle gezeigt enthalten.
 
{| class="wikitable"
 
{| class="wikitable"
 
|+Values of the conformance column
 
|+Values of the conformance column
 
! '''Conf''' !! Short !! Description
 
! '''Conf''' !! Short !! Description
 
|-
 
|-
|O || optional || Data is truly optional
+
|O || optional || Daten sind optional
 
|-
 
|-
|R || required || If data is present and not masked (e.g. for privacy reasons), it must be provided, otherwise it may be omitted or explicitly null flavored.<br/>Sender and receiver must support this element.
+
|R || required || Wenn Daten vorhanden sind und nicht geschützt sind (z. B. aus Datenschutzgründen), müssen sie bereitgestellt werden, andernfalls könne sie weggelassen werden oder explizit der null flavor angegeben werden.<br/>
 +
Sender und Empfänger müssen dieses Element unterstützen.
 
|-
 
|-
|M || mandatory || The data must be populated with a valid value from the associated value domain, otherwise the instance is not valid and may not be communicated.<br/>Sender and receiver must support this element.
+
|M || mandatory || Die Daten müssen mit einem gültigen Wert aus der zugehörigen Wertdomäne gefüllt werden, andernfalls ist die Instanz nicht gültig und darf nicht kommuniziert werden. <br/> Der Sender und der Empfänger müssen dieses Element unterstützen.
 +
 
 
|-
 
|-
|C || conditional || There are conditions when data has to be provided (e.g. co-constraints like "information about pregnancy IF the patient is "female".<br/>Sender and receiver must support this element.
+
|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. <br/> Der Sender und der Empfänger müssen dieses Element unterstützen.
 +
 
 
|-
 
|-
|F || fixed || The data has a fixed value.
+
|F || fixed || Die Daten haben einen festen Wert.
 +
 
 
|-
 
|-
|NP || not&nbsp;present || Data shall not be present
+
|NP || not&nbsp;present || Daten sollen nicht aufscheinen
 +
 
 
|}
 
|}
  
'''Description (4)''' contains a textual description of the item, may also contain constraints and values for fixed attributes.
+
'''Description (4)''' enthält eine Textbeschreibung des Elements und kann auch Einschränkungen und Werte für feste Attribute enthalten.
  
'''Label (5)''' is a human readable label that is displayed upon errors, warnings or notes during validation.
+
'''Label (5)''' ist ein menschlich lesbares Label, das bei Fehlern, Warnungen oder Notizen während der Validierung angezeigt wird.
  
<b>Details of the table view</b>
+
<b>Details von der Tabellenansicht</b>
  
 
[[Datei:art-decor-5.png]]
 
[[Datei:art-decor-5.png]]
  
The actual template design shows the XML structure in a hierarchical list of elements (items) that are typically prefixed by the namespace "hl7:" or "cda:" (1).
+
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.
  
Elements are denoted with a triangle, attributes with an @ sign (2).  
+
Elemente werden mit einem Dreieck bezeichnet, Attribute mit einem @ -Zeichen (2).
  
Data types are specified according to the list of supported data types (3). They may be simple data types (lowercase), regular data types (uppercase) or flavors thereof.
+
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.
  
The cardinality and conformance column is explained above (4).
+
Die Kardinalitäts- und Konformitätsspalte ist oben (4) erläutert.
  
Fixed values for e.g. attributes are also shown in the "description" column (5), preceded by a "F" in the Conf column.
+
Feste Werte für z.B. Attribute werden auch in der Spalte "Beschreibung" (5) angezeigt, denen ein "F" in der Spalte Conf folgt.
  
Conformance statements are shown together with a CONF box, e.g. a @code and a @codeSystem with fixed and required values (6).  
+
Konformitätserklärungen werden zusammen mit einer CONF-Box gezeigt, z.B. ein @code und ein @codeSystem mit festen und erforderlichen Werten (6).
  
An optional label is displayed at the rightmost column (7).
+
Ein optionales Label wird in der rechten Spalte (7) angezeigt.
  
<!--Some items have a reference / relationship with data set elements that are denoted as a concept target (7).-->
+
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.
Inclusion or containments of other templates, e.g. an entry within a section, are shown accordingly (8) along with their template id, display name and flexibility/stability indication, i.e. "DYNAMIC" (the most recent version) or a STATIC binding together with a version date.
 
  
 
[[Datei:art-decor-6.png]]
 
[[Datei:art-decor-6.png]]
  
Choices of elements are shown as a choice list with the elements in questions summarised in a bullet point list.
+
Die Auswahl von Elementen wird als Auswahlliste mit den Elementen in Fragen dargestellt, die in einer Aufzählungsliste zusammengefasst sind.
  
 
[[Datei:art-decor-7.png]]
 
[[Datei:art-decor-7.png]]
  
A typical Conformance Statement is the binding of a coded element to a value set. This is expressed in the way shown. The value set is represented with the id, display name and the flexibility/stability of the binding.
+
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.
 +
 
  
 
[[Datei:art-decor-8.png]]
 
[[Datei:art-decor-8.png]]
  
In case a constraint is expressed in words, a box "Constraint" accompanies the textual expression of the constraint.
+
Wenn eine Einschränkung in Worten ausgedrückt wird, begleitet eine Box "Constraint" den Textausdruck der Einschränkung.
  
 
[[Datei:art-decor-9.png]]
 
[[Datei:art-decor-9.png]]
  
In cases where constraints are expressed by formalised rules in ISO Schematron, the rule along with the role (error, warning), the test and the assertion message is shown.
+
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.
 
</div>
 
</div>
 
</div>
 
</div>

Version vom 14. August 2017, 11:18 Uhr

How to read the table view for 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 Templates Standard: Specification and Use of Reusable Information Constraint Templates, Release 1[1].
Template Meta Daten 100% Der obere rechte Teil der Template-Tabelle enthält die Template-Metadaten. Template-ID, Status und der Template-Name werden angezeigt(1). Weiters werden die Version (effective date), ein mögliches Versionslabel und der Anzeigename angezeigt(2). Die Beschreibung (einfach oder ein Akkordeon) enthält die Template-Beschreibungen / Zweck(3), gefolgt von Klassifikationen und ob die Vorlage als offen oder geschlossen definiert ist(4). Der Verwendungsteil (5) kann Templates auflisten, die diese Vorlage verwenden oder welche Templates diese Templates verwenden. Eine Beziehungsliste (6) enthält alle Beziehungen zu anderen Temlates oder Modellen. Beispiele zeigen die korrekte Verwendung der Templates durch ein XML-Fragment (7). Art-decor-2.png Die Beziehungsliste zeigt alle Beziehungen zu anderen Templates oder Modellen für dieses Template. Diese ist aufgeteilt in den "Used By" Abschnitt, welcher eine Auflistung der Templates wiedergibt, die von diesem Template Gebrauch machen, und in einen "Used" Abschnitt, der alle Templates behinhaltet, die in diesem Template eingebunden sind (entweder einbezogen oder eingegrenzt). Indirekte Beziehungen, wie die übergeordnete Document Level Template für eine Section Level Template, sind mit einem Kettensymbol markiert. PDF-Version werden auf die gleiche Weise eingebunden, aber beinhalten 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) Datentyp, enthält den Datentyp des Elements, für weitere Informationen zu gültigen Datentypen von Element und Attribute (siehe [1]). Card / Conf (3) Kardinalität (Karte) und Konformität (Conf) des Artikels. Kardinalität ist die übliche Vorstellung von min und max Vorkommen des Elements. Für Attribute der Kardinalität 0..1 werden als optional bezeichnet, Kardinatliät 1..1 sagt, 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önne sie weggelassen werden 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 gefü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. </div>

</div>

  1. 1,0 1,1 Referenzfehler: Es ist ein ungültiger <ref>-Tag vorhanden: Für die Referenz namens teits wurde kein Text angegeben.