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 |
---|---|---|
|
|
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. |
|
|
Nach der Agent-Extraktverarbeitung ausgeführtes Skript. Nach dem Extrahieren wird eine Datei vorbereitet, die die Job-ID mit dem Suffix |
|
|
Vor dem Hochladen der Datendatei in EPM Cloud ausgeführtes Skript. Bei der in EPM Cloud hochgeladenen Datei handelt es sich um die Datei |
|
|
Nach dem Hochladen der Datendatei in EPM Cloud ausgeführtes Skript. |
Hinweis:
Informationen zuBefExport
- 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.