Funktionen im Funktionsgenerator erstellen

Im Funktionsgenerator wählen Sie eine Funktion aus und legen die Verbindung und die Elemente fest, die die Funktion verwenden soll. Der Funktionsgenerator erstellt anschließend die Funktion mit der richtigen Syntax und gibt sie in die ausgewählte Zelle ein. Sie können diese Funktionen bearbeiten.

Die für Sie verfügbare Auswahl in einem bestimmten Funktionsgeneratorfeld ist durch Ihre Auswahl in anderen Feldern des Funktionsgenerators begrenzt. Beispiel: Es werden nur die von der ausgewählten Funktion unterstützten Verbindungen und nur die Dimensionen angezeigt, die von der von Ihnen ausgewählten Funktion unterstützt werden.

Für jedes Funktionsargument kann ein Zellverweis gewählt werden. Falls Sie Eingabewerte für Argumente kennen, können Sie Funktionen im Offlinemodus erstellen. Die Eingabefunktion ist für jedes Argument verfügbar.

Funktionsbeschreibungen

Hinweis:

Sie können Funktionen verwenden, die im Funktionsgenerator vor Release 11.1.2.2.310 erstellt wurden. Ab Release 11.1.2.2.310 jedoch verwendet der Funktionsgenerator Kommas (,) um die Elementlistenargumente zu trennen, und keine Semikolons (;). Beide Zeichen werden von dem neuen Funktionsgenerator unterstützt; wenn Sie jedoch eine Funktion ändern, die mit einer vorherigen Version erstellt wurde, werden Sie aufgefordert, in das neue durch Komma getrennte Format zu konvertieren. Falls Sie nicht konvertieren möchten, wird keine Ihrer Funktionsänderungen übernommen.

So erstellen Sie Funktionen mit dem Funktionsgenerator:

  1. Stellen Sie eine Verbindung zur entsprechenden Datenquelle her.

    Der Funktionsgenerator unterstützt gemeinsame und private Verbindungen sowie URL-Verbindungen. Stellen Sie als Best Practice sicher, dass Sie auf Cube-Ebene verbunden sind. Wenn Sie auf Anwendungsebene verbunden sind, wird möglicherweise die Nachricht "Cube nicht ausgewählt" angezeigt, wenn Sie Smart View-Funktionen wie "HsGetValue" oder "HsSetValue" verwenden. Sie können für Oracle Hyperion Financial Management jedoch weiterhin eine Verbindung auf Anwendungsebene herstellen, um Smart View-Funktionen zu verwenden.

    Oracle Essbase: Wenn Sie eine private Verbindung verwenden und Ihre Funktion eine Aliastabelle verwendet, müssen Sie sicherstellen, dass die richtige Aliastabelle oder die Aliastabelle "Standard" für die Verbindung festgelegt ist. Klicken Sie im Smart View-Bereich mit der rechten Maustaste auf den Datenbanknamen, und wählen Sie Aliastabelle festlegen aus. Stellen Sie sicher, dass die richtige Aliastabelle ausgewählt ist, und aktualisieren Sie das Arbeitsblatt.

  2. Wählen Sie in dem Arbeitsblatt die Zelle aus, in die Sie die Funktion eingeben möchten.
  3. Navigieren Sie im Smart View-Bereich zu der Datenbank, auf der die Funktion basieren soll, klicken Sie mit der rechten Maustaste auf den Datenbanknamen, und wählen Sie Funktion generieren aus.

    Wenn Sie so auf den Funktionsgenerator zugreifen, wird das Feld Verbindung des Dialogfeldes Funktionsargumente mit den spezifischen Verbindungsinformationen ausgefüllt, wie in Schritt 4 beschrieben.

    Wählen Sie alternativ im Smart View-Menüband die Optionen Funktionen, Funktion generieren aus.

    Wenn Sie auf diese Art auf den Funktionsgenerator zugreifen, ist das Feld Verbindung im Dialogfeld Funktionsargumente leer. Sie können Verbindungsinformationen angeben, wie in Schritt 4 beschrieben. Alternativ können Sie HSACTIVE aus der Dropdown-Liste auswählen, falls es eine aktive Verbindung im Arbeitsblatt gibt.

  4. Wählen Sie in Funktion auswählen eine Funktion aus der Liste aus, und klicken Sie auf OK.

    Abbildung 17-1 Funktionsgenerator, Dialogfeld "Funktion auswählen"


    Funktionsgenerator, Dialogfeld "Funktion auswählen", mit HsGetValue, wie in diesem Abschnitt beschrieben ausgewählt

    Hinweis:

    Nicht alle Funktionen sind für alle Provider verfügbar. Eine Liste der Funktionen und der unterstützten Provider finden Sie unter Tabelle 17-1.

    Das Dialogfeld Funktionsargumente wird angezeigt, und das Feld Verbindung wird automatisch mit den Verbindungsinformationen in einem der folgenden Formate aufgefüllt.

    • Bei gemeinsamen Verbindungen:

      WSFN|ProviderType|Server|Application|Database

      Der Parameter WSFN oben bedeutet, dass diese Funktion eine Workspace-Funktion ist und eine gemeinsame Verbindung verwendet. Workspace-Funktionen unterstützen Oracle Hyperion Enterprise Performance Management Workspace- oder Oracle Enterprise Performance Management Cloud-Verbindungen.

    • Bei privaten Verbindungen:

      PrivateConnectionName

    • Bei URL-Verbindungen:

      URLFN|URL|Server|Application|Database

    Alle zum Herstellen einer Verbindung erforderlichen Informationen sind Bestandteil des Tokens, wie oben gezeigt. Wenn das Token ungültige Informationen enthält, wird im Allgemeinen der Fehler #NoConnection angezeigt, wobei für das Servertoken folgende Ausnahmen gelten:

    • Bei EPM Cloud-Geschäftsprozessen wie Planning kann das Servertoken leer (oder ungültig) sein.
    • Das Essbase-Servertoken kann nur leer sein.
    • Financial Management erfordert den Servertokenparameter.

    Um die Verbindungsinformationen manuell einzugeben, verwenden Sie die obige Syntax.

  5. Führen Sie in Funktionsargumente für jedes Argument in der ausgewählten Funktion einen der folgenden Schritte aus:

    • Klicken Sie auf die Schaltfläche Schaltfläche "Elementauswahl", öffnet das Dialogfeld "Elementauswahl" ganz rechts.

      Beispiel: Klicken Sie für HsGetValue auf Schaltfläche "Elementauswahl", öffnet das Dialogfeld "Elementauswahl", um Elemente aus Elementauswahl auszuwählen. Wählen Sie für HsLabel und HsGetVariable Labels oder Variablen aus den Dropdown-Listen aus.

      Essbase: Beachten Sie, dass bei doppelten Variablennamen ihr vollqualifizierter Name in der Dropdown-Liste angezeigt wird. Dadurch wird das Identifizieren von Variablen vereinfacht, die auf globaler Ebene, Anwendungsebene und Datenbankebene definiert sind.

    • Sie können Argumente auch in die Textfelder eingeben. Beispiel: Um ein Element einzugeben, verwenden Sie folgendes Format: dimension#member; z.B. Year#Qtr1 oder Year#Jan.

    • Wenn Sie Zellreferenzen verwenden möchten, befolgen Sie das Verfahren unter Zellreferenzen verwenden.

    Abbildung 17-2 zeigt ein abgeschlossenes Dialogfeld Funktionsargumente für die Funktion "HsGetValue".

    Abbildung 17-2 Funktionsgenerator, Dialogfeld "Funktionsargumente" für HsGetValue basierend auf der Essbase-Sample Basic-Datenbank


    Funktionsgenerator, Dialogfeld "Funktionsargumente" für die HsGetValue-Funktion Es gibt ein Feld "Verbindung" und Felder zum Eingeben von Dimensionen und Elementen für jedes Funktionsargument.

    Die unter Funktionsargumente aufgeführten Argumente sind abhängig von der im vorigen Schritt ausgewählten Funktion.

    Hinweis:

    Beachten Sie die folgenden Best Practices:

    • Verwenden Sie für HsGetSheetInfo einen Zellverweis. Weitere Informationen finden Sie unter Zellreferenzen verwenden.

    • Nur HsSetValue: Wählen Sie Daten oder Zellreferenz aus, und geben Sie den weiterzuleitenden Wert ein.

    • Nur HsGetText und HsSetText:

      • Wählen Sie Kommentare oder Zellreferenz aus, und geben Sie den weiterzuleitenden Zellentext ein.

      • Wählen Sie Zellentextlabel aus, und wählen Sie dann ein Label aus dem Dropdown-Menü aus

    • Wenn eine aktive Arbeitsblattverbindung verfügbar ist, können Sie HSACTIVE aus der Dropdown-Liste Verbindung auswählen.

  6. Klicken Sie auf Validieren, und korrigieren Sie alle Fehler, die möglicherweise gefunden werden.

    Einige Fehler, die möglicherweise angezeigt werden, sind:

    • Verbindung offline oder ungültig

    • Ungültige Auswahl

    • Elementname ist ungültig oder stimmt nicht mit dem ausgewählten Alias überein

    • Dimensionsname ist ungültig oder stimmt nicht mit dem ausgewählten Alias überein

    • Unvollständige Dimension#Member-Kombination

    • Generischer "Fehler" bei fehlenden Anführungszeichen oder anderen geringfügigen Syntaxfehlern

    Abbildung 17-3 zeigt Fehler im Dialogfeld "Funktionsargumente", nachdem auf die Schaltfläche Validieren geklickt wurde. Im folgenden Beispiel aus der Financial Management-Beispielanwendung enthält die Syntax für zwei der Dimension#Member-Kombinationen Fehler. Der erste Fehler ist, dass der Dimensionsname ungültig ist oder nicht mit dem ausgewählten Alias übereinstimmt. Der zweite Fehler ist, dass der Elementname ungültig ist oder nicht mit dem ausgewählten Alias übereinstimmt.

    Abbildung 17-3 Validierungsfehler des Funktionsgenerators


    Funktionsgenerator, Dialogfeld "Funktionsargumente" für die HsGetValue-Funktion Die Syntax für zwei der Dimension#Member-Kombinationen enthält Fehler. Der erste Fehler ist, dass der Dimensionsname ungültig ist oder nicht mit dem ausgewählten Alias übereinstimmt. Der zweite Fehler ist, dass der Elementname ungültig ist oder nicht mit dem ausgewählten Alias übereinstimmt.
  7. Wenn die Funktionsvalidierung erfolgreich ist, klicken Sie auf OK, um die Funktion in die ausgewählte Zelle einzufügen.
  8. Um die Funktion auszuführen, befolgen Sie das Verfahren unter Funktionen ausführen.