Introducción

En este tutorial se muestra cómo implementar scripts de Groovy para trabajar con cuadrículas e iteradores de cuadrícula de datos. Puede utilizar la lógica condicional para definir los colores de fondo en una cuadrícula de datos, implantar la referencia de rendimiento y definir los valores de datos por defecto en una cuadrícula. Complete las secciones en orden.

Antecedentes

Una interfaz de cuadrícula de datos proporciona acceso a las celdas de cabecera de PDV/fila/columna y proporciona varios iteradores para iterar sobre las celdas de datos.

Requisitos

Los tutoriales prácticos de Cloud EPM pueden requerir que importe una instantánea en una instancia de Cloud EPM Enterprise Service. No se puede importar una instantánea a través de una aplicación o un proceso de negocio existente. Antes de importar la instantánea, utilice una instancia de Cloud EPM Enterprise Service independiente o elimine la aplicación o el proceso de negocio existentes de la instancia que desea utilizar. La importación de la instantánea no sustituye ni restaura automáticamente el contenido existente.

Antes de comenzar este tutorial, debe:

  • Tener acceso de administrador de servicio a una instancia de Cloud EPM Enterprise Service. La instancia no debe tener un proceso de negocio creado.
  • Cargue e importe esta instantánea en la instancia. Esta instantánea requiere el proceso de negocio de planificación. Si ya ha importado la instantánea para otro tutorial de Groovy, puede continuar utilizando esa aplicación sin volver a importar la instantánea.

Note:

Si se producen errores de migración al importar la instantánea, vuelva a ejecutar la migración excluyendo el componente de HSS-Shared Services, así como los artefactos de seguridad y preferencias de usuario en el componente Core. Para obtener más información sobre la carga y la importación de instantáneas, consulte la documentación de Administración de migración para Oracle Enterprise Performance Management Cloud.

Sugerencia:

Los scripts que necesita para este tutorial están enlazados como archivos de texto dentro de cada sección.

Configuración del color de fondo mediante la lógica condicional

En esta sección, implementará un script Groovy para definir el color de fondo para las celdas con el valor de datos #MISSING para que coloreen █ (0x00BFFF), las celdas con el valor de datos menor o igual que 50000 para que coloreen █ (0xFF8C00) y las celdas con los valores de datos mayores que 50000 para que coloreen █ (0x00FA9A).

Note:

Después de definir un script Groovy, se puede asociar a cualquier formulario, a diferencia de las reglas de validación de datos, que se deben definir en el contexto de cada formulario.

Creación de un script Groovy

  1. En la página de inicio de Planning, haga clic en Navegador (Navegador) y, a continuación, en Crear y gestionar, haga clic en Reglas para abrir Calculation Manager.
    Navegador con reglas en Crear y gestionar
  2. En la ficha Vista del sistema, expanda EPM Cloud, HP4 y, a continuación, Plan1. Haga clic con el botón secundario en Reglas y, a continuación, seleccione Nuevo.
    Vista del sistema con el menú contextual Reglas y Nuevo seleccionado
  3. En Nombre, introduzca Groovy Set Background Color y, a continuación, haga clic en Aceptar.
    Cuadro de diálogo Nueva regla con el nombre de regla, la aplicación y el cubo
  4. En el editor de reglas, cambie la opción Diseñador a Editar script y defina el tipo de script en Script de Groovy.
    Editor de reglas con el script Edit y Groovy seleccionado
  5. Copie esta secuencia de comandos y péguela en el 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
    }
    

    Referencia 1 de código El script itera en cada celda de datos de la cuadrícula de datos actual, operation.grid, devuelta por dataCellIterator.

    La variable it implícita hace referencia al elemento actual sobre el que se itera. En este caso, la variable it hace referencia a la celda de datos actual devuelta por dataCellIterator.

    Sugerencia:

    También puede utilizar una variable con nombre explícito, como cell, como se muestra en el siguiente ejemplo:
     operation.grid.dataCellIterator.each { cell ->
        if(cell.missing) {
          cell.bgColor = 0x00BFFF
        }
    }

    Referencia 2 de código Para la celda de datos actual, el script comprueba si falta un valor.

    Note:

    Tenga en cuenta que cell.data devuelve 0 (cero) para las celdas que son #MISSING o cero. Para comprobar una celda para #MISSING y no cero, puede utilizar la propiedad cell.missing. Para comprobar un valor cero en una celda y no #MISSING, puede utilizar una condición como cell.data == 0 && !cell.missing.

    Referencia 3 de código Si es TRUE, el script define el color de fondo de la celda en 0x00BFFF( █ )

    Referencia 4 de código El script comprueba si el valor de datos es menor o igual que 50000.

    Referencia 5 de código Si es TRUE, el script define el color de fondo de la celda en 0xFF8C00 ( █ )

    Referencia 6 de código Si el valor de datos de la celda es superior a 50000, el script define el color de fondo de la celda en 0x00FA9A ( █ )

  6. En la barra de herramientas, haga clic en Guardar (Guardar) para guardar el script. Haga clic en Aceptar para cerrar el mensaje de información.
    Mensaje de información que confirma que se ha guardado la regla
  7. Haga clic en Validar y desplegar (Validar y desplegar). Haga clic en Aceptar para cerrar el mensaje de información.
    Mensaje de despliegue que confirma el despliegue correcto
  8. Deje Calculation Manager abierto y vuelva a la ventana del explorador de Planning.

Adición de la regla a un formulario de datos

  1. En la página inicial de Planning, haga clic en Datos. Haga clic en EmployeeDriverForm para abrir el formulario de datos.
    EmployeeDriverForm abierto con sus datos iniciales
  2. Haga clic en Acciones y, a continuación, seleccione Editar.
    Menú Acciones con Editar seleccionado
  3. Seleccione la pestaña Reglas de negocio.
  4. Agregue Color de fondo de juego de Groovy a las reglas de negocio seleccionadas.
    Separador Reglas de negocio con la regla Groovy en Reglas de negocio seleccionadas
  5. En Propiedades de regla de negocio, seleccione Ejecutar después de la carga.
    Propiedades de regla de negocio con Ejecutar después de carga seleccionada
  6. Haga clic en Save (Guardar) para guardar la definición del formulario. Haga clic en Aceptar para cerrar el mensaje de información.
    Mensaje de información que confirma que el formulario se ha guardado
  7. En la parte inferior de la página, cierre el separador Editar EmployeeDriverForm para volver al formulario de datos.
  8. Cuando se vuelva a cargar el formulario, verifique que las celdas que faltan sean azules, que los valores menores o iguales que 50000 sean naranjas y que los valores mayores que 50000 sean verdes.
    Pantalla recargada con celdas faltantes azules, valores naranjas en o por debajo del umbral y valores verdes por encima del umbral

Creación de Perfiles y Depuración del Script

En esta sección, aprenderá a utilizar iteradores proporcionados por la interfaz DataGrid, a perfilar el código y a agregar sentencias de depuración a la consola de trabajos.

Creación de un script Groovy

  1. Vuelva a la ventana Calculation Manager.
  2. Seleccione el separador Vista del sistema. En Plan1, haga clic con el botón secundario en Reglas y, luego, seleccione Nuevo.
    Vista del sistema con la opción Nueva seleccionada en el menú contextual Reglas
  3. En Nombre, introduzca Groovy Iterator Performance y, a continuación, haga clic en Aceptar.
    Cuadro de diálogo Nueva regla con rendimiento de iterador de Groovy introducido
  4. En el editor de reglas, cambie la opción Diseñador a Editar script y defina el tipo de script en Script de Groovy.
    Editor de reglas con el script Edit y Groovy seleccionado
  5. Copie esta secuencia de comandos y péguela en el 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')
    

    Referencia 1 de código Defina un método de utilidad denominado benchmark() que utilice el GridIterator especificado para iterar sobre sus celdas e imprima la lista de nombres de miembros de todas las dimensiones que representa la celda junto con sus datos. También imprime el tiempo empleado por el iterador.

    Referencia 2 de código Iniciar un temporizador.

    Referencia 3 de código Itere sobre cada celda mediante el GridIterator especificado e imprima la lista de nombres de miembros de todas las dimensiones que representa la celda junto con su valor de datos y valor formateado. $it.data devuelve el valor numérico de la celda y $it.formattedValue devuelve valores no numéricos como Texto, Lista inteligente o Fecha, según lo introducido por el usuario.

    Referencia 4 de código Imprima el tiempo que tarda el iterador en la consola de trabajos.

    Referencia 5 de código Registrar un mensaje de depuración en la consola de trabajos.

    Referencia 6 de código Llame al método benchmark() con un iterador para iterar sobre cada celda de la cuadrícula de datos actual.

    Referencia 7 de código Llame al método benchmark() con un iterador para iterar sobre las celdas editadas en la cuadrícula de datos actual.

    Sugerencia:

    Este iterador se puede utilizar con cualquier propiedad del objeto DataCell que devuelva un valor booleano, como bloqueado, faltante, válido, readOnly, validIntersection, etc.

    Referencia 8 de código Llame al método benchmark() con un iterador para iterar sobre las celdas de datos Salario mínimo y Bonificación mínima en la cuadrícula de datos actual.

  6. En la barra de herramientas, haga clic en Guardar (Guardar) para guardar el script. Haga clic en Aceptar para cerrar el mensaje de información.
    Mensaje de información que confirma que se ha guardado Groovy Iterator Performance
  7. Haga clic en Validar y desplegar (Validar y desplegar). Haga clic en Aceptar para cerrar el mensaje de información.
    Mensaje que confirma el despliegue correcto
  8. Deje Calculation Manager abierto y vuelva a la ventana del explorador de Planning.

Adición de la regla a un formulario de datos

  1. En el formulario EmployeeDriverForm, haga clic en Acciones y, a continuación, seleccione Editar.
    Menú Acciones con Editar seleccionado
  2. Seleccione el separador Reglas de negocio y, a continuación, agregue Rendimiento de iterador de Groovy a las reglas de negocio seleccionadas.
    Separador Reglas de negocio con rendimiento de iterador de Groovy agregado a las reglas de negocio seleccionadas
  3. En Propiedades de regla de negocio, para la regla de rendimiento del iterador de Groovy, seleccione Ejecutar después de guardar.
    Rendimiento de iterador de Groovy configurado para ejecutarse después de guardar
  4. Haga clic en Save (Guardar) para guardar la definición del formulario. Haga clic en Aceptar para cerrar el mensaje de información.
    Mensaje de información que confirma que el formulario se ha guardado
  5. En la parte inferior de la página, cierre el separador Editar EmployeeDriverForm para volver al formulario de datos.

Prueba del script Groovy

  1. En EmployeeDriverForm, cambie Salario mínimo para el grado 1 a 35000 y Bono mínimo para el grado 2 a 2000.
    EmployeeDriverForm con dos celdas editadas para FY26
  2. Haga clic en Guardar. La regla de rendimiento del iterador de Groovy se ejecuta después de guardar los datos. Haga clic en Aceptar para cerrar el mensaje de información.
    Mensaje de información que confirma que los datos se han guardado y que las reglas se han ejecutado correctamente
  3. Haga clic en Navegador (Navegador) y, a continuación, en Aplicación, haga clic en Trabajos para abrir la consola de trabajos.
    Consola de trabajos con el trabajo de rendimiento de iterador de Groovy completado
  4. Haga clic en Rendimiento de iterador de Groovy para mostrar los detalles del trabajo. En Estado de ejecución, expanda Completado para ver los mensajes de log impresos por la secuencia de comandos de Groovy.
    Detalles del trabajo finalizado que muestran los mensajes del log del iterador

    El primer iterador imprime todas las celdas y los valores de datos, el segundo iterador imprime solo las dos celdas que se han editado y el tercer iterador imprime solo las celdas de las columnas Salario mínimo y Bonificación mínima.

  5. Cierre los Detalles de trabajo.
  6. Haga clic en Navegador (navegador) y, a continuación, seleccione Datos para volver a EmployeeDriverForm.

Definición de valores de datos por defecto

En esta sección, aprenderá a definir los valores de datos por defecto en la cuadrícula mediante la interfaz DataGridBuilder.

Creación de un script Groovy

  1. Vuelva a la ventana Calculation Manager.
  2. Seleccione el separador Vista del sistema. En Plan1, haga clic con el botón secundario en Reglas y, luego, seleccione Nuevo.
    Vista del sistema con la opción Nueva seleccionada en el menú contextual Reglas
  3. En Nombre, introduzca Groovy Reset Grade Data y, a continuación, haga clic en Aceptar.
    Cuadro de diálogo Nueva regla con datos de grupo de restablecimiento de Groovy introducidos
  4. En el editor de reglas, cambie la opción Diseñador a Editar script y defina el tipo de script en Script de Groovy.
    Editor de reglas con el script Edit y Groovy seleccionado
  5. Copie esta secuencia de comandos y péguela en el 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}
    

    Referencia 1 de código Cree un objeto de cubo para el cubo Plan1 y lea el año actual desde la variable de sustitución de nivel de aplicación. getSubstitutionVariableValue("OEP_CurYr") lee la variable de sustitución de nivel de aplicación sin un ampersand. En la instantánea proporcionada, su valor es FY26.

    Referencia 2 de código Obtenga un DataGridBuilder para el cubo; defina el formato en el que el script proporciona los valores de fecha.

    Note:

    DataGridBuilder también soporta el guardado de datos en nombre de un usuario del sistema mediante la aceptación de ExecuteAsUser como segundo parámetro. Guardar datos como usuario del sistema permite guardar los datos sin aplicar la seguridad del usuario actual. Los valores válidos para ExecuteAsUser son CURRENT_USER (valor por defecto) y SYSTEM_USER, como en el siguiente ejemplo:

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

    Referencia 3 de código Crear una cuadrícula de datos agregando los miembros de PDV, los miembros de columna y las filas con valores de datos. Si se transfiere currentYear a addPov, la regla de restablecimiento se mantiene alineada con el formulario sin codificación fija al año.

    Referencia 4 de código Cree un objeto de estado para el objeto DataGrid creado en el siguiente paso.

    Referencia 5 de código Cree el objeto DataGrid con la construcción withCloseable. Cierra la cuadrícula cuando finaliza el bloque, por lo que la regla no deja la cuadrícula abierta en la memoria.

    Referencia 6 de código Imprima el número de celdas aceptadas o rechazadas por el creador en la consola de trabajos. Se rechazan todas las celdas de solo lectura.

    Referencia 7 de código Guarde la cuadrícula de datos.

    Referencia 8 de código La cuadrícula se cierra automáticamente.

  6. En la barra de herramientas, haga clic en Guardar (Guardar) para guardar el script. Haga clic en Aceptar para cerrar el mensaje de información.
    Mensaje de información que confirma que se han guardado los datos de calificación de restablecimiento de Groovy
  7. Haga clic en Validar y desplegar (Validar y desplegar). Haga clic en Aceptar para cerrar el mensaje de información.
    Mensaje que confirma el despliegue correcto
  8. Cierre Calculation Manager y vuelva a la ventana del explorador de Planning.

Adición de la regla a un formulario de datos

  1. En EmployeeDriverForm, haga clic en Acciones y, a continuación, seleccione Editar.
    Menú Acciones con Editar seleccionado
  2. Seleccione la pestaña Reglas de negocio.
  3. Agregue Datos de grupo de restablecimiento de Groovy a las reglas de negocio seleccionadas.
    Separador Reglas de negocio con datos de grupo de restablecimiento de Groovy en reglas de negocio seleccionadas
  4. En Propiedades de regla de negocio, para la regla Restablecer datos de grupo de Groovy, deje Ejecutar antes de cargar, Ejecutar después de cargar, Ejecutar antes de guardar y Ejecutar después de guardar en blanco para que pueda iniciarla manualmente.
    Datos de rango de restablecimiento de Groovy con todas las opciones de carga y guardado automáticas borradas
  5. Haga clic en Guardar para guardar la definición del formulario y, a continuación, haga clic en Aceptar para cerrar el mensaje de información.
    Mensaje de información que confirma que el formulario se ha guardado
  6. En la parte inferior de la página, cierre el separador Editar EmployeeDriverForm para volver al formulario de datos.

Prueba del script Groovy

  1. Haga clic en Acciones y, a continuación, seleccione Reglas y envío inteligente.
    Menú Acciones con reglas y envío inteligente seleccionados
  2. En Reglas, seleccione Restablecer datos de grupo de Groovy para iniciar la regla.
    Lista de reglas con datos de grupo de restablecimiento de Groovy seleccionados
  3. Cuando la regla se complete correctamente, haga clic en Aceptar para cerrar el mensaje de información.
    Mensaje de información que confirma que los datos de calificación de restablecimiento de Groovy se han ejecutado correctamente
  4. Verifique que los datos de cuadrícula se hayan restablecido a los siguientes valores.
    FY26 EmployeeDriverForm con los valores de salario y bonificación por defecto restaurados
    GradoSueldo MínimoSueldo MáximoBonificación mínimaBonificación máxima
    Grado 130.00050.000FaltaFalta
    Grado 240.00060.000Falta5.000
    Grado 370.00090.000Falta10.000
  5. Haga clic en Navegador (Navegador) y, a continuación, en Aplicación, haga clic en Trabajos para abrir la consola de trabajos.
    Consola de trabajos con el trabajo de datos de grupo de restablecimiento de Groovy completado
  6. Haga clic en Restablecer datos de grupo de Groovy para mostrar los detalles del trabajo. En Estado de ejecución, expanda Finalizado para ver el número de celdas aceptadas y rechazadas.
    Detalles de trabajo de restablecimiento de datos de grupo de Groovy completados con recuentos de celdas aceptadas y rechazadas

Más recursos de aprendizaje

Explore otros laboratorios en docs.oracle.com/learn o acceda a más contenido de aprendizaje gratuito en el canal YouTube de Oracle Learning. Además, visite Oracle University para ver los recursos de formación disponibles.

Para obtener documentación sobre el producto, visite Oracle Help Center.