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 .
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)
Scroll Pagebreak |
---|
Info | ||
---|---|---|
| ||
Schriftart und Schriftgröße Sie können innerhalb eines RichText jede verfügbare Schriftart verwenden. Beachten Sie, dass Sie in einem RichText nur die Schriftarten verfügbar sind, die das Transaktions-Formular vorgibt. Schriftauszeichnungen Sie können Schrift fett, kursiv und unterstrichen darstellen (oder Kombinationen davon). Die verfügbaren Schriftauszeichnungen werden ebenfalls vom Transaktions-Formular vorgegeben.
Schriftfarbe Sie können entweder aus der vorgegeben Farbpalette eine Schriftfarbe wählen oder sie manuell durch einen hexadezimalen Farbcode angeben. Textausrichtung Sie haben 4 Auswahlmöglichkeiten zur Textausrichtung: Linksbündig, zentriert, rechtsbündig oder Blocksatz. Die Standardeinstellung ist linksbündig.
ZeilenumbruchSie haben die Möglichkeit, den automatischen Zeilenumbruch zu aktivieren. |
Scroll Pagebreak |
---|
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):
Abbildung A
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 Abb. A (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:
Abbildung B: RichText "Eins"
besitzt folgende interne Darstellung:
Abbildung C: Quellcode von "'Eins"
Da RichTexte nach dem XFA-Standard abgespeichert werden, werden sie nicht in Datentypen konvertiert (wie Variablen)
Der Ausdruck
Codeblock |
---|
${ 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.
Hinweis | |||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||
| |||||||||||||||||
Section | |||||||||||||||||
Column | |