Anfang des Inhaltsbereichs

Objektdokumentation Verwendung von Variablen: Variablen-Wizard und Variablen-Editor Dokument im Navigationsbaum lokalisieren

Definition

Variablen sind Parameter einer Query, die im Query Designer definiert und erst beim Ausführen der Query bzw. der Web Application mit Werten gefüllt werden. Sie fungieren als Platzhalter für Merkmalswerte, Hierarchien, Hierarchieknoten, Texte und Formelelemente und können auf unterschiedliche Art verarbeitet werden.

Die Verarbeitungsart bestimmt, wie eine Variable zur Laufzeit der Query bzw. Web Application mit einem Wert befüllt wird.

Abhängig davon, für welche Objekte Sie Variablen definieren wollen, gibt es verschiedene Variablentypen, die angeben, wo Sie die Variablen verwenden können.

Hinweis

Variablen sind wiederverwendbare Objekte, d.h. Sie definieren im Query Designer für eine Query eine Variable, diese steht dann zur Wiederverwendung für alle Queries zur Verfügung. Variablen sind nicht abhängig vom InfoProvider, nur vom InfoObject. Eine Variable, die für ein InfoObject definiert wurde, steht in allen InfoProvidern zur Verfügung, die dieses InfoObject verwenden.

Verwendung

Variablen dienen zur flexibleren Einstellung von Queries (Parametrisierung der Query). Wenn Sie im Query Designer Variablen verwenden, so wählen Sie keine festen Merkmalswerte, Hierarchien, Hierarchieknoten, Texte oder Formelelemente aus, sondern setzen Variablen als Platzhalter ein. Diese werden dann erst zur Laufzeit der Query (beim Einfügen der Query in eine Arbeitsmappe, beim Auffrischen einer Arbeitsmappe oder beim Ausführen der Query im Web) mit Werten gefüllt. Durch die Verwendung von Variablen kann eine Querydefinition als Grundlage für viele unterschiedliche Queries dienen.

Beispiel

Sie möchten eine Query für alle Kundengruppenverantwortlichen anlegen, die jeweils nur die Daten einer Kundengruppe auswertet. Sie setzen für das Merkmal Kundengruppe im Query Designer eine Variable ein. Vor dem Ausführen einer Query entscheiden Sie, für welche Kundengruppe die Query ausgeführt werden soll.

Zum Definieren und Ändern von Variablen stehen Ihnen im Query Designer zwei Werkzeuge zur Verfügung:

Der Variablen-Wizard begleitet Sie in einer Schritt-für-Schritt-Abfolge beim Definieren einer neuen Variable. Die einzelnen Schritte sind kontextsensitiv auf die Kombination von Variablentyp und Verarbeitungsart abgestimmt, d.h. der Variablen-Wizard bietet Ihnen automatisch nur jene Auswahlmöglichkeiten an, die für die Kombination von Variablentyp und Verarbeitungsart zugelassen werden. Weitere Informationen finden Sie unter Variablen mit dem Variablen-Wizard definieren.

Der Variablen-Editor bietet Ihnen auf einem Dialogfenster alle Auswahlmöglichkeiten an, um eine bestehende Variable zu ändern. Die einzelnen Felder des Dialogfensters zeigen die getroffenen Einstellungen der Variable, die Sie hier ändern können. Wenn Sie die Änderungen lieber in einer Schritt-für-Schritt-Abfolge mit erläuterndem Text vornehmen möchten, dann können Sie über Diese Grafik wird im zugehörigen Text erklärt zum Variablen-Wizard springen. Weitere Informationen finden Sie unter Variablen im Variablen-Editor ändern.

Integration

Der Variablen-Wizard und der Variablen-Editor stehen im Query Designer kontextsensitiv zur Verfügung.

Prinzipiell erscheinen die beiden Dialoge überall da, wo Sie Konstanten, also Werte, eingeben können. Unter diesen Eingabefeldern gibt es das Ankreuzfeld Variableneingabe. Wenn Sie diese Option markieren, dann erscheinen folgende Möglichkeiten zur Verwendung einer Variable anstatt des festen Werts:

·        In der Dropdown-Box des Eingabefelds erscheinen die vorhandenen Variablen. Hier können Sie eine Variable auswählen.

·        Neben dem Ankreuzfeld Variableneingabe erscheint das Symbol Diese Grafik wird im zugehörigen Text erklärt Variable ändern. Über Diese Grafik wird im zugehörigen Text erklärt können Sie die Variable gegebenenfalls ändern. Sie gelangen auf das Dialogfenster Variablen-Editor.

·        Neben dem Ankreuzfeld Variableneingabe erscheint auch das Symbol Diese Grafik wird im zugehörigen Text erklärt Neue Variable. Wählen Sie Diese Grafik wird im zugehörigen Text erklärt, wenn Sie eine neue Variable anlegen möchten. Sie gelangen auf das Dialogfenster Variablen-Wizard.

Beispiel

Beispielsweise können Sie bei der Definition von Bedingungen für die Grenzwerte der Bedingung nicht nur feste Werte eingeben, sondern auch Formelvariablen verwenden. Sie markieren dazu das Ankreuzfeld Variableneingabe und die oben beschriebenen Möglichkeiten zur Verwendung von Variablen stehen Ihnen zur Verfügung. Dabei ist die Verwendung so kontextsensitiv eingestellt, dass in der Dropdown-Box nur die vorhandenen Formelvariablen erscheinen. Der Variablen-Wizard ist ebenso automatisch auf die Eingabe von Formelvariablen eingestellt.

Darüber hinaus gelangen Sie zum Variablen-Wizard und zum Variablen-Editor im Kontextmenü von jenen Objekten, für deren Werte Sie variable Platzhalter definieren können. Wählen Sie im Kontextmenü Neue Variable. Sie gelangen auf den Variablen-Wizard. Im Kontextmenü von bereits definierten Variablen können Sie Bearbeiten wählen. Sie gelangen auf den Variablen-Editor.

Beispiel

Sie markieren im Auswahlfenster der InfoProvider-Objekte ein Merkmal (z.B. Auftrag) und wählen im Kontextmenü Neue Variable. Sie gelangen auf den Variablen-Wizard, welcher bereits auf die Eingabe einer Merkmalswertvariable eingestellt ist.

Sie markieren im Auswahlfenster der InfoProvider-Objekte eine Merkmalswertvariable und wählen im Kontextmenü Bearbeiten. Sie gelangen auf den Variablen-Editor, wo Sie alle Einstellungen der Variable sehen und Ihre Änderungen vornehmen können.

Ende des Inhaltsbereichs