Variablen für sich verändernde Informationen implementieren

Sie können Essbase-Substitutionsvariablen als Platzhalter verwenden, um Informationen regelmäßig zu ändern. Da Änderungen an einem Variablenwert überall dort widergespiegelt werden, wo die Variable verwendet wird, wird die Notwendigkeit manueller Aktualisierungen minimiert.

Beispiel: Viele Berichte hängen von Berichtsperioden ab. Wenn Sie einen Bericht basierend auf dem aktuellen Monat generieren, müssen Sie das Berichtsskript jeden Monat manuell aktualisieren. Mit einer auf dem Essbase-Server festgelegten Substitutionsvariablen, wie z.B. CurMnth, können Sie den zugewiesenen Wert jeden Monat im zutreffenden Zeitraum ändern. Wenn Sie den Variablennamen in einem Berichtsskript verwenden, werden die Informationen dynamisch aktualisiert, wenn Sie den Abschlussbericht ausführen.

In den folgenden Bereichen können Sie Substitutionsvariablen sowohl mit Aggregate Storage-(ASO-) als auch mit Block Storage-(BSO-)Anwendungen verwenden (sofern nicht anders angegeben):

  • Aggregate Storage-Modellstrukturen

  • Block Storage-Modellstrukturen - Formeln

  • Kalkulationsskripte (nur Block Storage-Datenbanken)

    Substitutionsvariablen und Laufzeitsubstitutionsvariablen werden in Kalkulationsskripten unterstützt.

  • Headerdefinitionen und Felddefinitionen für Dataload-Regeln. Sie können Variablennamen für Dimensions- und Elementnamen eingeben.

  • Data Source Name-(DSN-)Spezifikationen in Laderegeln für SQL-Datenquellen

  • SELECT-, FROM- oder WHERE-Klauseln in Laderegeln für SQL-Datenquellen

  • Sicherheitsfilter

  • MDX-Abfragen

  • Smart View

  • Berichtsskripte

Sie können Substitutionsvariablen auf folgenden Ebenen festlegen:

  • Global: Bietet Zugriff auf die Variable von allen Anwendungen und Datenbanken auf dem Essbase-Server.

  • Anwendung: Bietet Zugriff auf die Variable aus allen Datenbanken in der Anwendung.

  • Datenbank: Bietet Zugriff auf die Variable innerhalb der angegebenen Datenbank.

Zulässige Substitutionsvariablennamen und -werte

Wenn Sie Substitutionsvariablen in Essbase verwenden, befolgen Sie die Richtlinien zu den Zeichen und Datentypen, die Sie in Substitutionsvariablennamen und -werten verwenden können.

Die folgenden Einschränkungen gelten für Substitutionsvariablennamen und -werte:

Im Variablennamen zulässige Zeichen

Alphanumerische Zeichen und Unterstriche sind zulässig, jedoch keine Sonderzeichen oder Leerzeichen. Zeichenbegrenzung: siehe Limits.

Im Variablenwert zulässige Zeichen

Ein beliebiges Zeichen ist zulässig, mit Ausnahme eines vorangestellten Et-Zeichen (&). Zeichenbegrenzung: siehe Limits.

Essbase-Elementnamen, die als Variablenwerte verwendet werden

Fügen Sie Elementnamen ein, die mit einer Zahl beginnen oder Sonderzeichen in Anführungszeichen (" ") für Block Storage-Datenbanken und in Klammern ([ ]) für Aggregate Storage-Datenbanken enthalten. Weitere Informationen finden Sie unter Benennungskonventionen in Berechnungsskripten, Berichtsskripten, Formeln, Filtern sowie Werten für Substitutions- und Umgebungsvariablen.

Um einen Substitutionsvariablenwert als doppelten Elementnamen festzulegen, verwenden Sie den qualifizierten Elementnamen, der in doppelte Anführungszeichen eingeschlossen ist. Beispiel: Ein Wert für &Period kann "[2022].[Qtr1]" sein.

Verwenden Sie keinen Substitutionsvariablennamen als Teil eines qualifizierten Elementnamens. Beispiel: Es ist ungültig, "[2022].[&CurrentQtr]" anzugeben.

Als Variablenwerte verwendete Zahlen

Zahlenwerte in Anführungszeichen (" ") für Block Storage-(BSO-)Datenbanken und in Klammern ([ ]) für Aggregate Storage-(ASO-)Datenbanken einschließen.

Beispiel: Wenn der Variablenname "Monat" lautet und der Wert 01 lautet, legen Sie für Blockspeicher den Wert "01" fest. Legen Sie für Aggregate Storage den Wert [01] fest.

Mehrere Variablen mit demselben Namen

Variablen können denselben Namen haben, solange sie in verschiedenen Geltungsbereichen definiert sind. Die Priorität der Variablenauflösung funktioniert wie folgt: Die Datenbankvariable wird vor der Anwendungsvariable aufgelöst. Anwendungsvariable wird vor globaler Variable aufgelöst.

Substitutionsvariablen erstellen oder festlegen

Bevor Sie eine Substitutionsvariable festlegen, lesen Sie Zulässige Substitutionsvariablennamen und -werte.

Sie können Substitutionsvariablen auf Essbase-Server-, Anwendungs- oder Datenbankebene erstellen oder festlegen.

Um sicherzustellen, dass ein neuer Substitutionsvariablenwert in Formeln, Partitionsdefinitionen und Sicherheitsfiltern verfügbar ist, stoppen Sie die Anwendung, und starten Sie sie neu. Alle anderen Verwendungen von Substitutionsvariablen werden bei Verwendung dynamisch aufgelöst.

Wenn Sie Substitutionsvariablen hinzufügen oder aktualisieren, werden sie an die Anwendung gesendet und dynamisch aufgelöst.

Informationen zum Festlegen einer Substitutionsvariable mit der Essbase-Weboberfläche finden Sie unter Substitutionsvariablen verwenden. Sie können auch eine Anwendungsarbeitsmappe verwenden, um Variablen auf Anwendungsebene festzulegen, oder die folgenden MaxL-Anweisungen verwenden:

Substitutionsvariablen entfernen

Sie können eine Essbase-Ersetzungsvariable löschen, die nicht mehr benötigt wird.

Um eine Substitutionsvariable zu löschen, können Sie sie aus der Anwendungsarbeitsmappe entfernen und den Cube erstellen, mit der Essbase-Weboberfläche löschen oder die folgenden MaxL-Anweisungen verwenden:

Substitutionsvariablen aktualisieren

Da Substitutionsvariablen Platzhalter für das Ändern von Informationen sind, müssen Sie deren Werte möglicherweise häufig aktualisieren. Sie können vorhandene Substitutionsvariablen mit MaxL oder der Essbase-Weboberfläche ändern.

Um eine Substitutionsvariable zu aktualisieren, können Sie eine der folgenden MaxL-Anweisungen verwenden (die zu verwenden ist vom Kontext der Variablen abhängig):

Wenn Sie eine Variable lieber mit der Essbase-Weboberfläche aktualisieren möchten, finden Sie Anweisungen unter Substitutionsvariablen verwenden.