EPM 11.1.2.3 – Neue Funktionen Calc Manager

Der Calc Manager profitiert in Version 11.1.2.3 davon, dass er in der Produkt-Hierarchie ein StĂŒck nach oben gerutscht ist, es ist ein strategisches Produkt, das die BusinessRules fĂŒr Planning ablöst.
Dementsprechend umfangreich fallen die Neuerungen und Erweiterungen aus,

  • neue Laufzeit-Variable fĂŒr Kalkulations-Skripte,
  • sowie die obligatorische Erweiterung der Befehls-Referenz fĂŒr MaxL, essbase.cfg und Kalkulation
  • und, und, und….

      WEITERLESEN


      Funktion Suchen & Ersetzen
      Listenansicht filtern
      Filter in Listenansicht zurĂŒcksetzen
      System-Kommentare im Skript-Modus ausblenden
      Skript-Diagnose fĂŒr Performance (Essbase BSO / Planning)
      Variable kopieren
      Variable im Element-Block verwenden (Essbase BSO / Planning)
      GeschÀftsregeln (Skript-Modus) vergleichen
      GeschÀftsregeln im Regel-Set per Doppelklick öffnen
      Anzeige im Dialog „Variablen-Auswahl“ festlegen
      SmartLists in Bedingungen verwenden (Planning)
      Suchen und Ersetzen von Text im Design Time Prompt
      GeschÀftsregeln (Skript) aus der Deployment-Ansicht drucken
      Laufzeit-Variablen in GeschÀftsregeln verwenden
      Fehlende Werte fĂŒr Runtime-Prompts eingeben (Essbase BSO / Planning)
      Dimensions-Namen in Variable einsetzen
      Im Variablen Designer nach Variablen suchen
      Vorlagen in GeschÀftsregeln (Skript) bearbeiten
      Neue Vorlagen fĂŒr Planning und Essbase
      Elemente dynamisch erstellen und löschen (WFP, CAP, PSB, PFPPT)
      Befehlszeilen-Werkzeug (CommandLine-Utility) fĂŒr GeschĂ€ftsregeln
      Neue Custom-Defined-Functions (CDF)
      Dokumentation fĂŒr Apple Mobil-GerĂ€te optimiert

      Laufzeit-Variablen in Kalkulationen (nur BSO)

      Mit Version 11.1.2.2.3 ist es nun möglich, in jedem Produkt, das den Kalkulations-Manager (Calculation Manager) verwendet (Planning, Essbase, HFM u.a.), nach bestimmten Inhalten zu suchen.
      Dies können Namen, Beschreibungen, Kommentare oder auch Objekt-Titel sein. Die Auswahl kann durch Option „Basis Eigenschaften einschließen“ erweitert werden, dann erfolgt die Suche zusĂ€tzlich in Formeln, Skripten, Variablen und anderen Komponenten.

      Beispiel:
      Ich wĂ€hle innerhalb eines Plan-Typs einer Planning-Applikation den Knoten „Regeln“ mit Rechts-Klick aus und wĂ€hle dann „Suchen“. Die Suche startet in allen GeschĂ€ftsregeln innerhalb des ausgewĂ€hlten Knotens „GeschĂ€ftsregeln“.
      Die Suchergebnisse werden mir in einem eigenen Reiter angezeigt, mit zusÀtzlichen Informationen, wie oft und in welchen Plan-Typen und/oder Planning-Applikationen der Suchbegriff gefunden wurde.

      Eine große Erleichterung bietet Option „Alle ersetzen“, dabei werden die gefundenen Suchergebnisse sofort einzeln oder gesamt mit einem anderen Text ersetzt. Aber aufgepasst: Die Option ist nur verfĂŒgbar, wenn mit „EnthĂ€lt“ oder „Entspricht“ gesucht wurde.
      nach oben

      Listenansicht filtern

      Unter Ansicht / Listenansicht, können Filter gesetzt werden, um nur die gewĂŒnschten Objekte anzuzeigen, so weit, so bekannt. Nun können wir als Filter-Kriterium einen individuellen Text angeben und definieren, ob dieser Text im gesuchten Objekt enthalten ist, damit beginnt oder endet, auch die Unterscheidung nach Groß- und Kleinschreibung wird unterstĂŒtzt.

      Beispiel:
      Zeige nur noch Objekte an, die mit „Budget“ beginnen oder
      Zeige nur noch Objekte an, die „2015“ enthalten
      nach oben

      Filter in Listenansicht zurĂŒcksetzen

      Wie im vorigen Punkt beschrieben, schrÀnkt der Filter-Dialog in der Listen-Ansicht die anzuzeigenden Elemente ein.
      ZusĂ€tzlich lĂ€sst sich die Auswahl (=Filterung) auf einem Reiter zurĂŒckzusetzen, wĂ€hrend die Auswahl auf dem anderen Reiter bestehen bleibt.
      nach oben

      System-Kommentare im Skript-Modus ausblenden

      Bisher hat der Kalkulations-Manager im Skript-Modus automatisch verschiedene Inhalte als Kommentar eingefĂŒgt, dies war nötig, damit das Skript wieder im „grafischen Modus“ angezeigt werden kann.
      Mit der Option „Kommentare ausblenden“ bzw. „Kommentare einblenden“ lĂ€sst sich das nun gezielt steuern.

      Aber:
      Dies betrifft nur die systemseitig erstellten Kommentare, eigene Benutzer-Kommentare bleiben von dieser Einstellung unberĂŒhrt.
      nach oben

      Skript-Diagnose fĂŒr Performance (Essbase BSO / Planning)

      GeschĂ€ftsregeln können mit Befehl „Skript Diagnose“ hinsichtlich Performance und Optimierungs-Potenzial automatisch analysiert werden.

      Vorgehen (nicht fĂŒr grafische Regeln):

      • In einer beliebigen Komponente innerhalb einer GeschĂ€ftsregel klicke ich auf „Fehler und Warnungen“, wĂ€hle dann „Skript Diagnose ausfĂŒhren“ und der Kalkulations-Manager startet den Validierungs-Prozess.
      • Sind ungĂŒltige Element enthalten, wird jeder erkannte Fehler aufgelistet. Mit Rechts-Klick auf einen Validierungs-Fehler wird der Fehler in der Skript- oder Designer-Ansicht angezeigt, die Zeile mit dem Fehler ist farbig markiert. Die Fehler-Korrektur ist im Modus „Designer“ möglich.
      • Bei erfolgreicher Regel-Validierung zeigt mir der Kalkulations-Manager eine Zusammenfassung, bei Auswahl einzelner Validierungs-Hinweise lĂ€sst sich das Skript wiederum in der Skript- oder der Designer-Ansicht anzeigen.
      • Die Zusammenfassung enthĂ€lt sehr hilfreiche statistische Informationen, die meines Wissens so in noch keinem EPM-Tool erstellt wurden:
      • Anzahl Datenblöcke in der Kalkulation, Anzahl DurchlĂ€ufe durch die DB, Anzahl fehlerhafter Zuweisungen und Anzahl fehlerhaft verwendeter Dimensionen.
      • ZusĂ€tzlich gibt es Hinweise zu typischen möglichen Performance-„Bremsen“, Sparse-Dimensionen ohne Bezug (=fehlende FIX-Bereiche), BezĂŒge auf Sparse-Elemente, BezĂŒge auf Sparse-Elemente in verschiedenen Datenblöcken.

      Eine sehr gute Sache, wie ich finde, anstatt Kollegen vor den Kopf zu stoßen, weil deren Skripte noch Optimierungs-Potenzial haben, erledigt dies jetzt die „Skript Diagnose“ 😉

      FĂŒr den Profi:
      Die Warnungen sind unverbindliche Empfehlungen im Sinne von Best Practice und können ignoriert werden, wenn man weiß, warum man etwas so und nicht anders gemacht hat.
      Dennoch erhÀlt auch der erfahrene Anwender durchaus sinnvolle und hilfreiche Hinweise zur möglichen Skript-Optimierung.
      nach oben

      Variable kopieren

      AbhÀngig vom Applikations-Typ (Planning, ASO, etc.) lassen sich Variable von einer Applikation, Kalkulations-Typ, Plan-Typ, Datenbank, Regelset oder Regel zu jeder anderen Komponente innerhalb des gleichen Applikations-Typs kopieren.

      Beispiel:
      Ich kopiere eine Planning-Plan-Typ-Variable zu einer Planning-GeschÀftsregel, nicht jedoch zu einem anderen Produkt wie HFM.
      nach oben

      Variable im Element-Block verwenden (Essbase BSO / Planning)

      Variable können in einen Essbase- oder Planning-Element-Block eingefĂŒgt werden. Dieser Element-Block ist im grafischen Modus vorhanden und bildet das erste allumfassende FIX in der Berechnung. Dass hier jetzt Laufzeit-Variabelen verwendet werden können, ist das Nachziehen einer BasisfunktionalitĂ€t. Unser Workaround im grafischen Modus, mit einem Fix und der Laufzeit-Variable zu beginnen, ist jetzt nicht mehr nötig.

      GeschÀftsregeln (Skript-Modus) vergleichen

      Innerhalb der System-Ansicht ist es möglich, 2 GeschĂ€ftsregel-Skripte nebeneinander zu Vergleichszwecken darzustellen. Das sog. „Skriptvergleich-Fenster“ zeigt folgende Informationen:

        HinzugefĂŒgte Elemente im Skript werden mit hellgrauem Hintergrund dargestellt
        Gelöschte Elemente im Skript werden mit dunkelgrauem Hintergrund dargestellt
        GeÀnderte Elemente im Skript werden mit gelbem Hintergrund dargestellt
        Spalte 1 zeigt die jeweilige Zeilen-Nummer
        Spalte 2 enthÀlt eine von drei möglichen Kennzeichnungen:
        * steht fĂŒr „Zeile in der linken Spalte unterscheidet sich von der rechten Spalte“
        + steht fĂŒr „Zeile in der rechten Spalte wurde im Vergleich zur linken Spalte hinzugefĂŒgt“
        – steht fĂŒr „Zeile in der rechten Spalte wurde im Vergleich zur linken Spalte entfernt“

      Spalte 3 und 4 enthalten jeweils ein Skript. Wird eine Zeile in einem geÀnderten Skript ausgewÀhlt, zeigt ein unteres Fenster das Skript in verschiedenen Abschnitten.
      Das linke Skript erscheint im oberen Abschnitt, das rechte Skript erscheint im unteren Abschnitt.

      Aber:
      Es können nur 2 Skripte gleichzeitig verglichen werden.
      Diese Funktion ersetzt kein Versionierungs-Tool, Skripte einer vorigen und einer neueren Version können nicht verglichen werden, es sei denn, sie wurden als 2 Skripte gespeichert.
      nach oben

      GeschÀftsregeln im Regel-Set per Doppelklick öffnen

      Bisher musste man zum Öffnen einer GeschĂ€ftsregel, die Bestandteil eines Regel-Set ist, per KontextmenĂŒ öffnen, nun reicht dazu im Regel-Designer ein Doppelklick.
      nach oben

      Anzeige im Dialog „Variablen-Auswahl“ festlegen

      Der Dialog „Variablen-Auswahl“ kann in verschiedenen Komponenten des Kalkulations-Managers geöffnet werden, standardmĂ€ĂŸig zeigte er bisher immer alle verfĂŒgbaren Variablen an.
      Das kann zu MissverstĂ€ndnissen fĂŒhren, da nicht jede Variable in jeder Komponente verwendet werden kann.

      Ich bekomme nun standardmĂ€ĂŸig nur diejenigen Variablen angezeigt, die ich innerhalb der gerade aktiven Komponente einsetzen kann.
      Bei Bedarf lĂ€sst sich per Auswahl von „Alle Variablen anzeigen“ die Anzeige auch auf die aktuell nicht relevanten Variablen erweitert.
      nach oben

      SmartLists in Bedingungen verwenden (Planning)

      Eine ziemlich holprige Bezeichnung, im Englischen ist diese Funktion als Condition-Builder bekannt. Konnten bisher Elemente, Variablen und Funktionen in der Formel / Bedingung einer GeschÀftsregel verwendet werden, wurde dies nun auf Elemente von SmartLists erweitert
      nach oben

      Suchen und Ersetzen von Text im Design Time Prompt

      Was ist ein Design Time Prompt? Das ist mir einen eigenen Beitrag wert, hier erlÀutere ich nur die mit Version 11.1.2.3 umgesetzte Neuerung.
      Design Time Prompts können nach bestimmten Inhalten durchsucht und Zeichenfolgen ersetzt werden. Es lÀsst sich in einer oder in allen Zeilen des Design Time Prompt nach einem ganzen Wort oder Teilen eines Wortes suchen.
      Der Kalkulations-Manager durchsucht den Design Time Prompt und markiert Treffer in der Design Time Prompt Tabelle.

      Die gewĂŒnschte Ersetzung kann sofort auf einzelne oder alle gefundenen Suchergebnisse angewendet werden.
      nach oben

      GeschÀftsregeln (Skript) aus der Deployment-Ansicht drucken

      GeschÀftsregeln lassen sich endlich nicht nur aus der System-Ansicht, sondern auch aus der Deployment-Ansicht heraus ausdrucken.
      Gedruckt werden können die Regel-Eigenschaften, das Fluss-Diagramm oder Komponenten-Details.

      Beispiel:
      Drucke ich eine Regel mit einer Verteilungs-Komponente (Allokation) aus, enthÀlt der Ausdruck
      die Formel-Syntax,
      die Funktionen und Variablen,
      eine Beschreibung der Schritte im Fluss-Diagramm und
      die Regel-Eigenschaften.
      Vorlagen und Komponenten können ebenfalls ausgedruckt werden.
      nach oben

      Laufzeit-Variablen in GeschÀftsregeln verwenden

      GeschĂ€ftsregeln haben eine fĂ€llige Erweiterung erfahren, sie werden mit Runtime-Prompts deutlich flexibler einsetzbar. Anwender haben so die Möglichkeit, beim Start der Regel gewĂŒnschte Parameter mitzugeben.

      EnthĂ€lt der Runtime-Prompt Standardwerte, werden diese bei der Validierung geprĂŒft.

      Folgende Essbase Variable Typen werden unterstĂŒtzt:
      Numerisch
      Integer
      Text
      Cross Dimension
      Dimension
      Element(e)
      Element-Bereich
      Prozent
      nach oben

      Fehlende Werte fĂŒr Runtime-Prompts eingeben (Essbase BSO / Planning)

      Validierung und AusfĂŒhrung einer GeschĂ€ftsregel erfordern nun die Eingabe von Werten fĂŒr alle Variablen des Runtime-Prompts.
      Gibt es Standardwerte, werden diese validiert, fĂŒr die AusfĂŒhrung der Regel sind in jedem Fall Eingaben erforderlich.

      WĂ€hrend der Validierung kann ich „Werte in der Regel anwenden“ auswĂ€hlen, so werden sie bei Start der Regel angezeigt und mĂŒssen nur bei Bedarf geĂ€ndert werden.
      nach oben

      Dimensions-Namen in Variable einsetzen

      Sollte eine Variable den Wert einer Dimension annehmen, ging das bisher nicht. Nun können Werte vom Typ Element (auch Element-Bereich (Member Range)), Cross Dimension oder Dimension sein.

      In Globalen Variablen wird die Dimension eingegeben, ein Drop-down-Feld bietet dazu eine Liste aller vorhandenen Dimensionen der Applikation an.
      nach oben

      Im Variablen Designer nach Variablen suchen

      Man kann nach einer Variablen anhand ihres Namens suchen. Mit den sog. Basis-Eigenschaften der Suche lÀsst sich zusÀtzlich nach dem Standardwert, dem Typ, der Beschreibung oder Gruppe der Variablen suchen.

      Beachte:
      Die Suche erfolgt nur innerhalb des Typs (Global, Applikation, Kalkulation, Plan, Datenbank, GeschÀftsregel), der im Variablen-Navigator ausgewÀhlt wurde.

      Beispiel:
      Befinde ich mich in einem Plan-Typ, finde ich nur Variablen innerhalb dieses Plan-Typs.

      EinschrÀnkung:
      Es ist nicht möglich, Typ-ĂŒbergreifend zu suchen, deshalb ist fĂŒr jeden Typ eine separate Suche nötig. Ohne Auswahl des Typs ist die Suchfunktion deaktiviert.
      nach oben

      Vorlagen in GeschÀftsregeln (Skript) bearbeiten

      Basiert meine aktuelle bearbeitete GeschĂ€ftsregel auf einer Vorlage, kann ich im Skript-Modus eine Vorlagenzeile auswĂ€hlen und kann von dort mit der Option „Vorlage bearbeiten“ direkt zum Vorlagen-Assistenten wechseln, wo ich die Änderungen in der Vorlage selbst durchfĂŒhre.
      nach oben

      Neue Vorlagen fĂŒr Planning und Essbase

      Die Vorlagen-Bibliothek fĂŒr GeschĂ€ftsregeln enthĂ€lt 2 neue Vorlagen. Erste ist die „Verteilung mit einfachem Ausschluss“ (Allocation simple Exclude), damit lĂ€sst sich eine Verteilung auf einen Element-Bereich bei gleichzeitigem Ausschluss einzelner Elemente durchfĂŒhren.

      Die nÀchste neue Vorlage ist die WÀhrungs-Umrechnungs-Vorlage, sie kann in Applikationen verwendet werden, die ohne WÀhrungs-Option erstellt wurden.
      Sie rechnet vorhandene BetrĂ€ge in gewĂŒnschte WĂ€hrungen um und verwendet dazu Accounts (Planning) oder Account / UDA (Essbase).
      nach oben

      Elemente dynamisch erstellen und löschen (WFP, CAP, PSB, PFPPT)

      Diese Funktion gilt nur fĂŒr die genannten Planning-Applikationen, bei AusfĂŒhrung einer GeschĂ€ftsregel können Elemente dynamisch angelegt oder gelöscht werden.
      Legt man ein Dynamic-Calc-Element an, werden dessen Kind-Elemente automatisch vor Start der GeschĂ€ftsregel erstellt oder automatisch nach AusfĂŒhrung der GeschĂ€ftsregel gelöscht.
      nach oben

      Befehlszeilen-Werkzeug (CommandLine-Utility) fĂŒr GeschĂ€ftsregeln

      Das CommandLine-Utility kann verwendet werden, um GeschÀftsregeln automatisiert mittels Stapelverarbeitung (Batch) ohne Mitwirkung eines Anwenders zu starten.

      Das Utility calcmgrCmdLine.jar befindet sich in %EPM_ORACLE_HOME%\common\calcmgr\11.1.2.0\lib und erfordert die Installation der Java Laufzeitumgebung auf dem Computer, auf dem das Utility genutzt werden soll.
      Nach Kopie der .jar-Datei auf den Computer können Regeln mit folgendem Befehl gestartet werden:

      java –jar calcmgrCmdLine.jar <Calc Server URL> <USER> <PASSWORD> <APPLICATION NAME> <DATABASE NAME> <RULE NAME> [,<VARIABLE NAME>=<VARIABLE VALUE>]

    • Es kann nur eine GeschĂ€ftsregel zur gleichen Zeit ausgefĂŒhrt werden
    • Wird ein Wert einer Variable mitgegeben, die nicht in der Regel verwendet wird, wird sie ohne weitere Mitteilung ignoriert
    • Fehlt ein Variablen-Wert, verwendet die Regel den Validierungs- oder Standardwert, falls angegeben.
    • Bei erfolgreicher AusfĂŒhrung wird „0“ zurĂŒckgegeben, sonst „1“.
    • Weitere Code-Beispiele gibt es unter „http://docs.oracle.com/cd/E40248_01/epm.1112/calc_manager_help/frameset.htm?launch.html“
      nach oben

      Neue Custom-Defined-Functions (CDF)

      Folgende neue CDF’s sind hinzugekommen, die an dieser Stelle nur angerissen werden, detailliertere Informationen gibt es in der Oracle Essbase Technical Reference.

      @CalcMgrExecuteMaxLEnScript (Startet verschlĂŒsselte MaxL-Skripte)
      Java Class: com.hyperion.calcmgr.common.cdf.MaxLFunctions
      Spec: @CalcMgrExecuteMaxLEnScript(privateKey, maxlScripts, arguments, asynchronous)

      @CalcMgrExecuteEncryptMaxLFile (Startet eine verschlĂŒsselte MaxL-Datei)
      Java Class: com.hyperion.calcmgr.common.cdf.MaxLFunctions
      Spec: @CalcMgrExecuteEnMaxLFile(privateKey, maxlFileName, arguments, asynchronous)

      CalcMgrIntegerToString (Konvertiert Integer-Werte in String)
      Java Class: com.hyperion.calcmgr.common.cdf.MaxLFunctions
      Spec: @CalcMgrIntegerToString(integerNumber)

      @CalcMgrDoubleToString (Konvertiert Double-Werte in String)
      Java Class: com.hyperion.calcmgr.common.cdf.MaxLFunctions
      Spec: @CalcMgrDoubleToString(doubleNumber)

      @CalcMgrStringsToString (Konvertiert einen String-Array in String mit Trennzeichen)
      Java Class: com.hyperion.calcmgr.common.cdf.MaxLFunctions
      Spec: @CalcMgrStringsToString(strings, seperator)

      nach oben

      Dokumentation fĂŒr Apple Mobil-GerĂ€te optimiert

      Fast die gesamte EPM-Dokumentation ist in einer fĂŒr Apple MobilgerĂ€te (iPad, iPhone, iPod) optimierten Darstellung verfĂŒgbar, zu finden unter „mobi“ und „ePub“.

      http://docs.oracle.com/cd/E40248_01/nav/portal_3.htm
      nach oben

Veröffentlicht in EPM - 11.1.2.3, Essbase, Planung & Berichtswesen Verwendete Schlagwörter: , , , ,

Schreibe einen Kommentar