Introdução

Este tutorial apresenta a linguagem de script Groovy e mostra como criar um script Groovy para o Planning no serviço Oracle EPM Enterprise Cloud.

Histórico

O Groovy é uma linguagem ágil e dinâmica para a plataforma Java que combina integração Java suave com os benefícios do desempenho Java. Muitos recursos do Groovy são inspirados em linguagens como Python, Ruby e Smalltalk, tornando-os disponíveis para desenvolvedores Java usando uma sintaxe semelhante a Java. O Groovy foi adotado por muitas grandes e pequenas empresas, incluindo Oracle, IBM e SAP, por seus recursos avançados de linguagem estática e dinâmica, segurança para ambientes de nuvem e linguagens específicas de domínio.

Pré-requisitos

Os Tutoriais Práticos do Cloud EPM podem exigir que você importe um instantâneo para sua instância do Cloud EPM Enterprise Service. Para poder importar um instantâneo de tutorial, você deve solicitar outra instância do Cloud EPM Enterprise Service ou remover seu aplicativo e processo de negócios atuais. O instantâneo do tutorial não será importado sobre seu aplicativo ou processo de negócios existente, nem substituirá ou restaurará automaticamente o aplicativo ou processo de negócios com o qual você está trabalhando no momento.

Antes de iniciar este tutorial, você deve:

  • Tenha acesso do Administrador de Serviço a uma instância do Cloud EPM Enterprise Service.
  • Faça upload e importe este instantâneo para sua instância do Planning.

Observação:

Se você encontrar erros de migração importando o snapshot, execute novamente a migração excluindo o componente HSS-Shared Services, bem como os artefatos Segurança e Preferências do Usuário no componente Principal. Para obter mais informações sobre upload e importação de snapshots, consulte a documentação Administrando a Migração para o Oracle Enterprise Performance Management Cloud.

Por que Groovy?

Compreender as limitações dos scripts de cálculo

O Planning usa regras de negócios baseadas em script de cálculo para executar cálculos e ações. Embora esses scripts sejam poderosos, eles têm algumas limitações:

  • Não é possível gerar scripts dinamicamente no runtime com base em contextos diferentes dos prompts de tempo de execução informados pelo usuário. Por exemplo, se você alterar algumas células em um formulário, uma regra de negócios de script de cálculo não terá como identificar quais dados foram alterados e, em seguida, calcular com base apenas nesses dados.
  • Não é possível especificar dinamicamente o pai de um membro atual (por exemplo, por tipo de projeto ou região).
  • Não é possível validar os dados informados pelo usuário ou os valores de solicitação de tempo de execução antes da execução do cálculo.
  • Não é possível combinar várias funções do EPM em uma única regra ou conjunto de regras (por exemplo, executar automaticamente uma operação de Envio Inteligente após o cálculo).
  • Eles podem apresentar problemas de desempenho devido à sua natureza estática (por exemplo, exigindo um cálculo de uma grande parte do banco de dados, mesmo quando apenas algumas células foram atualizadas).
  • Embora cálculos específicos de contexto limitados estejam disponíveis em formulários clicando com o botão direito do mouse e calculando apenas uma linha específica, essa opção é menos útil para formulários grandes ou onde você atualiza células em várias linhas.
  • Para aplicativos ASO, eles fornecem apenas cálculos simples.

Benefícios das regras de script Groovy

Com suporte para regras Groovy no Oracle EPM Enterprise Cloud, você pode resolver todos esses problemas. As regras Groovy permitem:

  • Gere dinamicamente scripts de cálculo no tempo de execução com base nos contextos definidos no script Groovy
  • Adicione verificações de validação para valores de solicitação de tempo de execução antes de executar cálculos, adicione verificações de validação de dados antes de enviar dados e adicione tratamento de erros
  • Iniciar várias funções do EPM com uma única regra (por exemplo, executar um cálculo e, em seguida, executar uma operação de Envio Inteligente para mover dados calculados para um cubo de relatório)
  • Melhorar o desempenho criando cálculos focados (por exemplo, criando dinamicamente scripts de cálculo direcionados personalizados com base em quais dados foram modificados no formulário atual)
  • Executar cálculos procedurais complexos na memória antes de enviar os resultados ao banco de dados

Groovy no Oracle EPM Enterprise Cloud

Tipos de regras Groovy

O sistema Oracle suporta dois tipos de regras Groovy:

  1. As regras que podem gerar scripts de cálculo dinamicamente em tempo de execução com base em contextos diferentes das solicitações em tempo de execução e retornar o script de cálculo que será executado no Oracle Essbase.

    Por exemplo, você poderia calcular despesas para projetos somente durante o período do projeto (datas de início e de término).

    Outro exemplo é um cálculo baseado em tendência que restringe o cálculo às contas disponíveis no formulário. Você poderia usar esse cálculo para vários formulários em Receita, Despesa, Balanço Patrimonial e Fluxo de Caixa. Isso permite otimização e reutilização.

  2. Regras Groovy puras que podem, por exemplo, executar validações de dados e cancelar a operação se os dados inseridos violarem as políticas da empresa.

Observação:

Qualquer script Groovy que retorne uma string está retornando um script de cálculo do Essbase que será executado no cubo do Essbase especificado. Evite usar strings como o valor final da última instrução, a menos que seja um script de cálculos que você deseja executar depois que o script Groovy for iniciado com sucesso.

Você cria regras Groovy no Calculation Manager e pode executá-las em qualquer lugar do aplicativo em que uma regra de negócios possa ser executada.

Uso das APIs de script do EPM Groovy

  • As APIs de script Groovy do EPM permitem que scripts Groovy executem uma variedade de operações em relação ao modelo de objeto do EPM. A maioria dos objetos, como o aplicativo atual, o cubo e a grade, podem ser recuperados da variável de operação. Na maioria dos casos, o ponto de entrada para a API serão métodos na classe base EpmScript ou no objeto Operation.
  • O script base e a operação atual têm um conjunto de variáveis que se aplicam ao script. Por exemplo, se o script fizer referência a uma variável como operation.grid e a grade não existir na operação, quando o script for executado, o sistema interromperá o script e registrará um erro no Console de Jobs. Se o script tiver processamento opcional, como formatar a grade, se ela existir, ele poderá primeiro verificar a existência da grade chamando operation.hasGrid(). Padrões semelhantes estão disponíveis para outros objetos no modelo.
  • Dica:

    Para obter a especificação de API da Plataforma de Script Groovy do EPM, consulte a Referência de API Java do Oracle Enterprise Performance Management Cloud, Regras Groovy

Criando regras de negócios Groovy

O sistema Oracle suporta dois tipos de regras Groovy:

  1. Em um aplicativo do Planning no EPM Enterprise Cloud, abra o navegador e, em Criar e Gerenciar, clique em Regras para exibir o Calculation Manager.
  2. Regras do Navegador
  3. No Calculation Manager, selecione Ações e, em seguida, Novo Objeto. Na caixa de diálogo, selecione um tipo de aplicativo, aplicativo e cubo. Para Tipo de Objeto, selecione Regra. Insira um Nome para a regra, e clique em OK.
  4. Diálogo Novo Objeto
  5. Uma mensagem informando que a regra foi criada e aberta para edição é exibida. Clique em OK para continuar.
  6. Na lista drop-down Designer, selecione Editar Script
  7. Editar Script
  8. Na lista suspensa Tipo de Script, selecione Script do Groovy.
  9. Script do Groovy
  10. Clique em Ícone de Salvar(Salvar). A regra agora é uma regra de negócios baseada em Script Groovy, e você pode usar o editor para desenvolver seu script de acordo com seu caso de uso de negócios. O exemplo a seguir mostra um script Groovy simples no editor que alterará a cor de fundo das células em uma grade de dados, com base em limites numéricos. Você também pode abrir o script para visualizá-lo em uma guia separada.
  11. Amostra de script

Mais Recursos de Aprendizagem

Explore outros laboratórios em docs.oracle.com/learn ou acesse mais conteúdo de aprendizado gratuito no canal do Oracle Learning YouTube. Além disso, acesse a Oracle University para ver os recursos de treinamento disponíveis.

Para obter a documentação do produto, visite o Oracle Help Center.