Das Dashboard bietet die Möglichkeit verschiedene Arten von Variablen zu definieren, um diese z.B.im SQL-Statement eines Datenproviders zu verwenden. Dabei kann der bei der Anlage einer Variablen definierte Standardwert bei Bedarf für ein Dashboard, einen Datenprovider und/ oder eine Kachel überschrieben werden. Eine Variable kann auch in einer "Variablen Kachel" verwendet werden, wobei es sich um eine Kachel handelt, in welcher zuvor festgelegte Werte von (Dashboard-) Variablen ausgewählt werden können. Dieser Wert wird anschließend für die jeweilige (Dashboard-) Variable in den Kachel(n) eingesetzt und diese aktualisiert, siehe auch Einstellungen und Optionen für die Kachelart "Variablen Kachel" und Beispiel Variablen Kachel.
Die Art einer Variable wird über ihren Ursprung festgelegt und es gibt aktuell die folgenden Arten von Variablen:
Eine globale Variable ist an dem Ursprung "Global" zu erkennen und kann von allen Benutzern in einem Dashboard, einem Datenprovider und/ oder einer Kachel verwendet werden. Der bei der Definition einer globalen Variablen angegebene Standardwert und Datentyp kann in einem Datenprovider oder einer Kachel durch einen anderen Wert überschrieben werden.
Eine Dashboard-Variable ist an dem Ursprung "Dashboard" zu erkennen und steht nur dem Benutzer zur Verfügung der sie angelegt hat. Sie kann von diesem Benutzer in einem Dashboard oder einer Kachel verwendet werden, aber nicht in einem Datenprovider. Der bei der Definition einer Dashboard-Variablen angegebene Standardwert und Datentyp kann in einer Kachel durch einen anderen Wert überschrieben werden.
Eine Datenprovider-Variable ist an dem Ursprung "Datenprovider" zu erkennen und steht jedem Benutzer in dem Datenprovider zur Verfügung in dem sie angelegt wurde. Der bei der Definition einer Datenprovider-Variablen angegebene Standardwert und Datentyp kann in einer Kachel durch einen anderen Wert überschrieben werden.
Der Datentyp einer Variablen bestimmt, wie der Wert dieser Variablen verwendet werden soll. Es gibt dabei aktuell zwei unterschiedliche Datentypen, die eine Variable haben kann und welcher bei einer Variablen pro Datenprovider und Kachel individuell gesetzt werden kann:
Beim Datentyp "Standard wird die SQL Parametrisierung genutzt, um die Werte einzusetzen.
Die Variable hat folgende relevante Eigenschaften:
Name = ABEZ
Wert = Test
Die Variable wird mit @ABEZ in ein SQl-Statement eingefügt und gemäß SQL-Parametrisierung ausgeführt, d.h. ein SQL-Statement mit dieser Variablen könnte so aussehen:
SELECT TOP (100) A.LFDNR, A.ABEZ1, A.ARTNR1 FROM ARTIKEL A WHERE A.ABEZ1 =@ABEZ
Beim Datentyp Ersetzung werden die Werte in dem String vor dem Ausführen ersetzt.
Die Variable hat folgende relevante Eigenschaften:
Name = ABEZ
Wert = %Test%
Die Variable wird mit @ABEZ in ein SQl-Statement eingefügt und gemäß SQL-Parametrisierung ausgeführt, d.h. ein SQL-Statement mit dieser Variablen könnte so aussehen:
SELECT TOP (100) A.LFDNR, A.ABEZ1, A.ARTNR1 FROM ArtikelA WHERE A.ABEZ1 like '@ABEZ'
Der bei der Definition hinterlegte Wert und der Datentyp einer Variablen kann in einem Dashboard, einem Datenprovider oder einer Kachel übersteuert werden, um die Variablen flexibler nutzen zu können. Der in der Definition in der Spalte "Wert" hinterlegte Wert einer Variablen wird in die Spalte "Standardwert" vererbt und immer dann verwendet, wenn in der Spalte "Wert" nichts eingetragen wird. Der bei der Definition in der Spalte "Datentyp hinterlegte Datentyp einer Variablen kann dagegen direkt in dieser Spalte bei Bedarf verändert werden.
Bei der Vererbung gilt, dass immer der spezifischste Wert verwendet wird, die Hierarchie beginnend mit dem unspezifischsten Wert ist daher wie folgt:
Global
Dashboard | Datenprovider
Kachel
Die Variable hat folgende relevante Eigenschaften:
Ursprung = Global
Name = ABEZ
Wert = %Test%
Im Datenprovider "X" wird der Wert der Variablen " ABEZ" auf "%Art%" gesetzt und damit der Standardwert "%Test%" übersteuert. In der Kachel Y wiederum wird der Wert für die Variable "ABEZ" auf "%abc%" gesetzt, womit wiederum auch der Wert aus dem Datenprovider übersteuert wird und der Wert "%abc%" in der Kachel Y verwendet wird. In allen anderen Kacheln, die den Datenprovider "X" verwenden wird dagegen weiterhin der Wert "%Art%" aus dem Datenprovider verwendet.
Definition einer vorhandenen Variablen bearbeiten
Bearbeitung des Wertes und Datentyps einer vererbten Variablen
Einstellungen und Optionen für die Kachelart "Variablen Kachel"
Erstellung eines neuen Datenproviders
Bearbeitung eines Datenproviders
Dialogfenster globale Variablen definieren
Dialogfenster Variablen editieren
Referenznummer des Moduls in Datenprovider verwenden