Seitenhistorie
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. Das Symbol für Datenstrom-Variablen im R-S ist .
Deklaration
...
Datenstrom-Variablen haben immer die Form:
...
Nur Datenstrom-Variablen dürfen im R-S mit DS. beginnen.
Hinweis |
---|
...
Datenstrom-Variablen können im R-S weder erstellt noch bearbeitet, gelöscht, kopiert, importiert, exportiert oder umbenannt werden, da Sie externe Ressourcen repräsentieren. |
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:
Hinweis |
---|
...
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:
...
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 ordnungsgemäß ausgeführt werden kann.
Nutzung von Datenstrom-Variablen
...
Datenstrom-Variable können wie jede andere R-S Ressource verwendet werden: Sie können entweder direkt per Erweiterung in einen Layout-Bereich des Formular eingefügt werden (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:
...
und seine Anzeige im Dokument (mit Beispielwerten):
2. In Regeln
...
1.3.7 WhiteSpaces| 1.4 Basis-Objekte im R-S Basis-Objekte im R-S
Section | |||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|