Variablen sind die grundlegenden Ressourcen im R-S.
Es handelt sich dabei um einfache Platzhalter für benutzerdefinierte Werte.
Der Wert einer Variablen im R-S wird als STRING
eingegeben. Je nach Form des STRINGs wird aber zwischen verschiedenen
Datentypen unterschieden. Enthält die Variable z.B. nur Ziffern, kann Sie als INTEGER, NUMBER, REAL oder auch BOOLEAN behandelt werden.
Die verschiedenen Datentypen im R-S zeichnen sich durch ihre Form aus.
Sinnvolle Datentypen für Variablen sind z.B.:
Datentyp | Beschreibung | Wertebereich |
---|---|---|
| Ganzzahliger numerischer Wert mit positivem oder negativem Vorzeichen. Das Vorzeichen kann vor oder nach dem ganzzahligen numerischen Wert stehen. | -2147483648 bis +2147483648 |
| Numerischer Wert mit Nachkommastellen mit positivem oder negativem Vorzeichen. Das Vorzeichen kann vor oder nach dem ganzzahligen Wert stehen. | -3,4E-4932 bis +3,4E-4932 |
| Schaltvariable zum Speicher von 2 Werten: Wahr oder Falsch | true / false bzw. yes / no bzw. 1 / 0 |
| Datumsformat nach ISO 8601 | Datum der Form yyyy-mm-dd, z.B.: 2013-04-08 |
| Name einer R-S Ressource, z.B. einer anderen Variable | Name einer verfügbaren R-S Ressource |
| Name eines R-S Objekts, z.B. eines physikalischen Beileger | Name eines verfügbaren R-S Objekts |
Neben den Typen in der Tabelle definiert das R-S noch weitere Datentypen. Weitere Informationen darüber finden Sie hier.
Abbildung A: Beispielwerte einer Variablen
Ist der Wert einer Variablen konform mit einem Datentyp, können Sie die Variable z.B. in einer anderen Ressource auch so behandeln
und damit arbeiten:
Variable | Variablen-Inhalt | Wert der Variable |
---|---|---|
VariableA | 0 | 0 |
VariableB | $IsNullI(VariableA) | 1 |
EVAL-Anweisungen innerhalb von Variablen
Neben der Möglichkeit, den Inhalt einer Variable statisch durch einen festen Wert zu definieren,
können Sie innerhalb von Variablen auch EVAL-Anweisung verwenden.
Mithilfe von EVAL-Anweisungen können Sie andere Ressourcen und dynamische Werte in eine Variable einbinden.
Lesen Sie dazu bitte den Abschnitt über EVAL-Anweisungen.
Abbildung A: EVAL-Anweisung in einer Variable
In Abb. A wird gezeigt, dass in Variablen auch dynamischer Inhalt erlaubt ist.
Die Variable MyVariable
enthält durch dynamische Einbindung die binäre Ressource pf_logo
.
Die Erweiterung Logo
(Erweiterungen ermöglich das Einbetten von Ressourcen in das Dokument
mithilfe von durch das Formular festgelegten Erweiterungs-Punkten, mehr Informationen dazu finden Sie hier) benutzt dann die Variable
und bindet sie an den Erweiterungs-Punkt FUSS_FIRST
. Im Dokument sehen Sie dann den Inhalt von MyVariable
am Erweiterungs-Punkt FUSS_FIRST
.
Beachten Sie bitte, dass in einer Variable vor einer EVAL-Anweisung, die eine binäre Ressource dynamisch einbindet,
kein Text (auch keine Leerzeichen oder Zeilenumbrüche) stehen darf. Text nach der Anweisung wird ignoriert.
Dies gilt jedoch nicht für die dynamische Einbindung anderer Ressource-Typen oder anderen EVAL-Anweisungen. Diese können mit Text kombiniert werden.
Neben dynamischer Einbindung können Sie auch alle anderen gültigen EVAL-Anweisung in einer Variable verwenden.