Ereignisse

Die folgenden Schritte werden von EPM Integration Agent durchgeführt:

Von der EPM Integration Agent-Datenquelle in Oracle Enterprise Performance Management Cloud angegebene SQL verarbeiten.
SQL-Ergebnisset für EPM Cloud von der definierten Datenquelle vorbereiten und übertragen.

Diese Schritte werden als Schritte zum "Extrahieren" und "Hochladen" bezeichnet. Das Skripting in EPM Integration Agent unterstützt vier Ereignisse für diese beiden Prozessschritte, für die Sie benutzerdefinierte Skripte definieren können. Folgende Ereignisse sind verfügbar:

Ereignis	Skriptname	Beschreibung
`Before Extract`	`BefExtract.py` `BefExtract.groovy`	Vor der Agent-Extraktverarbeitung ausgeführtes Skript. Wenn Sie vor der SQL-Verarbeitung weitere Verarbeitungsschritte ausführen möchten, muss dieser Code im Skript enthalten sein.
`After Extract`	`AftExtract.py` `AftExtract.groovy`	Nach der Agent-Extraktverarbeitung ausgeführtes Skript. Nach dem Extrahieren wird eine Datei vorbereitet, die die Job-ID mit dem Suffix `dat` im Ordner `agent/MyData/data local folder` enthält.
`Before Upload`	`BefUpload.py` `BefUpload.groovy`	Vor dem Hochladen der Datendatei in EPM Cloud ausgeführtes Skript. Bei der in EPM Cloud hochgeladenen Datei handelt es sich um die Datei `<jobID>.dat` aus dem Ordner `agent/MyData/data`.
`After Upload`	`AftUpload.py` `AftUpload.groovy`	Nach dem Hochladen der Datendatei in EPM Cloud ausgeführtes Skript.

Hinweis:

Informationen zu BefExport- und AftExport-Ereignissen von EPM Integration Agent, die während der Writeback-Ausführungen verwendet werden, finden Sie unter Ereignisskripte für Writebacks mit EPM Integration Agent.

Beispielskripte sind in den Ordnern agent/Sample/jython und agent/Sample/groovy auf dem lokalen Computer verfügbar, auf dem der Agent installiert wurde. Das System führt eine Instanz eines Skripts aus, wenn sie im Ordner agent/MyData/scripts enthalten ist. Beispiel: Wenn Sie nur das Skript BefExtract ausführen möchten, speichern Sie nur dieses Skript im Ordner agent/MyData/scripts.

Sie können auch Ihre eigene Implementierung der Java-Klasse erstellen, die die vier oben beschriebenen benutzerdefinierten Methoden implementiert. Sie finden ein Beispiel dazu im Ordner Agent/Sample. Beachten Sie jedoch Folgendes, wenn Sie diese Vorgehensweise auswählen:

Wenn Sie Ihre Integrationslogik direkt in Java implementieren möchten, müssen Sie keine Skripte im Ordner agent/MyData/scripts speichern. Die Java-Implementierung führt immer die vier Ereignisse aus. Wenn für eines dieser Ereignisse keine Skriptdatei vorhanden ist, wird nur die vom Kunden/Partner definierte Java-Logik verarbeitet.
Sie können eine Java-Klassendatei namens CustomEvent.java erstellen, die die Schnittstelle EPMAgentInterface implementiert (z.B. public class CustomEvent implementiert EPMAgentInterface{), die in der Datei agent-interface.jar vorhanden ist.
Die Datei CustomEvent.class kann in die Datei agent-interface.jar als oracle.epm.aif.agent.agentinterface.CustomEvent.class eingefügt werden. Wenn Sie sie in eine andere separate JAR-Datei einfügen möchten als agent-interface.jar, muss diese JAR-Datei im Agent-Startparameter CUSTOM_CLASS_PATH enthalten sein.
Wenn Sie einen anderen Klassennamen aus der Datei oracle.epm.aif.agent.agentinterface.CustomEvent.class verwenden möchten, müssen Sie den Startparameter CUSTOM_INTERFACE_CLASS_NAME mit dem vollqualifizierten Java-Klassennamen festlegen.
Beachten Sie, dass die Datei agent-interface.jar jedes Mal aktualisiert wird, wenn von der Entwicklungsabteilung ein Fix oder eine neue Version während des regelmäßigen Releasezyklus von EPM Cloud zur Verfügung gestellt wird. Die benutzerdefinierte Ereignisklasse kann für Entwicklungs- und Testzwecke verwendet werden. Für Produktions-Deployments wird jedoch empfohlen, eine separate JAR-Datei zu verwenden, damit die Anpassungen nicht überschrieben werden.