Introdução

Este tutorial mostra como implementar scripts Groovy para trabalhar com grades de Dados e iteradores de grade de Dados. Use a lógica condicional para definir as cores de fundo em uma grade de dados, implementar benchmarking de desempenho e definir valores de dados padrão em uma grade. Complete as seções em ordem.

Histórico

Uma interface de grade de dados fornece acesso às células de cabeçalho PDV/Linha/Coluna e fornece vários iteradores para iteração nas células de dados.

Pré-requisitos

Os Tutoriais Práticos do Cloud EPM podem exigir que você importe um instantâneo para uma instância do Cloud EPM Enterprise Service. Um instantâneo não pode ser importado em um aplicativo ou processo de negócios existente. Antes de importar o instantâneo, use uma instância separada do Cloud EPM Enterprise Service ou remova o aplicativo ou processo de negócios existente da instância que você planeja usar. A importação do snapshot não substitui nem restaura automaticamente o conteúdo existente.

Antes de iniciar este tutorial, você deve:

  • Tenha acesso do Administrador de Serviço a uma instância do Cloud EPM Enterprise Service. A instância não deve ter um processo de negócios criado.
  • Faça upload e importe este snapshot para sua instância. Este instantâneo requer o processo de negócios do Planning. Se você já tiver importado o snapshot para outro tutorial do Groovy, poderá continuar usando esse aplicativo sem importar o snapshot novamente.

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.

Dica:

Os scripts necessários para este tutorial são vinculados como arquivos de texto em cada seção.

Definindo Cor de Fundo Usando Lógica Condicional

Nesta seção, você implementa um script Groovy para definir a cor de fundo para células com valor de dados #MISSING para colorir █ (0x00BFFF), células com valor de dados menor ou igual a 50000 para colorir █ (0xFF8C00) e células com valores de dados maiores que 50000 para colorir █ (0x00FA9A).

Observação:

Depois de definir um script Groovy, ele pode ser associado a qualquer formulário, ao contrário das regras de Validação de Dados, que precisam ser definidas no contexto de cada formulário.

Criando um Script Groovy

  1. Na Home page do Planning, clique em Navegador (Navegador) e, em Criar e Gerenciar, clique em Regras para abrir o Calculation Manager.
    Navigator com Regras em Criar e Gerenciar
  2. Na guia Exibição de Sistema, expanda EPM Cloud, HP4 e Plan1. Clique com o mouse em Regras e selecione Novo.
    Exibição de Sistema com o menu de contexto Regras e Novo selecionado
  3. Para Nome, digite Groovy Set Background Color e clique em OK.
    Caixa de diálogo Nova Regra com o nome da regra, o aplicativo e o cubo
  4. No Editor de Regras, altere a opção Designer para Editar Script e defina o Tipo de Script como Script Groovy.
    Editor de Regras com Script de Edição e Script Groovy selecionados
  5. Copie este script e cole-o no 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
    }
    

    Referência do código 1 O script itera sobre cada célula de dados na grade de dados atual, operation.grid, retornada por dataCellIterator.

    A variável it implícita refere-se ao item atual que está sendo iterado. Nesse caso, a variável it se refere à célula de dados atual retornada por dataCellIterator.

    Dica:

    Você também pode usar uma variável explicitamente nomeada, como cell, conforme mostrado no exemplo abaixo:
     operation.grid.dataCellIterator.each { cell ->
        if(cell.missing) {
          cell.bgColor = 0x00BFFF
        }
    }

    Referência do código 2 Para a célula de dados atual, o script verifica se há um valor ausente.

    Observação:

    Observe que cell.data retorna 0 (zero) para células que são #MISSING ou zero. Para verificar uma célula para #MISSING e não para zero, você pode usar a propriedade cell.missing. Para verificar um valor zero em uma célula e não em #MISSING, você pode usar uma condição como cell.data == 0 && !cell.missing.

    Referência do código 3 Se TRUE, o script define a cor de fundo da célula como 0x00BFFF( █ )

    Referência do código 4 O script verifica se o valor dos dados é menor ou igual a 50000.

    Referência do código 5 Se TRUE, o script define a cor de fundo da célula como 0xFF8C00 ( █ )

    Referência do código 6 Se o valor de dados da célula for maior que 50000, o script definirá a cor de fundo da célula como 0x00FA9A ( █ )

  6. Na barra de ferramentas, clique em Salvar (Salvar) para salvar o script. Clique em OK para fechar a mensagem de informação.
    Mensagem de informações confirmando que a regra foi salva
  7. Clique em Validar e Implantar (Validar e Implantar). Clique em OK para fechar a mensagem de informação.
    Mensagem de implantação confirmando implantação bem-sucedida
  8. Deixe o Calculation Manager aberto e retorne à janela do navegador Planning.

Adicionando a Regra a um Formulário de Dados

  1. Na Home page do Planning, clique em Dados. Clique em EmployeeDriverForm para abrir o form de dados.
    EmployeeDriverForm abre com seus dados iniciais
  2. Clique em Ações e selecione Editar.
    Menu Ações com Editar selecionado
  3. Selecione a guia Regras de Negócios.
  4. Adicione Cor de Fundo do Conjunto Groovy às Regras de Negócios Selecionadas.
    Guia Regras de Negócios com a regra Groovy nas Regras de Negócios Selecionadas
  5. Em Propriedades da Regra de Negócios, selecione Executar Após Carregamento.
    Propriedades da Regra de Negócios com Execução Após Carregamento selecionado
  6. Clique em Salvar para salvar a definição do formulário. Clique em OK para fechar a mensagem de informação.
    Mensagem de informação confirmando que o formulário foi salvo
  7. Na parte inferior da página, feche a guia Editar EmployeeDriverForm para retornar ao formulário de dados.
  8. Quando o formulário for recarregado, verifique se as células ausentes são azuis, se os valores menores ou iguais a 50000 são laranja e se os valores maiores que 50000 são verdes.
    Form recarregado com células ausentes azuis, valores laranja no limite ou abaixo dele e valores verdes acima do limite

Criando Perfil e Depurando o Script

Nesta seção, você aprende a usar iteradores fornecidos pela interface DataGrid, traçar o perfil do código e adicionar instruções de depuração à console de jobs.

Criando um Script Groovy

  1. Retorne à janela Gerenciador de Cálculo.
  2. Selecione a guia Exibição de Sistema. Em Plan1, clique com o botão direito do mouse em Regras e selecione Novo.
    Exibição de Sistema com Novo selecionado no menu de contexto Regras
  3. Para Nome, digite Groovy Iterator Performance e clique em OK.
    Caixa de diálogo Nova Regra com Desempenho do Iterador Groovy informado
  4. No Editor de Regras, altere a opção Designer para Editar Script e defina o Tipo de Script como Script Groovy.
    Editor de Regras com Script de Edição e Script Groovy selecionados
  5. Copie este script e cole-o no 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')
    

    Referência do código 1 Defina um método de utilitário chamado benchmark() que use o GridIterator especificado para iterar sobre suas células e imprima a lista de nomes de membros de todas as dimensões que a célula representa junto com seus dados. Ele também imprime o tempo gasto pelo iterador.

    Referência do código 2 Inicie um temporizador.

    Referência do código 3 Itere sobre cada célula usando o GridIterator especificado e imprima a lista de nomes de membros de todas as dimensões que a célula representa junto com seu valor de dados e valor formatado. $it.data retorna o valor numérico da célula e $it.formattedValue retorna valores não numéricos, como Texto, Smart List ou Data, conforme informado pelo usuário.

    Referência do código 4 Imprima o tempo gasto pelo iterador no console de trabalho.

    Referência do código 5 Registre uma mensagem de depuração no console de jobs.

    Referência do código 6 Chame o método benchmark() com um iterador para iterar sobre cada célula na grade de dados atual.

    Referência do código 7 Chame o método benchmark() com um iterador para iterar sobre as células editadas na grade de dados atual.

    Dica:

    Esse iterador pode ser usado com qualquer propriedade no objeto DataCell que retorne um booliano, como bloqueado, ausente, válido, readOnly, validIntersection e assim por diante.

    Referência do código 8 Chame o método benchmark() com um iterador para iterar sobre as células de dados Salário Mínimo e Bônus Mínimo na grade de dados atual.

  6. Na barra de ferramentas, clique em Salvar (Salvar) para salvar o script. Clique em OK para fechar a mensagem de informação.
    Mensagem de informação confirmando que o desempenho do Groovy Iterator foi salvo
  7. Clique em Validar e Implantar (Validar e Implantar). Clique em OK para fechar a mensagem de informação.
    Mensagem confirmando implantação bem-sucedida
  8. Deixe o Calculation Manager aberto e retorne à janela do navegador Planning.

Adicionando a Regra a um Formulário de Dados

  1. No formulário EmployeeDriverForm, clique em Ações e selecione Editar.
    Menu Ações com Editar selecionado
  2. Selecione a guia Regras de Negócios e adicione Desempenho do Groovy Iterator às Regras de Negócios Selecionadas.
    Guia Regras de Negócios com Desempenho do Iterador Groovy adicionado às Regras de Negócios Selecionadas
  3. Em Propriedades da Regra de Negócios, para a regra de Desempenho do Iterador Groovy, selecione Executar Após Salvar.
    Desempenho do Iterador Groovy configurado para Execução Após Salvamento
  4. Clique em Salvar para salvar a definição do formulário. Clique em OK para fechar a mensagem de informação.
    Mensagem de informação confirmando que o formulário foi salvo
  5. Na parte inferior da página, feche a guia Editar EmployeeDriverForm para retornar ao formulário de dados.

Testando o Script Groovy

  1. Em EmployeeDriverForm, altere Salário Mínimo do Grau 1 para 35000 e Bônus Mínimo do Grau 2 para 2000.
    EmployeeDriverForm com duas células editadas para FY26
  2. Clique em Salvar. A regra de Desempenho do Iterador Groovy é executada depois que os dados são salvos. Clique em OK para fechar a mensagem de informação.
    Mensagem de informações confirmando que os dados foram salvos e que as regras foram executadas com sucesso
  3. Clique em Navegador (Navegador) e, em Aplicativo, clique em Jobs para abrir a Console de Jobs.
    Console de Jobs com o job de Desempenho do Groovy Iterator concluído
  4. Clique em Desempenho do Groovy Iterator para exibir os detalhes do job. Em Status de Execução, expanda Concluído para exibir as mensagens de log impressas pelo script Groovy.
    Detalhes do job concluído mostrando mensagens de log do iterador

    O primeiro iterador imprime todas as células e os valores de dados, o segundo iterador imprime apenas as duas células que foram editadas e o terceiro iterador imprime apenas as células para as colunas Salário Mínimo e Bônus Mínimo.

  5. Feche os Detalhes da Tarefa.
  6. Clique em Navegador (Navegador) e selecione Dados para retornar ao EmployeeDriverForm.

Definindo Valores de Dados Padrão

Nesta seção, você aprende a definir os valores de dados padrão na grade usando a interface DataGridBuilder.

Criando um Script Groovy

  1. Retorne à janela Gerenciador de Cálculo.
  2. Selecione a guia Exibição de Sistema. Em Plan1, clique com o botão direito do mouse em Regras e selecione Novo.
    Exibição de Sistema com Novo selecionado no menu de contexto Regras
  3. Para Nome, digite Groovy Reset Grade Data e clique em OK.
    Caixa de diálogo Nova Regra com Dados de Nível Redefinidos do Groovy informados
  4. No Editor de Regras, altere a opção Designer para Editar Script e defina o Tipo de Script como Script Groovy.
    Editor de Regras com Script de Edição e Script Groovy selecionados
  5. Copie este script e cole-o no 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}
    

    Referência do código 1 Crie um objeto de cubo para o cubo Plan1 e leia o ano atual na variável de substituição no nível do aplicativo. getSubstitutionVariableValue("OEP_CurYr") lê a variável de substituição no nível do aplicativo sem um E comercial. No snapshot fornecido, seu valor é FY26.

    Referência do código 2 Obtenha um DataGridBuilder para o cubo; defina o formato no qual o script fornece os valores de data.

    Observação:

    O DataGridBuilder também suporta o salvamento de dados em nome de um usuário do sistema aceitando ExecuteAsUser como o segundo parâmetro. Salvar dados como usuário do sistema permite que os dados sejam salvos sem aplicar a segurança do usuário atual. Os valores válidos para ExecuteAsUser são CURRENT_USER (o padrão) e SYSTEM_USER, como no seguinte exemplo:

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

    Referência do código 3 Crie uma grade de dados adicionando os membros do PDV, os membros da coluna e as linhas com valores de dados. A transmissão de currentYear para addPov mantém a regra de redefinição alinhada com o formulário sem hard-coding por ano.

    Referência do código 4 Crie um objeto de status para o objeto DataGrid criado na próxima etapa.

    Referência do código 5 Crie o objeto DataGrid com a construção withCloseable. Ele fecha a grade quando o bloco é concluído, portanto a regra não deixa a grade aberta na memória.

    Referência do código 6 Imprime o número de células aceitas ou rejeitadas pelo construtor no console de jobs. Todas as células somente leitura são rejeitadas.

    Referência do código 7 Salve a grade de dados.

    Referência do código 8 A grade é fechada automaticamente.

  6. Na barra de ferramentas, clique em Salvar (Salvar) para salvar o script. Clique em OK para fechar a mensagem de informação.
    Mensagem de informações confirmando que a Redefinição de Dados do Grau do Groovy foi salva
  7. Clique em Validar e Implantar (Validar e Implantar). Clique em OK para fechar a mensagem de informação.
    Mensagem confirmando implantação bem-sucedida
  8. Feche o Calculation Manager e retorne à janela do navegador Planning.

Adicionando a Regra a um Formulário de Dados

  1. No EmployeeDriverForm, clique em Ações e selecione Editar.
    Menu Ações com Editar selecionado
  2. Selecione a guia Regras de Negócios.
  3. Adicione Groovy - Redefinir Dados do Nível às Regras de Negócios Selecionadas.
    Guia Regras de Negócios com Redefinir Dados de Nível do Groovy em Regras de Negócios Selecionadas
  4. Em Propriedades da Regra de Negócios, para a regra Redefinir Dados do Nível do Groovy, deixe Executar Antes do Carregamento, Executar Após o Carregamento, Executar Antes de Salvar e Executar Depois de Salvar desmarcados para que você possa iniciá-los manualmente.
    Redefinir Dados de Grau do Groovy com todas as opções de carregamento e salvamento automáticos desmarcadas
  5. Clique em Salvar para salvar a definição do formulário e, em seguida, clique em OK para fechar a mensagem de informações.
    Mensagem de informação confirmando que o formulário foi salvo
  6. Na parte inferior da página, feche a guia Editar EmployeeDriverForm para retornar ao formulário de dados.

Testando o Script Groovy

  1. Clique em Ações e selecione Regras e Envio Inteligente.
    Menu Ações com Regras e Envio Inteligente selecionado
  2. Em Regras, selecione Redefinir Dados de Nível do Groovy para iniciar a regra.
    Lista de regras com Dados de Grau de Redefinição do Groovy selecionados
  3. Quando a regra for concluída com sucesso, clique em OK para fechar a mensagem de informações.
    Mensagem de informações confirmando que a Redefinição de Dados do Grau do Groovy foi executada com sucesso
  4. Verifique se os dados da grade foram redefinidos para os valores a seguir.
    FY26 EmployeeDriverForm com os valores padrão de salário e bônus restaurados
    NívelSalário Mín.Salário Máx.Bônus mínimoBônus máximo
    Grau 130.00050.000AusenteAusente
    Grau 240.00060.000Ausente5.000
    Grau 370.00090.000Ausente10.000
  5. Clique em Navegador (Navegador) e, em Aplicativo, clique em Jobs para abrir a Console de Jobs.
    Console de Jobs com o job Groovy Reset Grade Data concluído
  6. Clique em Redefinir Dados do Nível do Groovy para exibir os detalhes do job. Em Status de Execução, expanda Concluído para exibir os números de células aceitas e rejeitadas.
    Detalhes do job Redefinir Dados do Nível do Groovy Concluídos com contagens de células aceitas e rejeitadas

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.