Sitzungsparameter erstellen

Ein Sitzungsparameter ist eine Variable, die IBM® Cognos® Framework Manager einer Sitzung zuordnet.

Die Benutzer-ID und die bevorzugte Sprache sind beispielsweise beide Sitzungsparameter. Da es sich bei Sitzungsparametern um Schlüssel/Wert-Paare handelt, können Sie sich jeden Sitzungsparameter als Eintrag in einer Parameterzuordnung mit dem Namen "Sitzungsparameter" vorstellen. Sie verwenden einen Sitzungsparameter auf dieselbe Weise wie einen Parameterzuordnungseintrag, obwohl sich die Syntax für Sitzungsparameter geringfügig unterscheidet.

Es gibt zwei Typen von Sitzungsparametern: Umgebung und Modell.

Umgebungssitzungsparameter sind vordefiniert und in Content Managergespeichert. Standardmäßig werden die folgenden Sitzungsparameter in Framework Manager angezeigt:

  • runLocale

    Gibt den Code der aktuell aktiven Sprache in Framework Manager zurück. Der Modellinhalt wird in dieser Sprache angezeigt.

    Sie können die aktive Sprache jederzeit nur für Ihre aktuelle Sitzung ändern. In zukünftigen Sitzungen wird das Modell weiterhin in der Designsprache geöffnet. Weitere Informationen finden Sie im Abschnitt Sprache zu einem Projekt hinzufügen.

  • account.defaultName

    Gibt den Namen des aktuellen Benutzers wie im Authentifizierungsprovider definiert an. Beispiel: Vor-und Nachname des Benutzers.

    Wenn Sie sich anonym anmelden, wird Anonymangezeigt.

  • account.personalInfo.userName

    Gibt die Benutzer-ID für die Anmeldung bei IBM Cognos Analytics with Watsonan.

    Wenn Sie sich anonym anmelden, wird dieser Parameter nicht angezeigt.

  • current_timestamp

    Gibt das aktuelle Datum und die aktuelle Uhrzeit an

  • Maschinelles

    Gibt den Namen des Computers an, auf dem Framework Manager installiert ist.

  • current_date

    Gibt das Datum vom Server zurück, an dem die dynamische Abfrage die Anforderung ausführt.

Wenn Ihre Authentifizierungsquelle andere Parameter unterstützt und Sie Informationen zu diesen in der Authentifizierungsquelle eingegeben haben, werden weitere Sitzungsparameter angezeigt, z. B. account.personalInfo.email oder account.personalInfo.surname.

Sie können zusätzliche Parameter mithilfe von Modellsitzungsparametern definieren. Modellsitzungsparameter werden in einer Parameterzuordnung namens _envgespeichert. Sie werden im Projekt festgelegt und können mit einem Paket veröffentlicht werden.

Für Modellsitzungsparameter müssen Werte im Bereich der Objekte im Framework Manager-Modell festgelegt werden. Der Geltungsbereich kann die Verwendung vorhandener Umgebungssitzungsparameter sowie statische Werte umfassen.

Jeder Sitzungsparameter muss einen Namen und einen Standardwert haben. Sie können einen Überschreibungswert definieren, um die Ergebnisse zu testen, die dieser Wert zurückgibt. Der Überschreibungswert ist nur gültig, wenn das Modell geöffnet ist, und wird nicht gespeichert, wenn Sie das Modell speichern. Wenn kein Überschreibungswert vorhanden ist, verwendet Framework Manager den Standardwert, wenn eine Abfrage ausgeführt wird, die einen Sitzungsparameter enthält.

Die Regeln für die Verwendung von Parametern umfassen Folgendes:

  • Alle möglichen Rückgabewerte müssen denselben Datentyp haben.
  • Es kann nur ein Wert definiert werden.