Einführung

In diesem Tutorial wird gezeigt, wie Sie Groovy-Skripte implementieren, um mit Datenrastern und Datenrasteriteratoren zu arbeiten. Sie verwenden bedingte Logik, um die Hintergrundfarben in einem Datenraster festzulegen, Performance-Benchmarking zu implementieren und Standarddatenwerte in einem Raster festzulegen. Füllen Sie die Abschnitte in der Reihenfolge aus.

Hintergrund

Eine Datenrasterschnittstelle bietet Zugriff auf die POV-/Zeilen-/Spaltenheaderzellen und stellt verschiedene Iteratoren für die Iteration über die Datenzellen bereit.

Voraussetzungen

Für praktische Tutorials zu Cloud EPM müssen Sie möglicherweise einen Snapshot in eine Cloud EPM Enterprise Service-Instanz importieren. Ein Snapshot kann nicht über eine vorhandene Anwendung oder einen vorhandenen Geschäftsprozess importiert werden. Verwenden Sie vor dem Import des Snapshots eine separate Cloud EPM Enterprise Service-Instanz, oder entfernen Sie die vorhandene Anwendung oder den vorhandenen Geschäftsprozess aus der Instanz, die Sie verwenden möchten. Beim Importieren des Snapshots wird der vorhandene Inhalt nicht automatisch ersetzt oder wiederhergestellt.

Bevor Sie mit diesem Tutorial beginnen, müssen Sie:

  • Haben Sie Serviceadministratorzugriff auf eine Cloud EPM Enterprise Service-Instanz. Für die Instanz darf kein Geschäftsprozess erstellt werden.
  • Laden Sie diesen Snapshot hoch, und importieren Sie ihn in die Instanz. Für diesen Snapshot ist der Planning-Geschäftsprozess erforderlich. Wenn Sie den Snapshot bereits für ein anderes Groovy-Tutorial importiert haben, können Sie diese Anwendung weiterhin verwenden, ohne den Snapshot erneut zu importieren.

Hinweis:

Wenn beim Importieren des Snapshots Migrationsfehler auftreten, führen Sie die Migration erneut aus, ausgenommen die HSS-Shared Services-Komponente sowie die Artefakte der Sicherheits- und Benutzervoreinstellungen in der Core-Komponente. Weitere Informationen zum Hochladen und Importieren von Snapshots finden Sie in der Dokumentation Migration für Oracle Enterprise Performance Management Cloud verwalten.

Tipp:

Die Skripte, die Sie für dieses Tutorial benötigen, sind in jedem Abschnitt als Textdateien verknüpft.

Hintergrundfarbe mit bedingter Logik festlegen

In diesem Abschnitt implementieren Sie ein Groovy-Skript, um die Hintergrundfarbe für Zellen mit dem Datenwert #MISSING auf Farbe █ (0x00BFFF) einzustellen, Zellen mit einem Datenwert kleiner oder gleich 50000 auf Farbe █ (0xFF8C00) und Zellen mit Datenwerten größer als 50000 auf Farbe █ (0x00FA9A).

Hinweis:

Nachdem Sie ein Groovy-Skript definiert haben, kann es im Gegensatz zu Datenvalidierungsregeln, die im Kontext jedes Formulars definiert werden müssen, mit jedem beliebigen Formular verknüpft werden.

Groovy-Skripte erstellen

  1. Klicken Sie auf der Planning-Homepage auf Navigator (Navigator), und klicken Sie unter "Erstellen und verwalten" auf Regeln, um Calculation Manager zu öffnen.
    Navigator mit Regeln unter "Erstellen und verwalten"
  2. Blenden Sie auf der Registerkarte "Systemansicht" EPM Cloud, HP4, Plan1 ein. Klicken Sie mit die rechte Maustaste auf Regeln, und wählen Sie Neu aus.
    Systemansicht mit Kontextmenü "Regeln" und "Neu" ausgewählt
  3. Geben Sie als Namen Groovy Set Background Color ein, und klicken Sie auf OK.
    Dialogfeld "Neue Regel" mit Regelname, Anwendung und Cube
  4. Ändern Sie im Regeleditor die Designeroption in Skript bearbeiten, und setzen Sie den Skripttyp auf Groovy-Skript.
    Regeleditor mit ausgewähltem Bearbeitungsskript und Groovy-Skript
  5. Kopieren Sie dieses Skript und fügen Sie es in den Editor hinzu.
    Code reference 1operation.grid.dataCellIterator.each {
    Code reference 2    if(it.missing) {
    Code reference 3        it.bgColor = 0x00BFFF
    Code reference 4    } else if(it.data <= 50000)
    Code reference 5        it.bgColor = 0xFF8C00
        else if(it.data > 50000)
    Code reference 6        it.bgColor = 0x00FA9A
    }
    

    Kodexreferenz 1 Das Skript iteriert über jede Datenzelle im aktuellen Datenraster operation.grid, das von dataCellIterator zurückgegeben wird.

    Die implizite Variable it bezieht sich auf das aktuelle Element, über das iteriert wird. In diesem Fall bezieht sich die Variable it auf die aktuelle Datenzelle, die von dataCellIterator zurückgegeben wird.

    Tipp:

    Sie können auch eine explizit benannte Variable wie cell verwenden, wie im folgenden Beispiel dargestellt:
     operation.grid.dataCellIterator.each { cell ->
        if(cell.missing) {
          cell.bgColor = 0x00BFFF
        }
    }

    Kodexreferenz 2 Für die aktuelle Datenzelle sucht das Skript nach einem fehlenden Wert.

    Hinweis:

    Beachten Sie, dass cell.data 0 (Null) für Zellen zurückgibt, die #MISSING oder Null sind. Um eine Zelle auf #MISSING und nicht auf Null zu prüfen, können Sie die Eigenschaft cell.missing verwenden. Um eine Zelle auf Nullwert und nicht auf #MISSING zu prüfen, können Sie eine Bedingung wie cell.data == 0 && !cell.missing verwenden.

    Kodexreferenz 3 Wenn TRUE, setzt das Skript die Hintergrundfarbe der Zelle auf 0x00BFFF( █ )

    Kodexreferenz 4 Das Skript prüft, ob der Datenwert kleiner oder gleich 50000 ist.

    Kodexreferenz 5 Wenn TRUE, setzt das Skript die Hintergrundfarbe der Zelle auf 0xFF8C00 ( █ )

    Kodexreferenz 6 Wenn der Datenwert der Zelle mehr als 50000 beträgt, setzt das Skript die Hintergrundfarbe der Zelle auf 0x00FA9A ( █ )

  6. Klicken Sie auf der Symbolleiste auf Speichern (Speichern), um das Skript zu speichern. Klicken Sie auf OK, um die Informationsmeldung zu schließen.
    Informationsmeldung, die bestätigt, dass die Regel gespeichert wurde
  7. Klicken Sie auf Validieren und Bereitstellen (Validieren und bereitstellen). Klicken Sie auf OK, um die Informationsmeldung zu schließen.
    Deployment-Nachricht zur Bestätigung des erfolgreichen Deployments
  8. Lassen Sie Calculation Manager geöffnet, und kehren Sie zum Planning-Browserfenster zurück.

Regel zu einem Eingabeformular hinzufügen

  1. Klicken Sie auf der Planning-Homepage auf Daten. Klicken Sie auf EmployeeDriverForm, um das Eingabeformular zu öffnen.
    EmployeeDriverForm mit den ursprünglichen Daten öffnen
  2. Klicken Sie auf Aktionen, und wählen Sie Bearbeiten aus.
    Menü "Aktionen" mit ausgewählter Option "Bearbeiten"
  3. Wählen Sie die Registerkarte Geschäftsregeln.
  4. Fügen Sie Groovy Set-Hintergrundfarbe zu den ausgewählten Geschäftsregeln hinzu.
    Registerkarte "Geschäftsregeln" mit der Groovy-Regel in "Ausgewählte Geschäftsregeln"
  5. Wählen Sie unter "Geschäftsregeleigenschaften" die Option Nach Laden ausführen aus.
    Geschäftsregeleigenschaften mit ausgewählter Option "Nach Laden ausführen"
  6. Klicken Sie auf Speichern, um die Formulardefinition zu speichern. Klicken Sie auf OK, um die Informationsmeldung zu schließen.
    Informationsmeldung, die bestätigt, dass das Formular gespeichert wurde
  7. Schließen Sie unten auf der Seite die Registerkarte EmployeeDriverForm bearbeiten, um zum Eingabeformular zurückzukehren.
  8. Wenn das Formular neu geladen wird, stellen Sie sicher, dass die fehlenden Zellen blau sind, Werte kleiner/gleich 50000 orange sind und Werte größer als 50000 grün sind.
    Formular mit blauen fehlenden Zellen, orangenen Werten bei oder unter dem Schwellenwert und grünen Werten über dem Schwellenwert neu geladen

Profilerstellung und Debugging des Skripts

In diesem Abschnitt lernen Sie, wie Sie Iteratoren verwenden, die von der DataGrid-Schnittstelle bereitgestellt werden, den Code profilieren und Debugginganweisungen zur Jobkonsole hinzufügen.

Groovy-Skripte erstellen

  1. Kehren Sie zum Fenster {\b Calculation Manager} zurück.
  2. Wählen Sie die Registerkarte Systemansicht. Klicken Sie unter Plan1 mit der rechten Maustaste auf Regeln, und wählen Sie Neu aus.
    Systemansicht, wobei "Neu" im Kontextmenü "Regeln" ausgewählt ist
  3. Geben Sie als Namen Groovy Iterator Performance ein, und klicken Sie auf OK.
    Dialogfeld "Neue Regel" mit eingegebener Groovy Iterator-Performance
  4. Ändern Sie im Regeleditor die Designeroption in Skript bearbeiten, und setzen Sie den Skripttyp auf Groovy-Skript.
    Regeleditor mit ausgewähltem Bearbeitungsskript und Groovy-Skript
  5. Kopieren Sie dieses Skript und fügen Sie es in den Editor hinzu.
    Code reference 1def benchmark(GridIterator itr) {
    Code reference 2    def start = currentTimeMillis()
    Code reference 3    itr.each { println "$it.memberNames, cell data: $it.data, $it.formattedValue" }
        def elapsed = currentTimeMillis() - start
    Code reference 4    println "\nTime taken by iterator: $elapsed"
    }
    
    Code reference 5println "Iterate over all data cells in this data grid...\n"
    Code reference 6benchmark operation.grid.dataCellIterator()
    
    println "Iterate over edited data cells in this data grid...\n"
    Code reference 7benchmark operation.grid.dataCellIterator({DataCell cell -> cell.edited})
    
    println "Iterate over Min Salary and Min Bonus data cells in this data grid...\n"
    Code reference 8benchmark operation.grid.dataCellIterator('Min Salary', 'Min Bonus')
    

    Kodexreferenz 1 Definieren Sie eine Utilitymethode namens benchmark(), die das angegebene GridIterator verwendet, um über seine Zellen zu iterieren und die Liste der Elementnamen aus allen Dimensionen, die in der Zelle dargestellt werden, zusammen mit den zugehörigen Daten ausgibt. Es druckt auch die Zeit, die der Iterator benötigt.

    Kodexreferenz 2 Timer starten.

    Kodexreferenz 3 Wiederholen Sie die Iteration über jede Zelle mit dem angegebenen GridIterator, und geben Sie die Liste der Elementnamen aus allen Dimensionen aus, die in der Zelle dargestellt werden, zusammen mit dem Datenwert und dem formatierten Wert. $it.data gibt den numerischen Wert für die Zelle zurück, und $it.formattedValue gibt nicht numerische Werte zurück, wie Text, Smart List oder Datum, wie vom Benutzer eingegeben.

    Kodexreferenz 4 Drucken Sie die vom Iterator benötigte Zeit in die Jobkonsole.

    Kodexreferenz 5 Debugging-Meldung in Jobkonsole protokollieren

    Kodexreferenz 6 Rufen Sie die Methode benchmark() mit einem Iterator auf, um über jede Zelle im aktuellen Datenraster zu iterieren.

    Kodexreferenz 7 Rufen Sie die Methode benchmark() mit einem Iterator auf, um über die bearbeiteten Zellen im aktuellen Datenraster zu iterieren.

    Tipp:

    Dieser Iterator kann mit jeder Eigenschaft im Objekt DataCell verwendet werden, die einen booleschen Wert zurückgibt, z.B. gesperrt, fehlt, gültig, readOnly, validIntersection usw.

    Kodexreferenz 8 Rufen Sie die Methode benchmark() mit einem Iterator auf, um über die Datenzellen "Min. Gehalt" und "Min. Bonus" im aktuellen Datenraster zu iterieren.

  6. Klicken Sie auf der Symbolleiste auf Speichern (Speichern), um das Skript zu speichern. Klicken Sie auf OK, um die Informationsmeldung zu schließen.
    Informationsmeldung, die bestätigt, dass Groovy Iterator Performance gespeichert ist
  7. Klicken Sie auf Validieren und Bereitstellen (Validieren und bereitstellen). Klicken Sie auf OK, um die Informationsmeldung zu schließen.
    Meldung zur Bestätigung des erfolgreichen Deployments
  8. Lassen Sie Calculation Manager geöffnet, und kehren Sie zum Planning-Browserfenster zurück.

Regel zu einem Eingabeformular hinzufügen

  1. Klicken Sie im Formular EmployeeDriverForm auf Aktionen, und wählen Sie Bearbeiten aus.
    Menü "Aktionen" mit ausgewählter Option "Bearbeiten"
  2. Wählen Sie die Registerkarte Geschäftsregeln, und fügen Sie den ausgewählten Geschäftsregeln Groovy Iterator-Performance hinzu.
    Registerkarte "Geschäftsregeln" mit hinzugefügter Groovy Iterator-Performance für ausgewählte Geschäftsregeln
  3. Wählen Sie unter "Geschäftsregeleigenschaften" für die Groovy Iterator Performance-Regel die Option Nach Speichern ausführen aus.
    Groovy Iterator-Performance nach Speichern konfiguriert
  4. Klicken Sie auf Speichern, um die Formulardefinition zu speichern. Klicken Sie auf OK, um die Informationsmeldung zu schließen.
    Informationsmeldung, die bestätigt, dass das Formular gespeichert wurde
  5. Schließen Sie unten auf der Seite die Registerkarte EmployeeDriverForm bearbeiten, um zum Eingabeformular zurückzukehren.

Groovy-Skript testen

  1. Ändern Sie unter EmployeeDriverForm das Mindestgehalt für die Gehaltsgruppe 1 in 35000 und den Mindestbonus für die Gehaltsgruppe 2 in 2000.
    EmployeeDriverForm mit zwei bearbeiteten Zellen für FY26
  2. Klicken Sie auf Speichern. Die Groovy Iterator Performance-Regel wird ausgeführt, nachdem die Daten gespeichert wurden. Klicken Sie auf OK, um die Informationsmeldung zu schließen.
    Informationsmeldung, die bestätigt, dass Daten gespeichert und Regeln erfolgreich ausgeführt wurden
  3. Klicken Sie auf Navigator (Navigator), und klicken Sie unter "Anwendung" auf Jobs, um die Jobkonsole zu öffnen.
    Jobkonsole mit abgeschlossenem Groovy Iterator Performance-Job
  4. Klicken Sie auf Groovy-Iteratorperformance, um die Jobdetails anzuzeigen. Blenden Sie unter "Ausführungsstatus" die Option Abgeschlossen ein, um die Logmeldungen anzuzeigen, die vom Groovy-Skript gedruckt werden.
    Abgeschlossene Jobdetails mit Iteratorlogmeldungen

    Der erste Iterator druckt alle Zellen und die Datenwerte, der zweite Iterator druckt nur die beiden Zellen, die bearbeitet wurden, und der dritte Iterator druckt nur die Zellen für die Spalten "Min. Gehalt" und "Min. Bonus".

  5. Schließen Sie die Jobdetails.
  6. Klicken Sie auf Navigator (Navigator), und wählen Sie Daten aus, um zum EmployeeDriverForm zurückzukehren.

Standarddatenwerte festlegen

In diesem Abschnitt erfahren Sie, wie Sie die Standarddatenwerte im Raster mit der Schnittstelle DataGridBuilder festlegen.

Erstellen eines Groovy-Skripts

  1. Kehren Sie zum Fenster {\b Calculation Manager} zurück.
  2. Wählen Sie die Registerkarte Systemansicht. Klicken Sie unter Plan1 mit der rechten Maustaste auf Regeln, und wählen Sie Neu aus.
    Systemansicht, wobei "Neu" im Kontextmenü "Regeln" ausgewählt ist
  3. Geben Sie als Namen Groovy Reset Grade Data ein, und klicken Sie auf OK.
    Dialogfeld "Neue Regel" mit eingegebenen Groovy-Neustufungsgruppendaten
  4. Ändern Sie im Regeleditor die Designeroption in Skript bearbeiten, und setzen Sie den Skripttyp auf Groovy-Skript.
    Regeleditor mit ausgewähltem Bearbeitungsskript und Groovy-Skript
  5. Kopieren Sie dieses Skript und fügen Sie es in den Editor hinzu.
    Code reference 1Cube cube = operation.application.getCube("Plan1")
    String currentYear = operation.application.getSubstitutionVariableValue("OEP_CurYr")
    
    Code reference 2DataGridBuilder builder = cube.dataGridBuilder("MM/DD/YYYY")
    Code reference 3builder.addPov(currentYear, 'Current', 'USD', 'BegBalance', 'BU Version_1', 'No Entity')
    builder.addColumn('Min Salary', 'Max Salary', 'Min Bonus', 'Max Bonus')
    builder.addRow(['Grade 1'], [30000, 50000, '#missing', '#missing'])
    builder.addRow(['Grade 2'], [40000, 60000, '#missing', 5000])
    builder.addRow(['Grade 3'], [70000, 90000, '#missing', 10000])
    
    Code reference 4DataGridBuilder.Status status = new DataGridBuilder.Status()
    Code reference 5builder.build(status).withCloseable { DataGrid grid ->
    Code reference 6    println("Total number of cells accepted: $status.numAcceptedCells")
        println("Total number of cells rejected: $status.numRejectedCells")
        println("First 100 rejected cells: $status.cellsRejected")
    Code reference 7    cube.saveGrid(grid)
    Code reference 8}
    

    Kodexreferenz 1 Erstellen Sie ein Cube-Objekt für den Cube Plan1, und lesen Sie das aktuelle Jahr aus der Substitutionsvariable auf Anwendungsebene. getSubstitutionVariableValue("OEP_CurYr") liest die Substitutionsvariable auf Anwendungsebene ohne Et-Zeichen. Im angegebenen Snapshot lautet der Wert FY26.

    Kodexreferenz 2 Ruft eine DataGridBuilder für den Cube ab. Definieren Sie das Format, in dem das Skript die Datumswerte bereitstellt.

    Hinweis:

    Die DataGridBuilder unterstützt auch das Speichern von Daten im Namen eines Systembenutzers, indem ExecuteAsUser als zweiter Parameter akzeptiert wird. Wenn Sie Daten als Systembenutzer speichern, können Daten gespeichert werden, ohne die Sicherheit des aktuellen Benutzers anzuwenden. Gültige Werte für ExecuteAsUser sind CURRENT_USER (Standard) und SYSTEM_USER, wie im folgenden Beispiel dargestellt:

    DataGridBuilder builder = cube.dataGridBuilder("MM/DD/YYYY", SYSTEM_USER)

    Kodexreferenz 3 Erstellen Sie ein Datenraster, indem Sie die POV-Elemente, Spaltenelemente und Zeilen mit Datenwerten hinzufügen. Wenn Sie currentYear an addPov übergeben, wird die Rücksetzungsregel an das Formular ausgerichtet, ohne dass ein Jahr hartcodiert wird.

    Kodexreferenz 4 Erstellen Sie ein Statusobjekt für das Objekt DataGrid, das im nächsten Schritt erstellt wurde.

    Kodexreferenz 5 Erstellen Sie das Objekt DataGrid mit dem Konstrukt withCloseable. Es schließt das Raster, wenn der Block abgeschlossen ist, sodass die Regel das Raster nicht im Speicher offen lässt.

    Kodexreferenz 6 Drucken Sie die Anzahl der Zellen, die vom Builder akzeptiert oder abgelehnt wurden, in die Jobkonsole. Schreibgeschützte Zellen werden abgelehnt.

    Kodexreferenz 7 Speichern Sie das Daten-Grid.

    Kodexreferenz 8 Das Raster wird automatisch geschlossen.

  6. Klicken Sie auf der Symbolleiste auf Speichern (Speichern), um das Skript zu speichern. Klicken Sie auf OK, um die Informationsmeldung zu schließen.
    Informationsmeldung, die bestätigt, dass Groovy QK-Stufen-Daten zurückgesetzt wurde
  7. Klicken Sie auf Validieren und Bereitstellen (Validieren und bereitstellen). Klicken Sie auf OK, um die Informationsmeldung zu schließen.
    Meldung zur Bestätigung des erfolgreichen Deployments
  8. Schließen Sie Calculation Manager, und kehren Sie zum Planning-Browserfenster zurück.

Regel zu einem Eingabeformular hinzufügen

  1. Klicken Sie in der EmployeeDriverForm auf Aktionen, und wählen Sie Bearbeiten aus.
    Menü "Aktionen" mit ausgewählter Option "Bearbeiten"
  2. Wählen Sie die Registerkarte Geschäftsregeln.
  3. Fügen Sie Groovy Reset Grade Data zu den ausgewählten Geschäftsregeln hinzu.
    Registerkarte "Geschäftsregeln" mit Groovy zum Zurücksetzen von Gehaltsgruppendaten in ausgewählten Geschäftsregeln
  4. Lassen Sie unter "Geschäftsregeleigenschaften" für die Groovy-Regel "Gehaltsgruppendaten zurücksetzen" die Optionen Vor Laden ausführen, Nach Laden ausführen, Vor Speichern ausführen und Nach Speichern ausführen deaktiviert, damit Sie sie manuell starten können.
    Groovy Reset Grade Data mit allen automatischen Lade- und Speicheroptionen gelöscht
  5. Klicken Sie auf Speichern, um die Formulardefinition zu speichern, und klicken Sie dann auf OK, um die Informationsmeldung zu schließen.
    Informationsmeldung, die bestätigt, dass das Formular gespeichert wurde
  6. Schließen Sie unten auf der Seite die Registerkarte EmployeeDriverForm bearbeiten, um zum Eingabeformular zurückzukehren.

Groovy-Skript testen

  1. Klicken Sie auf Aktionen, und wählen Sie Regeln und Smart Push aus.
    Menü "Aktionen" mit ausgewählten Regeln und Smart Push
  2. Wählen Sie unter "Regeln" die Option Gruppendaten zurücksetzen aus, um die Regel zu starten.
    Regelliste mit ausgewählten Groovy-Graddaten zurücksetzen
  3. Wenn die Regel erfolgreich abgeschlossen wurde, klicken Sie auf OK, um die Informationsmeldung zu schließen.
    Informationsmeldung, die bestätigt, dass Groovy die Gehaltsgruppendaten erfolgreich zurückgesetzt hat
  4. Prüfen Sie, ob die Rasterdaten auf die folgenden Werte zurückgesetzt wurden.
    FY26 EmployeeDriverForm mit wiederhergestellten Standardgehältern und Bonuswerten
    GehaltsgruppeMin. GehaltMax. GehaltMin. BonusMax. Bonus
    Gehaltsgruppe 130.00050.000FehlendFehlend
    Gehaltsgruppe 240.00060.000Fehlend5.000
    Gehaltsgruppe 370.00090.000Fehlend10.000
  5. Klicken Sie auf Navigator (Navigator), und klicken Sie unter "Anwendung" auf Jobs, um die Jobkonsole zu öffnen.
    Jobkonsole mit abgeschlossenem Groovy-Job "Gehaltsgruppendaten zurücksetzen"
  6. Klicken Sie auf Groovy - Gehaltsgruppendaten zurücksetzen, um die Tätigkeitsdetails anzuzeigen. Blenden Sie unter "Ausführungsstatus" die Option Abgeschlossen ein, um die Anzahl der akzeptierten und abgelehnten Zellen anzuzeigen.
    Groovy hat Jobdetails zum Zurücksetzen von Gehaltsgruppendaten mit akzeptierter und abgelehnter Zellenanzahl abgeschlossen

Weitere Lernressourcen

Sehen Sie sich weitere Übungen zu docs.oracle.com/learn an, oder greifen Sie auf weitere kostenlose Lerninhalte im Oracle Learning YouTube-Kanal zu. Besuchen Sie außerdem Oracle University, um verfügbare Schulungsressourcen anzuzeigen.

Die Produktdokumentation finden Sie im Oracle Help Center.