Introduzione

Questa esercitazione descrive come implementare gli script Groovy per utilizzare le griglie di dati e i rispettivi iteratori. È possibile utilizzare la logica condizionale per impostare i colori di sfondo in una griglia dati, implementare il benchmark delle prestazioni e impostare i valori di dati predefiniti in una griglia. Completare le sezioni in ordine.

Presupposto

Un'interfaccia della griglia dati fornisce l'accesso alle celle di intestazione punto di vista/riga/colonna e fornisce vari iteratori da iterare sulle celle dati.

Prerequisiti

Le esercitazioni pratiche su Cloud EPM potrebbero richiedere l'importazione di uno snapshot in un'istanza di Cloud EPM Enterprise Service. Impossibile importare uno snapshot su un'applicazione o un processo aziendale esistente. Prima di importare lo snapshot, utilizzare un'istanza separata di Cloud EPM Enterprise Service o rimuovere l'applicazione o il processo aziendale esistente dall'istanza che si prevede di utilizzare. L'importazione dello snapshot non sostituisce o ripristina automaticamente il contenuto esistente.

Prima di iniziare questo tutorial, è necessario:

  • Consente all'amministratore dei servizi di accedere a un'istanza di Cloud EPM Enterprise Service. Per l'istanza non deve essere stato creato un processo aziendale.
  • Caricare e importare questo snapshot nell'istanza. Questo snapshot richiede il processo aziendale di pianificazione. Se lo snapshot è già stato importato per un'altra esercitazione Groovy, è possibile continuare a utilizzare l'applicazione senza importare di nuovo lo snapshot.

Nota

Se si verificano errori di migrazione durante l'importazione dello snapshot, eseguire di nuovo la migrazione escludendo il componente HSS-Shared Services e gli artifact delle preferenze di sicurezza e utente nel componente Core. Per ulteriori informazioni sul caricamento e l'importazione degli snapshot, fare riferimento alla documentazione Amministrazione della migrazione per Oracle Enterprise Performance Management Cloud.

Suggerimento

Gli script necessari per questa esercitazione sono collegati come file di testo all'interno di ciascuna sezione.

Impostazione del colore di sfondo mediante la logica condizionale

In questa sezione, si implementa uno script Groovy per impostare il colore di sfondo per le celle con valore dati #MISSING su █ (0x00BFFF), le celle con valore dati minore o uguale a 50000 per il colore █ (0xFF8C00) e le celle con valori dati maggiori di 50000 per il colore █ (0x00FA9A).

Nota

Dopo aver definito uno script Groovy, può essere associato a qualsiasi modulo, a differenza delle regole di convalida dei dati, che devono essere definite nel contesto di ogni modulo.

Creazione di uno script Groovy

  1. Nella home page di Planning fare clic su Navigator (Navigator), quindi in Crea e gestisci fare clic su Regole per aprire Gestione calcoli.
    Navigator con regole in Creazione e gestione
  2. Nella scheda Vista sistema, espandere EPM Cloud, HP4, quindi Plan1. fare clic con il pulsante destro del mouse su Regole, quindi selezionare Nuovo.
    Vista sistema con menu di scelta rapida Regole e nuova selezione
  3. Per Nome, immettere Groovy Set Background Color, quindi fare clic su OK.
    Finestra di dialogo Nuova regola con nome regola, applicazione e cubo
  4. Nell'Editor regole, modificare l'opzione Designer in Modifica script e impostare il tipo di script su Script Groovy.
    Editor regole con script di modifica e script Groovy selezionato
  5. Copiare lo script e incollarlo nell'editor.
    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
    }
    

    Riferimento codice 1 Lo script esegue l'iterazione su ogni cella di dati nella griglia dati corrente, operation.grid, restituita da dataCellIterator.

    La variabile it implicita fa riferimento all'elemento corrente di cui si esegue l'iterazione. In questo caso la variabile it si riferisce alla cella di dati corrente restituita da dataCellIterator.

    Suggerimento

    È inoltre possibile utilizzare una variabile denominata in modo esplicito, ad esempio cell, come mostrato nell'esempio seguente:
     operation.grid.dataCellIterator.each { cell ->
        if(cell.missing) {
          cell.bgColor = 0x00BFFF
        }
    }

    Riferimento codice 2 Per la cella dati corrente, lo script verifica la presenza di un valore mancante.

    Nota

    Si noti che cell.data restituisce 0 (zero) per le celle #MISSING o zero. Per controllare una cella per #MISSING e non per zero, è possibile utilizzare la proprietà cell.missing. Per controllare il valore zero di una cella e non #MISSING, è possibile utilizzare una condizione come cell.data == 0 && !cell.missing.

    Riferimento codice 3 Se TRUE, lo script imposta il colore di sfondo della cella su 0x00BFFF( █ )

    Riferimento codice 4 Lo script verifica che il valore dei dati sia minore o uguale a 50000.

    Riferimento codice 5 Se TRUE, lo script imposta il colore di sfondo della cella su 0xFF8C00 ( █ )

    Riferimento codice 6 Se il valore dei dati della cella è superiore a 50000, lo script imposta il colore di sfondo della cella su 0x00FA9A ( █ )

  6. Sulla barra degli strumenti, fare clic su Salva (Salva) per salvare lo script. Fare clic su OK per chiudere il messaggio informativo.
    Messaggio informativo che conferma il salvataggio della regola
  7. Fare clic su Convalida e distribuisci (Convalida e distribuisci). Fare clic su OK per chiudere il messaggio informativo.
    Messaggio di distribuzione che conferma la distribuzione riuscita
  8. Lasciare aperto Gestione calcoli e tornare alla finestra del browser Pianificazione.

Aggiunta della regola a un form dati

  1. Nella home page Pianificazione, fare clic su Dati. Fare clic su EmployeeDriverForm per aprire il form dati.
    EmployeeDriverForm aperto con i dati iniziali
  2. Fare clic su Azioni, quindi selezionare Modifica.
    Menu Azioni con Modifica selezionata
  3. Selezionare la scheda Business Rules.
  4. Aggiungere Colore sfondo set di griglie alle regole business selezionate.
    Scheda Regole business con la regola Groovy nelle regole business selezionate
  5. In Proprietà regola business selezionare Esegui dopo caricamento.
    Proprietà regola business con l'opzione Esegui dopo caricamento selezionata
  6. Fare clic su Salva per salvare la definizione del form. Fare clic su OK per chiudere il messaggio informativo.
    Messaggio informativo che conferma il salvataggio del modulo
  7. Nella parte inferiore della pagina, chiudere la scheda Modifica EmployeeDriverForm per tornare al form dati.
  8. Quando il form viene ricaricato, verificare che le celle mancanti siano di colore blu, che i valori minori o uguali a 50000 siano di colore arancione e che i valori maggiori di 50000 siano di colore verde.
    Forma ricaricata con celle mancanti di colore blu, valori arancioni al di sotto della soglia e valori verdi al di sopra della soglia

Creazione di profili e debug dello script

In questa sezione viene descritto come utilizzare gli iteratori forniti dall'interfaccia DataGrid, profilare il codice e aggiungere istruzioni di debug alla console job.

Creazione di uno script Groovy

  1. Tornare alla finestra Gestione calcoli.
  2. Selezionare la scheda Vista sistema. In Plan1 fare clic con il pulsante destro sul pulsante Regole, quindi selezionare Nuovo.
    Vista sistema con nuovo selezionato nel menu di scelta rapida Regole
  3. Per Nome, immettere Groovy Iterator Performance, quindi fare clic su OK.
    È stata immessa una nuova finestra di dialogo Regola con le prestazioni dell'iteratore Groovy
  4. Nell'Editor regole, modificare l'opzione Designer in Modifica script e impostare il tipo di script su Script Groovy.
    Editor regole con script di modifica e script Groovy selezionato
  5. Copiare lo script e incollarlo nell'editor.
    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')
    

    Riferimento codice 1 Definire un metodo di utility denominato benchmark() che utilizza il valore GridIterator specificato per eseguire l'iterazione sulle celle e visualizza l'elenco dei nomi dei membri di tutte le dimensioni rappresentate dalla cella insieme ai relativi dati. Stampa anche il tempo impiegato dall'iteratore.

    Riferimento codice 2 Avviare un timer.

    Riferimento codice 3 Eseguire l'iterazione su ogni cella utilizzando il valore GridIterator specificato e stampare l'elenco dei nomi dei membri da tutte le dimensioni rappresentate dalla cella insieme al relativo valore dati e al valore formattato. $it.data restituisce il valore numerico per la cella e $it.formattedValue restituisce valori non numerici quali Testo, Smart List o Data immessi dall'utente.

    Riferimento codice 4 Stampare il tempo impiegato dall'iteratore nella console job.

    Riferimento codice 5 Registra un messaggio di debug nella console job.

    Riferimento codice 6 Richiamare il metodo benchmark() con un iteratore per eseguire l'iterazione su ogni cella della griglia dati corrente.

    Riferimento codice 7 Chiamare il metodo benchmark() con un iteratore per eseguire l'iterazione sulle celle modificate nella griglia dati corrente.

    Suggerimento

    Questo iteratore può essere utilizzato con qualsiasi proprietà dell'oggetto DataCell che restituisce un valore booleano, ad esempio bloccato, mancante, valido, readOnly, validIntersection e così via.

    Riferimento codice 8 Richiamare il metodo benchmark() con un iteratore per eseguire l'iterazione sulle celle dati Stipendio minimo e Bonus minimo nella griglia dati corrente.

  6. Sulla barra degli strumenti, fare clic su Salva (Salva) per salvare lo script. Fare clic su OK per chiudere il messaggio informativo.
    Messaggio informativo che conferma il salvataggio delle prestazioni dell'iteratore Groovy
  7. Fare clic su Convalida e distribuisci (Convalida e distribuisci). Fare clic su OK per chiudere il messaggio informativo.
    Messaggio di conferma della distribuzione riuscita
  8. Lasciare aperto Gestione calcoli e tornare alla finestra del browser Pianificazione.

Aggiunta della regola a un form dati

  1. Nel form EmployeeDriverForm fare clic su Azioni, quindi selezionare Modifica.
    Menu Azioni con Modifica selezionata
  2. Selezionare la scheda Regole business, quindi aggiungere Prestazioni iteratore Groovy alle regole business selezionate.
    Scheda Regole business con prestazioni dell'iteratore Groovy aggiunte alle regole business selezionate
  3. In Proprietà regola business, per la regola Prestazioni iteratore Groovy selezionare Esegui dopo il salvataggio.
    Prestazioni iteratore Groovy configurate per l'esecuzione dopo il salvataggio
  4. Fare clic su Salva per salvare la definizione del form. Fare clic su OK per chiudere il messaggio informativo.
    Messaggio informativo che conferma il salvataggio del modulo
  5. Nella parte inferiore della pagina, chiudere la scheda Modifica EmployeeDriverForm per tornare al form dati.

Test dello script Groovy

  1. In EmployeeDriverForm, modificare Stipendio minimo per il livello 1 in 35000 e Bonus minimo per il livello 2 in 2000.
    EmployeeDriverForm con due celle modificate per FY26
  2. Fare clic su Salva. La regola Prestazioni iteratore Groovy viene eseguita dopo il salvataggio dei dati. Fare clic su OK per chiudere il messaggio informativo.
    Messaggio informativo che conferma il salvataggio dei dati e l'esecuzione delle regole riuscita
  3. Fare clic su Navigator (Navigator), quindi, in Applicazione, fare clic su Job per aprire la Console job.
    Console job con il job Prestazioni iteratore Groovy completato
  4. Fare clic su Prestazioni iteratore Groovy per visualizzare i dettagli del job. In Stato esecuzione, espandere Completato per visualizzare i messaggi di log stampati dallo script Groovy.
    Dettagli del job completato che mostrano i messaggi di log dell'iteratore

    Il primo iteratore stampa tutte le celle e i valori dei dati, il secondo iteratore stampa solo le due celle modificate e il terzo iteratore stampa solo le celle per le colonne Stipendio minimo e Bonus minimo.

  5. Chiudere i dettagli job.
  6. Fare clic su Navigator (Navigator), quindi selezionare Dati per tornare a EmployeeDriverForm.

Impostazione dei valori dei dati predefiniti

In questa sezione viene descritto come impostare i valori dei dati predefiniti nella griglia utilizzando l'interfaccia DataGridBuilder.

Creazione di uno script Groovy

  1. Tornare alla finestra Gestione calcoli.
  2. Selezionare la scheda Vista sistema. In Plan1, fare clic con il pulsante destro sul pulsante Regole, quindi selezionare Nuovo.
    Vista sistema con nuovo selezionato nel menu di scelta rapida Regole
  3. Per Nome, immettere Groovy Reset Grade Data, quindi fare clic su OK.
    Finestra di dialogo Nuova regola con Groovy Reimposta dati livello immessi
  4. Nell'Editor regole, modificare l'opzione Designer in Modifica script e impostare il tipo di script su Script Groovy.
    Editor regole con script di modifica e script Groovy selezionato
  5. Copiare lo script e incollarlo nell'editor.
    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}
    

    Riferimento codice 1 Creare un oggetto cubo per il cubo Plan1 e leggere l'anno corrente dalla variabile di sostituzione a livello di applicazione. getSubstitutionVariableValue("OEP_CurYr") legge la variabile di sostituzione a livello di applicazione senza una e commerciale. Nell'istantanea fornita, il suo valore è FY26.

    Riferimento codice 2 Ottenere un valore DataGridBuilder per il cubo; definire il formato in cui lo script fornisce i valori di data.

    Nota

    DataGridBuilder supporta anche il salvataggio dei dati per conto di un utente di sistema accettando ExecuteAsUser come secondo parametro. Il salvataggio dei dati come utente di sistema consente di salvare i dati senza applicare la sicurezza dell'utente corrente. I valori validi per ExecuteAsUser sono CURRENT_USER (impostazione predefinita) e SYSTEM_USER, come nell'esempio seguente:

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

    Riferimento codice 3 Creare una griglia dati aggiungendo i membri POV, i membri colonna e le righe con valori dati. Il passaggio di currentYear a addPov mantiene la regola di reimpostazione allineata al modulo senza la codifica forzata di un anno.

    Riferimento codice 4 Creare un oggetto di stato per l'oggetto DataGrid creato nel passo successivo.

    Riferimento codice 5 Costruire l'oggetto DataGrid con il costrutto withCloseable. Chiude la griglia al completamento del blocco, quindi la regola non lascia la griglia aperta in memoria.

    Riferimento codice 6 Stampa il numero di celle accettate o rifiutate dal builder nella console job. Tutte le celle di sola lettura vengono rifiutate.

    Riferimento codice 7 Salvare la griglia dati.

    Riferimento codice 8 La griglia viene chiusa automaticamente.

  6. Sulla barra degli strumenti, fare clic su Salva (Salva) per salvare lo script. Fare clic su OK per chiudere il messaggio informativo.
    Messaggio informativo che conferma il salvataggio dei dati Groovy Reset Grade
  7. Fare clic su Convalida e distribuisci (Convalida e distribuisci). Fare clic su OK per chiudere il messaggio informativo.
    Messaggio di conferma della distribuzione riuscita
  8. Chiudere Calculation Manager e tornare alla finestra del browser Planning.

Aggiunta della regola a un form dati

  1. In EmployeeDriverForm, fare clic su Azioni, quindi selezionare Modifica.
    Menu Azioni con Modifica selezionata
  2. Selezionare la scheda Business Rules.
  3. Aggiungere Dati livello reimpostazione Groovy alle regole business selezionate.
    Scheda Regole business con reimpostazione Groovy dei dati livello nelle regole business selezionate
  4. In Proprietà regola business, per la regola di reimpostazione dei dati di livello Groovy, lasciare deselezionati Esegui prima del caricamento, Esegui dopo il caricamento, Esegui prima del salvataggio e Esegui dopo il salvataggio in modo da poterlo avviare manualmente.
    Ripristina i dati di livello Groovy con tutte le opzioni di caricamento e salvataggio automatici cancellate
  5. Fare clic su Salva per salvare la definizione del form, quindi fare clic su OK per chiudere il messaggio informativo.
    Messaggio informativo che conferma il salvataggio del modulo
  6. Nella parte inferiore della pagina, chiudere la scheda Modifica EmployeeDriverForm per tornare al form dati.

Test dello script Groovy

  1. Fare clic su Azioni, quindi selezionare Regole e Smart Push.
    Menu Azioni con regole e Smart Push selezionati
  2. In Regole selezionare Reimposta dati livello Groovy per avviare la regola.
    Lista di regole con i dati di livello reimpostati Groovy selezionati
  3. Al completamento della regola, fare clic su OK per chiudere il messaggio informativo.
    Messaggio informativo che conferma che l'esecuzione di Groovy Reset Grade Data è riuscita
  4. Verificare che i dati della griglia siano stati reimpostati sui valori seguenti.
    FY26 EmployeeDriverForm con i valori predefiniti di stipendio e bonus ripristinati
    LivelloStipendio minimoStipendio massimoBonus minimoBonus massimo
    Livello 130.00050.000MancanteMancante
    Livello 240.00060.000Mancante5.000
    Livello 370.00090.000Mancante10.000
  5. Fare clic su Navigator (Navigator), quindi, in Applicazione, fare clic su Job per aprire la Console job.
    Console job con il job Groovy Reset Grade Data completato
  6. Fare clic su Ripristina dati livello Groovy per visualizzare i dettagli del job. In Stato esecuzione, espandere Completato per visualizzare i numeri di celle accettate e rifiutate.
    Dettagli del job Reimposta dati livello Groovy completati con conteggi di celle accettati e rifiutati

Altre risorse di apprendimento

Esplora altri laboratori su docs.oracle.com/learn o accedi a più contenuti di formazione gratuiti sul canale YouTube di Oracle Learning. Inoltre, visita Oracle University per visualizzare le risorse di formazione disponibili.

Per la documentazione del prodotto, visitare Oracle Help Center.