Datenstrom-Variablen

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:

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}