Introduzione

In questa esercitazione viene illustrato il linguaggio di script Groovy e viene illustrato come creare uno script Groovy per la pianificazione nel servizio Oracle EPM Enterprise Cloud.

Presupposto

Groovy è un linguaggio agile e dinamico per la piattaforma Java che combina una perfetta integrazione Java con i vantaggi delle prestazioni Java. Molte funzionalità di Groovy sono ispirate a linguaggi come Python, Ruby e Smalltalk, rendendole disponibili per gli sviluppatori Java utilizzando una sintassi simile a quella di Java. Groovy è stata adottata da molte grandi e piccole aziende, tra cui Oracle, IBM e SAP, per le sue potenti funzionalità di linguaggio statico e dinamico, la sicurezza per gli ambienti cloud e i linguaggi specifici del dominio.

Prerequisiti

Le esercitazioni pratiche su Cloud EPM potrebbero richiedere l'importazione di uno snapshot nell'istanza di Cloud EPM Enterprise Service. Prima di poter importare uno snapshot dell'esercitazione, è necessario richiedere un'altra istanza di Cloud EPM Enterprise Service o rimuovere l'applicazione e il processo aziendale correnti. Lo snapshot dell'esercitazione non verrà importato nell'applicazione o nel processo aziendale esistente, né sostituirà o ripristinerà automaticamente l'applicazione o il processo aziendale in uso.

Prima di iniziare questo tutorial, è necessario:

  • Consente all'amministratore dei servizi di accedere a un'istanza di Cloud EPM Enterprise Service.
  • Caricare e importare questo snapshot nell'istanza di Planning.

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.

Perché Groovy?

Informazioni sulle limitazioni degli script di calcolo

La pianificazione utilizza regole aziendali basate su script di calcolo per eseguire calcoli e azioni. Sebbene questi script siano potenti, presentano alcune limitazioni:

  • Non sono in grado di generare in modo dinamico script in runtime in base a contesti diversi dai prompt runtime inseriti dall'utente. Ad esempio, se si modificano alcune celle in un form, una regola business dello script di calcolo non consente di identificare quali dati sono stati modificati e quindi di eseguire il calcolo in base solo a tali dati.
  • Impossibile specificare dinamicamente il padre per un membro corrente, ad esempio per tipo di progetto o area.
  • Impossibile convalidare i dati inseriti dall'utente o i valori del prompt ora di esecuzione prima dell'esecuzione del calcolo.
  • Impossibile combinare più funzioni EPM in un'unica regola o set di regole, ad esempio l'esecuzione automatica di un'operazione Smart Push dopo il calcolo.
  • Potrebbero riscontrare problemi di prestazioni a causa della loro natura statica (ad esempio, richiedendo un calcolo di una grande parte del database anche quando sono state aggiornate solo poche celle).
  • Sebbene nei form siano disponibili calcoli limitati specifici del contesto facendo clic con il pulsante destro del mouse e calcolando solo una riga specifica, questa opzione è meno utile per i form di grandi dimensioni o per aggiornare le celle in più righe.
  • Per le applicazioni ASO, forniscono solo calcoli semplici.

Vantaggi delle regole di script Groovy

Con il supporto delle regole Groovy in Oracle EPM Enterprise Cloud, puoi risolvere tutti questi problemi. Le regole Groovy consentono di:

  • Genera dinamicamente script di calcolo in runtime in base ai contesti definiti nello script Groovy
  • Aggiungere controlli di convalida per i valori dei prompt runtime prima di eseguire i calcoli, aggiungere controlli di convalida dei dati prima di sottomettere i dati e aggiungere la gestione degli errori
  • Avviare più funzioni EPM con una singola regola (ad esempio, eseguire un calcolo, quindi eseguire un'operazione Smart Push per spostare i dati calcolati in un cubo di reporting)
  • Migliora le prestazioni creando calcoli mirati (ad esempio, creando in modo dinamico script di calcolo mirati personalizzati in base ai dati modificati nel form corrente)
  • Eseguire calcoli procedurali complessi in memoria prima di sottomettere i risultati al database

Groovy in Oracle EPM Enterprise Cloud

Tipi di regole Groovy

Oracle supporta due tipi di regole Groovy:

  1. Regole che possono generare dinamicamente script di calcolo in fase di esecuzione basati sul contesto, diversi dai prompt runtime, e restituire lo script di calcolo che verrà successivamente eseguito su Oracle Essbase.

    Ad esempio, è possibile creare una regola per calcolare le spese dei progetti unicamente per la durata (date di inizio e di fine) del progetto.

    Un altro esempio è rappresentato dall'andamento basato sul calcolo che limita il calcolo ai conti disponibili nel form. Questo calcolo può essere utilizzato per diversi form in Ricavi, Spese, Bilancio patrimoniale e Flusso di cassa. Ciò consente di ottimizzare e riutilizzare il calcolo.

  2. Regole Groovy pure che, ad esempio, possono eseguire convalide di dati e annullare l'operazione se i dati immessi violano i criteri aziendali.

Nota

Qualsiasi script Groovy che restituisce una stringa restituisce uno script di calcolo Essbase che verrà eseguito in base al cubo Essbase specificato. Evitare l'utilizzo di stringhe come valore finale dell'ultima istruzione, a meno che si tratti di uno script di calcoli che si vuole eseguire dopo l'avvio corretto dello script Groovy.

Le regole Groovy vengono create in Gestione calcoli ed è possibile eseguirle da qualsiasi punto dell'applicazione in cui è possibile eseguire una regola business.

Utilizzo delle API di scripting EPM Groovy

  • Le API di scripting EPM Groovy consentono agli script Groovy di eseguire una vasta gamma di operazioni rispetto al modello a oggetti EPM. La maggior parte degli oggetti, ad esempio l'applicazione, il cubo e la griglia correnti, può essere recuperata dalla variabile operazione. Nella maggior parte dei casi, il punto di accesso all'API sarà metodi nella classe di base EpmScript o nell'oggetto Operation.
  • Lo script di base e l'operazione corrente hanno un insieme di variabili che si applicano allo script. Ad esempio, se lo script fa riferimento a una variabile come operation.grid e la griglia non esiste nell'operazione, quando lo script viene eseguito il sistema arresta lo script e registra un errore nella Console job. Se lo script dispone di un'elaborazione facoltativa, ad esempio la formattazione della griglia, se esiste, può prima verificare l'esistenza della griglia chiamando operation.hasGrid(). Pattern simili sono disponibili per altri oggetti nel modello.

    • Suggerimento

    Per la specifica API della piattaforma di scripting EPM Groovy, fare riferimento a Oracle Enterprise Performance Management Cloud, Groovy Rules Java API Reference

Creazione di regole business Groovy

Oracle supporta due tipi di regole Groovy:

  1. In un'applicazione Planning in EPM Enterprise Cloud aprire il Navigator e in Crea e gestisci fare clic su Regole per visualizzare Gestione calcoli.
    2. Regole Navigator
  2. In Gestione calcoli, selezionare Azioni, quindi Nuovo oggetto. Nella finestra di dialogo selezionare un tipo di applicazione, un'applicazione e un cubo. Per Tipo di oggetto, selezionare Regola. Immettere il nome della regola, quindi fare clic su OK.
    3. Finestra di dialogo Nuovo oggetto
  3. Viene visualizzato un messaggio che indica che la regola è stata creata e aperta per la modifica. Fare clic su OK per continuare.
  4. Nell'elenco a discesa Designer selezionare Modifica script.
    5. Modifica script
  5. Nell'elenco a discesa Tipo script, selezionare Script Groovys.
    6. Script Groovy
  6. Fare clic su Icona Salva(Save). La regola è ora una regola business basata su script Groovy ed è possibile utilizzare l'editor per sviluppare lo script in base al caso d'uso aziendale. Nell'esempio seguente viene mostrato uno script Groovy semplice nell'editor che modificherà il colore di sfondo delle celle in una griglia dati, in base alle soglie numeriche. È inoltre possibile aprire lo script per visualizzarlo in una scheda separata.
    7. Esempio di script

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.