Quelltext der Seite cdaab2:Textformatierung

{{DocumentPart}}

===Textstrukturierung===

Die medizinischen Informationen werden im CDA Body im Sinne von Level 1 immer in Textform wiedergegeben (verpflichtend) und wo immer möglich auch mit Section-Codes versehen, also auf Level 2 dargestellt. Dies garantiert, dass die Dokumente immer für den Menschen lesbar (und verstehbar) sind.
Im Folgenden ist das Muster einer Level 1 und Level 2 Darstellung gezeigt. Level 3 ist angedeutet:

<syntaxhighlight lang="xml">
<component>
  <structuredBody>
  ... 
    <component>
      <section>
        <!-- Level 2 -->
        <code code="..." codeSystem="..." />
        <!-- Level 1 -->
        <title> ... </title>
        <text>
           ...
        </text>
        <!-- Level 3 -->
        <entry>
           ...
        </entry>
      </section>
    </component>
    ...
  </structuredBody>
</component>
</syntaxhighlight>

====Textauszeichnung====

Der Text selber kann wiederum Strukturelemente aufweisen. Dies kann genutzt werden, um Listen, Tabellen oder auch Unterabschnitte zu definieren.
Innerhalb eines Section-Tags wird in CDA Level 2 das ''text'' Tag verwendet, um den narrativen Text („plain text") darzustellen. In vielen Fällen lassen sich die medizinischen Inhalte aber auch noch weiter gehend strukturieren. Dazu stehen in CDA als Stil-Elemente Listen, Tabellen und Unterabschnitte (Paragrafen) zur Verfügung. Mit Hilfe eines einfachen Stylesheets können die Inhalte in diesen Strukturelementen für den Menschen lesbar dargestellt werden.

=====Listen=====

Das Strukturelement „Liste" dient zur Abbildung einer einfachen Aufzählung medizinischer Inhalte.
Eine Liste wird mit dem ''list'' Tag eingeschlossen. Das optionale Attribut ''@listType'' ermöglicht die Auflistung unsortiert ''(@listType''="unsorted"), die üblicherweise mit Bulletpoints • dargestellt wird, und in sortierter Form ''(@listType''="sorted") , die mit Zahlen etc. dargestellt wird. Ohne Angabe von ''@listType'' ist die Liste unsortiert.
Ein Element der Aufzählung (item) wird mit dem ''item'' Tag eingeschlossen.
Eine Liste hat formal das folgende Aussehen:

<syntaxhighlight lang="xml">
<list>
  <item> 1. Element der Liste</item>
  <item> 2. Element der Liste</item>
  <item> ...</item>
  <item> n. Element der Liste</item>
</list>
</syntaxhighlight>

''Das folgende Beispiel zeigt eine mögliche Darstellung eines Befundes, strukturiert mittels Liste.''

<syntaxhighlight lang="xml">
<text>
  <list>
    <item>Pulmo: Basal diskrete RGs</item>
    <item>Cor: oB</item>
    <item>Abdomen: weich, Peristaltik: +++</item>
    <item>Muskulatur: atrophisch</item>
    <item>Mundhöhle: Soor, Haarleukoplakie</item>
    <item>Haut blass, seborrhoisches Ekzem, Schleimhäute blass,
          Hautturgor herabgesetzt</item>
    <item>Neuro: herabgesetztes Vibrationsempfinden der Beine,
          distal betont, Parästesien der Beine, PSR, AST
          oB und seitengleich.</item>
  </list>
</text>
</syntaxhighlight>

''Dasselbe Beispiel in der Ansicht eines Browsers (mittels Stylesheet).''

{{BeginPurpleBox|Ansicht im Browser}}
* Pulmo: Basal diskrete RGs
* Cor: oB
* Abdomen: weich, Peristaltik: +++
* Muskulatur: atrophisch
* Mundhöhle: Soor, Haarkoplakie
* Haut blass, seborrhoisches Ekzem, Schleimhäute blass, Hautturgor herabgesetzt
* Neuro: herabgesetztes Vibrationsempfinden der Beine, distal betont, Parästesien der Beine, PSR, AST oB und seitengleich.
{{EndPurpleBox}}

=====Tabellen=====

Zur Repräsentation medizinischer Inhalte, die sich adäquat tabellarisch darstellen lassen, bietet sich die Tabellenform an. Als Beispiele seien genannt: Laborwerte, Allergiewerte, Diagnose mit ICD-Verschlüsselung etc.
CDA realisiert ein vereinfachtes XHTML Table Modell, das HTML sehr ähnelt. Eine Tabelle wird angedeutet mit dem table Element. Als Attribut ist hier ''@border'' vorgesehen, das die Breite der Umrahmung angibt.<sup> </sup>

<syntaxhighlight lang="xml">
<table border="1">
  ''...Tabellen-Elemente''
</table>
</syntaxhighlight>

Eine Tabelle besteht aus einer oder mehreren Spalten. In der ersten Zeile werden die Spaltenüberschriften aufgeführt.
Die Tabellenüberschrift wird eingeschlossen in ''thead'' Tags, die Überschriftenzeile in ''tr'' Tags und die einzelnen Spalten-Items der Überschrift mit ''th'' Tag.

<syntaxhighlight lang="xml">
<table>
  <thead>
    <tr>  <!-- Überschrift-Zeile -->
      <th> Spaltenüberschrift 1</th> 
      ...
      <th> Spaltenüberschrift n</th>
    </tr>
  </thead>
  ...
</table>
</syntaxhighlight>

Die eigentlichen Inhalte werden in ''tbody'' Tags, die Datenzeile in ''tr'' Tags und die einzelnen Spalteninhalte einer Datenzeile mit ''td ''Tag gekapselt.
Insgesamt hat eine Tabelle formal das folgende Aussehen:

<syntaxhighlight lang="xml">
<table>
  <thead>
    <tr>  <!-- Überschrift-Zeile -->
      <th> Spaltenüberschrift 1</th>
      ...
      <th> Spaltenüberschrift n</th>
    </tr>
  </thead>
  <tbody>
    <tr>  <!-- 1. Zeile mit Daten -->
      <td>Inhalt Spalte 1 in Zeile 1</td>
      ...
      <td>Inhalt Spalte n in Zeile 1</td>
    </tr>
    ...
    <tr> <!-- m. Zeile mit Daten -->
      <td>Inhalt Spalte 1 in Zeile m</td>
        ...
      <td>Inhalt Spalte n in Zeile m</td>
    </tr>
  </tbody>
</table>
</syntaxhighlight>

''Das folgende Beispiel zeigt die Repräsentation einer Diagnose in Tabellenform, wobei die Spaltenüberschriften lauten: "Diagnose", "ICD Code", "Lokalisation" und "Zusatz"''

<syntaxhighlight lang="xml">
<table>
  <thead>
    <tr>
      <th>Diagnose</th>
      <th>ICD Code</th>
      <th>Lokalisation</th>
      <th>Zusatz</th>
    </tr>
  </thead>
  <tbody>
   <tr>
      <td>Tuberkulose des Ohres</td>
      <td>A18.6</td>
      <td>R</td>
      <td>G</td>
    </tr>
    <tr>
      <td>Ausschluss Lungenemphysem</td>
      <td>J43.9</td>
      <td>--</td>
      <td>A</td>
    </tr>
    <tr>
      <td>V. a. Allergische Rhinopathie durch Pollen</td>
      <td>J31.1</td>
      <td>--</td>
      <td>V</td>
    </tr>
  </tbody>
</table>
</syntaxhighlight>


''Dasselbe Beispiel in der Ansicht eines Browsers (mittels Stylesheet).''

[[file:Cdaab1_beispiel2.gif|600px|Beispiel]]

=====Unterabschnitte=====

Zur Strukturierung eines längeren Textes kann das ''paragraph'' Tag verwendet werden.
Beispiel:

<syntaxhighlight lang="xml">
<text>
  <paragraph> Sollten nach der empfohlenen Medikation mit Atemur die
  klinischen Zeichen weiterhin bestehen, halte ich bei dem umfangreichen
  Risikoprofil einen Kuraufenthalt für zwingend notwendig.</paragraph>
  <paragraph> Ich bitte dann um Wiedervorstellung des Patienten.
  </paragraph>
</text>
</syntaxhighlight>

=====Überschriften=====

Mit dem ''caption'' Element kann man Paragrafen, Listen, Listenelemente, Tabellen oder Tabellenzellen mit einer Beschreibung („Überschrift") versehen. Ein ''caption'' Element enthält Text und kann Verweise (Links) oder Fußnoten enthalten.

=====Superskripts und Subskripts=====

Diese Gestaltungsmöglichkeiten sind im Standard beschrieben, werden aber in diesem Leitfaden noch nicht genutzt.

=====Zeilenumbrüche=====

Das ''br'' Element &lt;br/&gt; kann benutzt werden, um im laufenden Text einen „harten" Zeilumbruch zu erzwingen. Dies unterscheidet sich vom ''paragraph'' Element, da der Zeilenumbruch keinen Inhalt hat. Empfänger sind gehalten, dieses Element als Zeilenumbruch darzustellen.

''Beispiel''

<syntaxhighlight lang="xml">
<text>
  Patient hat Asthma seit seinem zehnten Lebensjahr.<br/>
  Patient kommt damit gut zurecht.
</text>
</syntaxhighlight>

=====Fußnoten=====

Diese Gestaltungsmöglichkeiten sind im Standard beschrieben, werden aber in diesem Leitfaden noch nicht genutzt.

=====Sonstige Zeichenstile=====

Mittels des @''styleCode'' Attributs im Textteil, das in ''content'' Elementen verwendet werden kann, ist es möglich, Vorschläge des Autors des Dokuments bezüglich der Visualisierung von umschlossenen Textteilen zu beschreiben. Der Empfänger ist nicht verpflichtet, den Text tatsächlich so visuell darzustellen, wie es die Vorschläge andeuten.
Bisher werden im Rahmen dieses Leitfadens die folgenden Style-Codes unterstützt.

{| class="hl7table"
|+
!colspan = "2" |Font-Stil-Angaben (Änderung der Font-Charakteristik)
|-
!Code!!Definition
|-
|Bold||Fettdruck
|-
|Underline||Unterstrichen
|-
|Italics||Kursivschrift
|-
|Emphasis||Betont
|}
''Tabelle 15: Stil-Codes für den narrativen Text''

<syntaxhighlight lang="xml">
<text>
  Einiges vom Text wird <content styleCode="Bold">im Fettdruck</content> 
  dargestellt, anderes in <content styleCode="Bold Italics">fetter
  Kursivschrift</content>.
</text>
</syntaxhighlight>

====Referenzierter Inhalt (content)====

Das CDA ''content'' Element wird benutzt, um Text ausdrücklich mit Tags „einzurahmen", so dass er referenziert werden kann oder bestimmte Möglichkeiten zur visuellen Darstellung genutzt werden können. Das ''content'' Element kann rekursiv ineinander geschachtelt werden, was die Einrahmung von ganzen Texten bis hin zu kleinsten Teilen (Worte, Buchstaben etc.) erlaubt.

Das ''content'' Element enthält ein optionales Identifikator Attribut, das als Ziel einer XML Referenz dienen kann. Alle diese IDs sind als XML IDs definiert und müssen im gesamten Dokument eindeutig sein. Die ''originalText'' Komponente einer RIM Klasse, die sich in den CDA Entries (siehe unten) wieder findet, kann sich somit explizit auf die vom ''content'' Element im Textteil umschlossene Information beziehen.

''Im Beispiel wird das Textstück Asthma durch das content Element eingerahmt, so dass in einem möglichen Level 3 Entry darauf Bezug genommen werden kann (originalText.reference, siehe unten).''

<syntaxhighlight lang="xml">
Beim Patienten wurde <content ID="diag-1">Asthma</content> diagnostiziert.
</syntaxhighlight>

Das ''content'' Element wird auch zur Einrahmung von Text benutzt, der in einem, bestimmten Stil dargestellt werden soll, was mit dem ''@styleCode'' Attribut (siehe unten) näher beschrieben wird.

====Referenz zu (externen) Multimedia-Inhalten====

Es ist möglich, zusätzlich zu dem Text auch Referenzen auf externe Multimediaobjekte wie Bilder etc. zu spezifizieren. Dies geschieht über das ''renderMultiMedia'' Element und dient dazu aufzuzeigen, wo das Multimedia-Objekt gezeigt/dargestellt werden soll.

Das ''renderMultiMedia'' Element hat ein optionales ''caption'' Element. Es weist außerdem die Referenz (XML ID) zum erforderlichen Objekt auf, die als XML IDREF im selben Dokument definiert sein muss. XML ID und IDREF sind also korrespondierende Definitionen (einmalig) und Referenzen darauf (mehrfach möglich) eines CDA Entry ''ObservationMedia'' (oder ''RegionOfInterest)'' im selben Dokument.

Das ''renderMultiMedia ''Element trägt dabei im ''@referencedObject'' Attribut die ID.

Die Information zum eigentlichen Objekt wird in einem CDA Entry festgehalten. Für diesen Leitfaden wird ausschließlich das Element ''observationMedia'' verwendet.

Dieser Eintrag trägt im ''entry'' Element unter anderem das ''@ID'' Attribut als Zielreferenz des ''@referencedObject'' Attributs vom'' renderMultiMedia ''Element.

=====ObservationMedia Klasse=====

Die Klasse ''ObservationMedia'' selbst ist im Prinzip ein Clinical Statement, wobei die im Folgenden genannten Elemente möglich sind.

[[file:Cdaab1_obs_media.gif|500px|Observation Media]]

''Abbildung 21: ObservationMedia CDA Entry zur Darstellung der Informationen eines Multimedia-Objektes.''

{| class="hl7table"
! Lvl
! RIM 
! Name
! DT 
! Kard 
! Conf
! Beschreibung 

|-
|1
|bgcolor="ff8888"|act
|ObservationMedia
|
|0..*
|R
|Informationen über das Multimedia-Objekt

|-
|2
|bgcolor="ff8888"|act
|@classCode
|
|1..1
|F 
|"OBS"

|-
|2
|bgcolor="ff8888"|act
|@moodCode
|
|1..1
|F
|"ENV"

|-
|2
|bgcolor="ff8888"|act
|id
|SET<II>
|0..*
|O
|Identifikation des Multimedia-Objekts

|-
|2
|bgcolor="ff8888"|act
|languageCode	
|CS CNE
|0..1
|O
|Sprachinformation

|-
|1
|bgcolor="ff8888"|act
|value
|ED
|1..1
|M
|Nähere Spezifikation des Multimedia-Objekts

|}

Hier muss das eigentliche Objekt genannt werden.

''Regel OMVL: Wenn die Klasse observationMedia genutzt wird, muss sie ein value Element mit dem eigentlichen Objekt enthalten.''

=====Vokabular=====

Der Datentyp von Multimedia-Objekten ist immer ED (encapsulated data). Dabei ist auch der Medientyp (MIME) im entsprechenden ''@mediaType'' Attribut zu nennen. Zugelassen sind hier zunächst nur die folgenden Mime-Typen. Mit „verpflichtend" sind die Typen genannt, die durch Anwendungssysteme unterstützt werden müssen.

{| class="hl7table"
!colspan = "4" | Tabelle mediaType Attribut Werte (Datenarten):
|+
!Code!!Name!!Status!!Definition
|-
|text/plain ||Plain Text ||verpflichtend ||Für beliebige Texte. Dies ist der ’default’ Typ. In dieser Form ist er identisch mit dem ST Type. 
|-
|text/html ||HTML Text ||empfohlen||Bestimmt für formatierte Texte in HTML Format. HTML reicht für die meisten Anwendungen aus, bei denen Layout erwünscht ist. HTML ist Plattform-unabhängig und weit verbreitet.  
|-
|application/pdf||Portable Document Format ||verpflichtend||
|-
|audio/basic ||Basic Audio ||empfohlen||1- Kanal Audioformat für Sprache. Obwohl Unterstützung dieses Formats verpflichtend ist, wird es in den Niederlanden kaum benutzt werden. 
|-
|audio/mpeg ||MPEG audio layer 3 ||verpflichtend ||MPEG-1 Audio layer-3 (auch bekannt als  MP3) ist momentan der Standard für komprimierte Audiodaten. 
|-
|image/png ||PNG Image ||verpflichtend ||Portable Network Graphics (PNG, http://www.cdrom.com/pub/png) ist eine verlustfreie Komprimierung von Bilddateien. Wo vorher GIF benutzt wurde, muss jetzt PNG unterstützt werden.
|-
|image/jpeg ||JPEG Image ||verpflichtend ||Dieses Format wird benutzt für hohe Resolutionen bei Fotos und anderen Bilddateien. Die Komprimierung verläuft nicht ohne Verluste, wodurch dieses Format nicht immer geeignet ist für diagnostische Zwecke. JPEG wird vorwiegend benutzt werden für ’thumbnails’ von großen (DICOM) Dateien.
|-
|video/mpeg ||MPEG Video ||verpflichtend ||MPEG ist ein internationaler Standard für Videobilder. Er ist weit verbreitet und  Open-Source-Implementierungen sind verfügbar.  
|-
|multipart/x-hl7-cda-level1|| CDA Level 1 ||empfohlen ||
|}
''Tabelle: Zugelassene mediaTypes''


=====Beispiel=====

Das darin enthaltene ''reference'' Element enthält als Wert den Verweis auf das eigentliche Multimedia-Objekt.

''Das folgende Beispiel beschreibt einen Befund am linken Zeigefinger, der zusätzlich mit einem Bild dokumentiert ist.''

<syntaxhighlight lang="xml">
<section>
   <code code="8709-8" codeSystem="2.16.840.1.113883.6.1" 
    codeSystemName="LOINC"/>
   <title>Untersuchung der Haut</title>
   <text>Rötung an der Palmarfläche des linken Zeigefingers
     <renderMultiMedia referencedObject="MM1"/>
   </text>
   <entry>
      <observationMedia classCode="OBS" moodCode="EVN" ID="MM1">
         <id root="2.16.840.1.113883.19.2.1"/>
         <value xsi:type="ED" mediaType="image/jpeg">
            <reference value="left_hand_image.jpeg"/>
         </value>
      </observationMedia>
   </entry>
</section>
</syntaxhighlight>


[[Kategorie:cdaab2|Textformatierung]]