Eventos

Los pasos realizados por el Agente de integración de EPM son los siguientes:

  1. Procesar el SQL definido por el origen de datos de Agente de integración de EPM especificado en Oracle Enterprise Performance Management Cloud.

  2. Preparar y transmitir el conjunto de resultados de SQL a EPM Cloud desde el origen de datos definido.

Estos pasos se denominan "Extraer" y "Cargar". Los scripts del Agente de integración de EPM admiten cuatro eventos relacionados con estos dos pasos del proceso en los que puede definir scripts personalizados. Los eventos son los siguientes:

Evento Nombre de script Descripción

Before Extract

BefExtract.py

BefExtract.groovy

Script ejecutado antes del procesamiento de extracción de agente. Si desea realizar algún procesamiento antes del procesamiento SQL, ese código se debe incluir en el script.

After Extract

AftExtract.py

AftExtract.groovy

Script ejecutado después del procesamiento de extracción de agente. Después de la extracción se prepara un archivo, que incluye el identificador de trabajo con el sufijo dat en agent/MyData/data local folder

Before Upload

BefUpload.py

BefUpload.groovy

Script ejecutado antes de que se cargue el archivo de datos en EPM Cloud. El archivo cargado en EPM Cloud es el archivo <jobID>.dat de la carpeta agent/MyData/data.

After Upload

AftUpload.py

AftUpload.groovy

Script ejecutado después de que se cargue el archivo de datos en EPM Cloud.

Nota:

Para obtener información sobre los eventos BefExport y AftExport del agente de integración de EPM usados durante las ejecuciones de reescritura, consulte Scripts de evento de reescritura del agente de integración de EPM.

Hay scripts de ejemplo disponibles en las carpetas agent/Sample/jython y agent/Sample/groovy del equipo local donde se instaló el agente. El sistema ejecuta una instancia de un script si este está ubicado en la carpeta agent/MyData/scripts. Por ejemplo, si solo desea ejecutar el script BefExtract, guarde solo este script en la carpeta agent/MyData/scripts.

También puede elegir crear su propia implementación de la clase Java que implementa los cuatro métodos personalizados descritos anteriormente. Se proporciona un ejemplo en la carpeta Agent/Sample de referencia, pero tenga en cuenta lo siguiente si se selecciona este enfoque:

  • Si elige implementar la lógica de la integración directamente en Java, no será necesario que guarde ningún script en la carpeta agent/MyData/scripts. La implementación de Java siempre ejecuta los cuatro eventos y si no hay un archivo de script presente para alguno de estos eventos, simplemente procesa la lógica de Java definida por el cliente/socio.

  • Puede crear un archivo de clase Java CustomEvent.java, el cual debe implementar la interfaz EPMAgentInterface (por ejemplo, public class CustomEvent implementa EPMAgentInterface{), presente en agent-interface.jar.

  • CustomEvent.class se puede empaquetar en agent-interface.jar como oracle.epm.aif.agent.agentinterface.CustomEvent.class. Si elige empaquetarlo en un archivo .jar independiente que no sea agent-interface.jar, este .jar se deberá incluir en el parámetro de inicio de agente CUSTOM_CLASS_PATH.

  • Si elige utilizar un nombre de clase distinto de oracle.epm.aif.agent.agentinterface.CustomEvent.class, deberá definir el parámetro de inicio CUSTOM_INTERFACE_CLASS_NAME con el nombre de clase de Java completo.

  • Tenga en cuenta que agent-interface.jar se actualiza cada vez que el desarrollo proporciona una corrección o una nueva versión durante el ciclo de versiones periódicas de EPM Cloud. La clase de evento personalizada se puede utilizar con fines de desarrollo y prueba, pero para el despliegue de producción, se recomienda mantener un archivo. jar independiente para que no se sobrescriban las personalizaciones.