Seitenhistorie

Ein RichText erlaubt die Editor gestützte Speicherung und Darstellung von formatiertem Text. Im Gegensatz zu Variablen, in denen nur Textwerte gespeichert werdenSie Text nur durch Inline-Sequenzen formatieren können, eignen sich RichTexte deshalb dazu, Text zu erstellen,der wesentlich besser für Texte, die später formatiert im Dokument dargestellt werden sollsollen. Da RichTexte allerdings intern immer mit FormatierungsinformationenFormatierungsinformationen abgespeichert werden werden und sie nicht wie Variablen in Datentypen umgewandelt werden, können Sie RichTexteRichTexte in EVAL-Anweisungen Anweisungen nicht so verwenden wie Variablen. RichTexte sollten daher wirklich nur zur Texterstellung für Texte genutzt werden.

Das Symbol für RichTexte im R-S ist Image Added.

Formatierungsmöglichkeiten in einem RichText

...

Im Gegensatz zu Variablen , in denen Sie Text nicht formatieren können, stehen Ihnen bei RichTexten folgende Möglichkeiten zur Verfügung: (Wie Sie den RichText-Editor benutzen, lernen Sie hier) 

EVAL-Anweisungen und dynamische Einbindung innerhalb von RichTexten

...

Sie können in RichTexten, wie in allen anderen Ressourcen mit Textinhalt, EVAL-Anweisungen und dynamische Einbindung verwenden. Da RichTexte für Textabschnitte in Dokumenten verwendet werden, werden oft Datenstrom-Variablen dynamisch eingebunden, um den Text zu personalisieren:

personalisieren (Datenstrom-Variablen sind Werte, die das Transaktions-Formular definiert und die das Datensystem liefert. In ihnen werden die Informationen zum aktuellen Formular mitgeliefert):

Image Added
Abbildung AImage Removed
Abbildung A: Dynamische Einbindung in einem RichText

In Abb. A wird die dynamische Einbindung von Datenstrom-Variablen in einen RichText gezeigt. Das Transaktions-Formular stellt 4 Datenstrom-Variablen bereit Abb. A (1), die  die in den RichText eingebunden werden, um den Text zu personalisieren (2). Wie Sie sehen, können Sie eingebundene Ressourcen direkt im Textfluss des RichText mitformatierenmit formatieren, indem Sie die Formatierung auf die gesamte EVAL-Anweisung anwendenAbb. A (3). So wird z.B. DS.PRICE im Dokument kursiv in (3)kursiv und DS.PAYMENT_DATE  rot dargestellt. Durch die Erweiterung Logo Abb. A (4) wird der RichText an den Erweiterungspunkt ZS_INFO Abb. A (5) gebundenund im Dokument dort eingefügt Abb. A (6). Selbstverständlich lassen sich nicht nur Datenstrom-Variablen, sondern alle auch andere R-S Ressourcen in RichTexte einbinden.

Interne Darstellung von RichTexten

...

Das R-S implementiert RichText Ressourcen nach dem XFA-Standard 2.0. Weitere Informationen finden Sie hier: W3C XFA-Spezifikation. Sie können den Quellcode eines RichTexts einsehen (aber nicht Bearbeiten), indem Sie im Rich-Text-Editor auf "Quelltext..." klicken.

Folgender Text:

Image Removed
Abbildung B: RichText "Eins"

besitzt folgende interne Darstellung:

Image Removed
Abbildung C: Quellcode von "'Eins"

Da RichTexte nach dem XFA-Standard abgespeichert werden, werden sie nicht in Datentypen konvertiert (wie Variablen)

Der Ausdruck

${ IsNullI(Eins) }

würde Würde 1 ergeben, obwohl der Inhalt des RichText "1" ist. Grund ist, dass der RichText nicht in einen Integer mit dem Wert 1 konvertiert wird und der Wert deshalb undefiniert ist ( = 0 ). Wäre die Ressource Eins eine Variable, so wäre das Ergebnis 0, da Variablen in Integer konvertiert werden können. Sie können RichTexte also in EVAL-Anweisungen nicht auf dieselbe Weise nutzen wie Variablen.

Natürlich können Sie aber RichTexte dynamisch in eine andere Ressource einbinden, z.B. in einer eine Variablen mit dem Ausdruck:

...

Die Formatierung des RichText bleibt dabei erhalten.

Hinweise zur praktischen Anwendung und bekannte Einschränkungen

Im Folgenden sollen einige Hinweise zur praktischen Anwendung von RichText-Ressourcen gegeben werden. Dabei sollen nicht nur Möglichkeiten, sondern auch bekannte Einschränkungen bei der Nutzung von RichText-Ressourcen gegeben werden.

Tabulatoren

• haben einen festen Abstand (können nicht verändert werden).
• sind immer linksbündig.
• können nur in linksbündig ausgerichtetem Absätzen verwendet werden (nicht rechtsbündig und nicht zentriert).

Einbinden von Ressourcen und Ausdrücken über ${...}

• es können Ressourcen gestaffelt eingebunden werden (z.B. wird über eine Regel auf Inhalte von Variablen zugegriffen).
• INLINE-Sequenzen werden im RichText nicht ausgewertet, ebenfalls nicht über eingebundene Ressourcen.
• besitzen eingebundene Ressourcen eine Formatierung über RichText, so bekommt diese Formatierung Vorrang vor der Formatierung im übergeordneten RichText.
• besitzen eingebundene Ressourcen KEINE Formatierung, so wird die Formatierung des übergeordneten RichText angewendet.