Syntax für das Referenzieren von Variablen

Sie können Variablen in Analysen und Dashboards referenzieren.

Die Referenzierung einer Variablen hängt von der Aufgabe ab, die Sie ausführen. Bei Aufgaben, bei denen Felder in einem Dialogfeld angezeigt werden, müssen Sie nur den Typ und Namen der Variablen (nicht die ganze Syntax) angeben; Beispiel: Referenzieren einer Variablen in einer Filterdefinition.

Bei anderen Aufgaben, wie dem Referenzieren einer Variablen in einer Titelansicht, geben Sie die Variablensyntax an. Die verwendete Syntax hängt von dem Typ der Variable ab, wie in der folgenden Tabelle beschrieben.

Typ Syntax Beispiel

Session

@{biServer.variables['NQ_SESSION.variablename']}

wobei variablename der Name der Sessionvariable ist, Beispiel: DISPLAYNAME.

@{biServer.variables['NQ_SESSION.SalesRegion']}

Semantisches Modell (Repository)

@{biServer.variables.variablename}

oder

@{biServer.variables['variablename']}

wobei variablename der Name der Variable ist, z.B. prime_begin

@{biServer.variables.prime_begin}

oder

@{biServer.variables['prime_begin']}

Präsentation oder Anforderung

@{variables.variablename}[format]{defaultvalue}

oder

@{scope.variables['variablename']}

Dabei entspricht:

variablename ist der Name der Präsentations- oder Anforderungsvariable, Beispiel: MyFavoriteRegion.

(Optional) format ist eine Formatmaske, die vom Datentyp der Variablen abhängig ist; Beispiel: #,##0, MM/DD/YY hh:mm:ss. (Beachten Sie, dass das Format nicht auf den Standardwert angewendet wird.)

(Optional) defaultvalue ist eine konstante oder variable Referenz, die einen Wert angibt, der verwendet werden muss, wenn die durch variablename referenzierte Variable nicht ausgefüllt ist.

scope identifiziert die Bezeichner für die Variable. Sie müssen den "scope" (Geltungsbereich) angeben, wenn eine Variable auf mehreren Ebenen verwendet wird (Analysen, Dashboard-Seiten und Dashboards) und Sie auf einen bestimmten Wert zugreifen möchten. (Wenn Sie den Geltungsbereich nicht angeben, ist die Prioritätsfolge: Analysen, Dashboard-Seiten und Dashboards.)

Wenn ein Dashboard Prompt mit einer Präsentationsvariable verwendet wird, die mehrere Werte haben kann, hängt die Syntax vom Spaltentyp ab. Mehrere Werte werden als durch Komma getrennte Werte formatiert, und daher wird vor der Verbindung durch Kommas auf jeden Wert eine FORMAT-Klausel, falls zutreffend, angewendet.

@{variables.MyFavoriteRegion}{EASTERN REGION}

oder

@{dashboard.MyFavoriteRegion}{EASTERN REGION}

oder

@{dashboard.variables['MyFavoriteRegion']}

oder

(@{myNumVar}[#,##0]{1000})

oder

(@{variables.MyOwnTimestamp}[YY-MM-DD hh:mm:ss]{)

oder

(@{myTextVar}{A, B, C})

Global

@{global.variables.variablename}

wobei variablename der Name der globalen Variable ist, Beispiel: gv_region. Wenn Sie auf eine globale Variable referenzieren, müssen Sie, wie im Beispiel gezeigt, den vollqualifizierten Namen verwenden.

Die Namenskonvention für globale Variablen muss den ECMA-Skriptingspezifikationen für JavaScript entsprechen. Der Name darf nicht länger sein als 200 Zeichen und darf keine eingebetteten Leerzeichen, reservierten Wörter oder Sonderzeichen enthalten. Falls Sie mit den Anforderungen der JavaScript-Skriptsprache nicht vertraut sind, wenden Sie sich an einen Experten

@{global.variables.gv_date_n_time}

Sie können Variablen auch in Ausdrücken referenzieren. Die Richtlinien zur Referenzierung von Variablen in Ausdrücken werden in den folgenden Themen beschrieben:

Sessionvariablen

Sie können die folgenden Richtlinien bei der Referenzierung von Sessionvariablen in Ausdrücken verwenden.

  • Beziehen Sie die Sessionvariable als Argument der Funktion VALUEOF ein.
  • Setzen Sie den Variablennamen in doppelte Anführungszeichen.
  • Stellen Sie der Sessionvariable NQ_SESSION und einen Punkt voran.
  • Schließen Sie NQ_SESSION in doppelte Anführungszeichen ein.
  • Setzen Sie den NQ_SESSION-Teil und den Namen der Sessionvariable in Klammern.

Beispiel:

"Market"."Region"=VALUEOF("NQ_SESSION"."SalesRegion")

Präsentationsvariablen

Sie können die folgenden Richtlinien bei der Referenzierung von Präsentationsvariablen in Ausdrücken verwenden.

Bei der Referenzierung einer Präsentationsvariable verwenden Sie folgende Syntax:

@{variablename}{defaultvalue}

wobei variablename der Name der Präsentationsvariable und defaultvalue (optional) eine konstante oder variable Referenz ist, die einen Wert angibt, der verwendet werden muss, wenn die durch variablename referenzierte Variable nicht ausgefüllt ist.

Um die Variable in eine Zeichenfolge zu konvertieren oder mehrere Variablen aufzunehmen, setzen Sie die ganze Variable in einfache Anführungszeichen. Beispiel:

'@{user.displayName}'

Wenn auf das @-Zeichen keine { folgt, wird es als @-Zeichen behandelt. Wird eine Präsentationsvariable verwendet, die mehrere Werte haben kann, hängt die Syntax vom Spaltentyp ab.

Verwenden Sie die folgende Syntax in SQL für den angegebenen Spaltentyp, um gültige SQL-Anweisungen zu erstellen:

  • Text - (@{variablename}['@']{'defaultvalue'})

  • Numerisch - (@{variablename}{defaultvalue})

  • Datum/Uhrzeit - (@{variablename}{timestamp 'defaultvalue'})

  • Datum (nur das Datum) - (@{variablename}{date 'defaultvalue'})

  • Uhrzeit (nur die Uhrzeit) - (@{variablename}{time 'defaultvalue'})

Beispiel:

'@{user.displayName}'

Variablen semantischer Modelle (Repository-Variablen)

Sie können die folgenden Richtlinien bei der Referenzierung von Variablen semantischer Modelle (Repository-Variablen) in Ausdrücken verwenden.

  • Schließen Sie die Variable als Argument der VALUEOF-Funktion ein.
  • Setzen Sie den Variablennamen in doppelte Anführungszeichen.
  • Referenzieren Sie eine statische Variable eines semantischen Modells (Repositorys) nach Name.
  • Referenzieren Sie eine dynamische Variable eines semantischen Modells (Repositorys) mit ihrem vollqualifizierten Namen.

Beispiel:

CASE WHEN "Hour" >= VALUEOF("prime_begin") AND "Hour" < VALUEOF("prime_end") THEN 'Prime Time' WHEN ... ELSE...END