Definition
Datenstrom-Variablen bilden eine Schnittstelle zwischen ERP-/CRM-/HOST-Systemen, also den datenverarbeitenden Systemen,
die kundenspezifische Informationen enthalten und diese in Form eines Datenstroms für jedes Formular ausgeben, und dem R-S.
Dieser Datenstrom, der zu jedem Formular die benötigten Kundeninformationen enthält, kann durch Datenstrom-Variablen abgefangen
und genutzt werden. Eine Datenstrom-Variable ist also eine Ressource, die ein Datenfeld eines an den Produktionsprozess angeschlossenen
Datensystems repräsentiert und dieses Datenfeld in das R-S migriert. Im R-S kann die Datenstrom-Variable dann als Ressource benutzt werden.
Der Wert der Datenstrom-Variable wird erst bei der endgültigen, externen Dokumentgenerierung eingesetzt (z.B. durch den OMS-ReportWriter).
Der Wert der Datenstrom-Variable steht also im R-S noch nicht fest.
Deklaration
Datenstrom-Variablen haben immer die Form:
DS.NAME_DER_VARIABLE
Nur Datenstrom-Variablen dürfen im R-S mit DS. beginnen, sie sind dadurch eindeutig gekennzeichnet.
Datenstrom-Variablen können im R-S weder erstellt noch bearbeitet, gelöscht oder umbenannt werden,
da Sie externe Ressourcen repräsentieren und als Schnittstelle zwischen dem Datensystem und dem R-S fungieren.
Inhalt und Werte von Datenstrom-Variablen
Nicht alle Datenfelder, die im zugrunde liegenden ERP-/CRM-/HOST-System existieren, müssen auch im R-S als Datenstrom-Variablen verfügbar sein.
Welche Datenstrom-Variablen im R-S verfügbar sind, wird durch den Formular-Designer bestimmt und ist im Import-Paket (Transaktions-Formular) festgelegt.
Dort können Sie in der Registerkarte Datenstrom-Variablen einsehen (Gibt es auch bei Schema-Versionen), welche Datenstrom-Variablen ein Formular bereitstellt.
Datenstrom-Variablen müssen auch nicht zwingend denselben Namen haben wie das Datenfeld im Datensystem, das Sie repräsentieren.
Zur Vereinfachung kann der Formular-Designer die Namen der Datenstrom-Variablen selbst festlegen.
Welchen Wert eine Datenstrom-Variable annehmen wird, ist zum Zeitpunkt der Bearbeitung im R-S unbekannt, da dies ja für jedes Formular individuell ist
(Jeder Kunde hat einen anderen Namen, eine andere Kundennummer, einen anderen Rechnungsbetrag, nicht jeder kommt aus Deutschland, usw.).
Um im R-S mit Datenstrom-Variablen arbeiten zu können, muss jedoch bekannt sein, welchen Inhalt eine Datenstrom-Variable repräsentiert.
Dazu enthält optimalerweise jede Datenstrom-Variable eine Beschreibung und eine Angabe möglicher Werte, um dem R-S Nutzer mitzuteilen,
welche Werte eine Datenstrom-Variable enthalten kann (oder welche Werte, die eine Datenstrom-Variable anehmen kann, relevant sind).
Diese Angaben werden durch den Formular-Designer gemacht und sind in der Registerkarte Datenstrom-Variablen einzusehen:
Die angegebenen Werte müssen nicht zwingend alle möglichen Werte repräsentieren. Es werden nur die Werte gezeigt,
die der Formular-Designer angegeben hat.
Datenstrom-Variablen enthalten immer einen STRING
(Text). Wie normale Variablen können aber auch Datenstrom-Variablen alle Datentypen enthalten,
die das R-S kennt. Mehr über Datentypen finden Sie hier.
Wenn Sie also z.B. in Regeln Bedingungen definieren, die von einer Datenstrom-Variable abhängen, müssen Sie sicher sein,
dass die Datenstrom-Variable auch den Datentyp enthält, den Sie voraussetzen. Geben Sie bspw. in einer Regel der Spalte als Bedingung eine Datenstrom-Variable:
DS.ORDER_DATE
und als Datentyp der Spalte DATE
an, müssen Sie sicherstellen, dass der Inhalt von DS.ORDER_DATE
auch in jedem Fall mit dem R-S Datentyp DATE
konform ist,
da die Bedingung sonst nicht ausgeführt werden kann (Wenn Sie nicht mehr wissen, wie man mit Regeln arbeitet, lesen Sie deren Definition).
Nutzung von Datenstrom-Variablen
Datenstrom-Variable können wie jede andere R-S Ressource verwendet werden: Sie können sie direkt per Erweiterung in einen Layout-Bereich des Formulars einfügen
(Erweiterungen lernen Sie später kennen) oder in einer anderen Ressource mit Hilfe dynamischer Einbindung. Dynamische Einbindung mit Hilfe einer EVAL-Anweisung
haben Sie bereits in den vorherigen Ressource-Beschreibungen kennengelernt: Sie können in einer Ressource eine andere Ressource einfügen (auf sie verweisen),
indem Sie folgenden Term benutzen: ${Name_der_Ressource}
.
Die Verwendung in anderen Ressourcen ist für Datenstrom-Variablen in der Regel sinnvoller, da Datenstrom-Variablen einfache Werte enthalten,
die normalerweise nicht unformatiert in ein Dokument eingefügt werden sollen. Oft dienen Datenstrom-Variablen auch als Entscheidungs-Variablen.
Die häufigsten Verwendungsarten von Datenstrom-Variablen sind:
1.3.7 WhiteSpaces | 1.4 Basis-Objekte im R-S Basis-Objekte im R-S