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
- Na Home page do Planning, clique em
(Navegador) e, em Criar e Gerenciar, clique em Regras para abrir o Calculation Manager.
- Na guia Exibição de Sistema, expanda EPM Cloud, HP4 e Plan1. Clique com o mouse em Regras e selecione Novo.

- Para Nome, digite
Groovy Set Background Colore clique em OK.
- No Editor de Regras, altere a opção Designer para Editar Script e defina o Tipo de Script como Script Groovy.

- Copie este script e cole-o no editor.
operation.grid.dataCellIterator.each {
if(it.missing) {
it.bgColor = 0x00BFFF
} else if(it.data <= 50000)
it.bgColor = 0xFF8C00
else if(it.data > 50000)
it.bgColor = 0x00FA9A
}
O script itera sobre cada célula de dados na grade de dados atual, operation.grid, retornada pordataCellIterator.A variável
itimplícita refere-se ao item atual que está sendo iterado. Nesse caso, a variávelitse refere à célula de dados atual retornada pordataCellIterator.Dica:
Você também pode usar uma variável explicitamente nomeada, comocell, conforme mostrado no exemplo abaixo:
operation.grid.dataCellIterator.each { cell -> if(cell.missing) { cell.bgColor = 0x00BFFF } }
Para a célula de dados atual, o script verifica se há um valor ausente.Observação:
Observe quecell.dataretorna 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 propriedadecell.missing. Para verificar um valor zero em uma célula e não em #MISSING, você pode usar uma condição comocell.data == 0 && !cell.missing.
Se TRUE, o script define a cor de fundo da célula como 0x00BFFF( █ )
O script verifica se o valor dos dados é menor ou igual a 50000.
Se TRUE, o script define a cor de fundo da célula como 0xFF8C00( █ )
Se o valor de dados da célula for maior que 50000, o script definirá a cor de fundo da célula como 0x00FA9A ( █ ) - Na barra de ferramentas, clique em
(Salvar) para salvar o script. Clique em OK para fechar a mensagem de informação.
- Clique em
(Validar e Implantar). Clique em OK para fechar a mensagem de informação.
- Deixe o Calculation Manager aberto e retorne à janela do navegador Planning.
Adicionando a Regra a um Formulário de Dados
- Na Home page do Planning, clique em Dados. Clique em EmployeeDriverForm para abrir o form de dados.

- Clique em Ações e selecione Editar.

- Selecione a guia Regras de Negócios.
- Adicione Cor de Fundo do Conjunto Groovy às Regras de Negócios Selecionadas.

- Em Propriedades da Regra de Negócios, selecione Executar Após Carregamento.

- Clique em Salvar para salvar a definição do formulário. Clique em OK para fechar a mensagem de informação.

- Na parte inferior da página, feche a guia Editar EmployeeDriverForm para retornar ao formulário de dados.
- Quando o formulário for recarregado, verifique se as células ausentes são azuis, se os valores menores ou iguais a
50000são laranja e se os valores maiores que50000são verdes.
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
- Retorne à janela Gerenciador de Cálculo.
- Selecione a guia Exibição de Sistema. Em Plan1, clique com o botão direito do mouse em Regras e selecione Novo.

- Para Nome, digite
Groovy Iterator Performancee clique em OK.
- No Editor de Regras, altere a opção Designer para Editar Script e defina o Tipo de Script como Script Groovy.

- Copie este script e cole-o no editor.
def benchmark(GridIterator itr) {
def start = currentTimeMillis()
itr.each { println "$it.memberNames, cell data: $it.data, $it.formattedValue" }
def elapsed = currentTimeMillis() - start
println "\nTime taken by iterator: $elapsed"
}
println "Iterate over all data cells in this data grid...\n"
benchmark operation.grid.dataCellIterator()
println "Iterate over edited data cells in this data grid...\n"
benchmark operation.grid.dataCellIterator({DataCell cell -> cell.edited})
println "Iterate over Min Salary and Min Bonus data cells in this data grid...\n"
benchmark operation.grid.dataCellIterator('Min Salary', 'Min Bonus')
Defina um método de utilitário chamado benchmark()que use oGridIteratorespecificado 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.
Inicie um temporizador.
Itere sobre cada célula usando o GridIteratorespecificado 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.dataretorna o valor numérico da célula e$it.formattedValueretorna valores não numéricos, como Texto, Smart List ou Data, conforme informado pelo usuário.
Imprima o tempo gasto pelo iterador no console de trabalho.
Registre uma mensagem de depuração no console de jobs.
Chame o método benchmark()com um iterador para iterar sobre cada célula na grade de dados atual.
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.
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. - Na barra de ferramentas, clique em
(Salvar) para salvar o script. Clique em OK para fechar a mensagem de informação.
- Clique em
(Validar e Implantar). Clique em OK para fechar a mensagem de informação.
- Deixe o Calculation Manager aberto e retorne à janela do navegador Planning.
Adicionando a Regra a um Formulário de Dados
- No formulário EmployeeDriverForm, clique em Ações e selecione Editar.

- Selecione a guia Regras de Negócios e adicione Desempenho do Groovy Iterator às Regras de Negócios Selecionadas.

- Em Propriedades da Regra de Negócios, para a regra de Desempenho do Iterador Groovy, selecione Executar Após Salvar.

- Clique em Salvar para salvar a definição do formulário. Clique em OK para fechar a mensagem de informação.

- Na parte inferior da página, feche a guia Editar EmployeeDriverForm para retornar ao formulário de dados.
Testando o Script Groovy
- Em EmployeeDriverForm, altere Salário Mínimo do Grau 1 para
35000e Bônus Mínimo do Grau 2 para2000.
- 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.

- Clique em
(Navegador) e, em Aplicativo, clique em Jobs para abrir a Console de Jobs.
- 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.

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.
- Feche os Detalhes da Tarefa.
- Clique em
(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
- Retorne à janela Gerenciador de Cálculo.
- Selecione a guia Exibição de Sistema. Em Plan1, clique com o botão direito do mouse em Regras e selecione Novo.

- Para Nome, digite
Groovy Reset Grade Datae clique em OK.
- No Editor de Regras, altere a opção Designer para Editar Script e defina o Tipo de Script como Script Groovy.

- Copie este script e cole-o no editor.
Cube cube = operation.application.getCube("Plan1")
String currentYear = operation.application.getSubstitutionVariableValue("OEP_CurYr")
DataGridBuilder builder = cube.dataGridBuilder("MM/DD/YYYY")
builder.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])
DataGridBuilder.Status status = new DataGridBuilder.Status()
builder.build(status).withCloseable { DataGrid grid ->
println("Total number of cells accepted: $status.numAcceptedCells")
println("Total number of cells rejected: $status.numRejectedCells")
println("First 100 rejected cells: $status.cellsRejected")
cube.saveGrid(grid)
}
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.
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 aceitandoExecuteAsUsercomo 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 paraExecuteAsUsersãoCURRENT_USER(o padrão) eSYSTEM_USER, como no seguinte exemplo:
DataGridBuilder builder = cube.dataGridBuilder("MM/DD/YYYY", SYSTEM_USER)
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 currentYearparaaddPovmantém a regra de redefinição alinhada com o formulário sem hard-coding por ano.
Crie um objeto de status para o objeto DataGrid criado na próxima etapa.
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.
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.
Salve a grade de dados.
A grade é fechada automaticamente. - Na barra de ferramentas, clique em
(Salvar) para salvar o script. Clique em OK para fechar a mensagem de informação.
- Clique em
(Validar e Implantar). Clique em OK para fechar a mensagem de informação.
- Feche o Calculation Manager e retorne à janela do navegador Planning.
Adicionando a Regra a um Formulário de Dados
- No EmployeeDriverForm, clique em Ações e selecione Editar.

- Selecione a guia Regras de Negócios.
- Adicione Groovy - Redefinir Dados do Nível às Regras de Negócios Selecionadas.

- 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.

- Clique em Salvar para salvar a definição do formulário e, em seguida, clique em OK para fechar a mensagem de informações.

- Na parte inferior da página, feche a guia Editar EmployeeDriverForm para retornar ao formulário de dados.
Testando o Script Groovy
- Clique em Ações e selecione Regras e Envio Inteligente.

- Em Regras, selecione Redefinir Dados de Nível do Groovy para iniciar a regra.

- Quando a regra for concluída com sucesso, clique em OK para fechar a mensagem de informações.

- Verifique se os dados da grade foram redefinidos para os valores a seguir.

Nível Salário Mín. Salário Máx. Bônus mínimo Bônus máximo Grau 1 30.000 50.000 Ausente Ausente Grau 2 40.000 60.000 Ausente 5.000 Grau 3 70.000 90.000 Ausente 10.000 - Clique em
(Navegador) e, em Aplicativo, clique em Jobs para abrir a Console de Jobs.
- 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.

Links Relacionados
- Tutoriais do Planning — Selecione Implementando o Groovy na lista de áreas de interesse para explorar tutoriais adicionais do Groovy.
- Referência da API Java para Regras Groovy — Explore as APIs Groovy disponíveis para desenvolver regras e modelos Groovy.
- APIs REST para o Oracle Fusion Cloud EPM — Explore as APIs REST disponíveis para gerenciar e automatizar tarefas do Cloud EPM.
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.
Como Trabalhar com Grades de Dados e Iteradores no Groovy
G42665-02
Novembro de 2026
Copyright © 2026, Oracle e/ou suas empresas afiliadas.