Benutzerdefinierte Integrationen vom Typ "Ereignisüberwachung" erstellen

In Task Manager können Sie eine Ereignisüberwachungsintegration für eine externe Anwendung erstellen. Die Integration vom Typ "Ereignisüberwachung" wird ausgelöst, wenn ein externes Ereignis in einem anderen Cloud-Service oder einer On-Premise-Anwendung auftritt. Ein Beispiel für eine Integration vom Typ "Ereignisüberwachung" ist ein Trigger aus Oracle E-Business Suite - General Ledger, wenn eine Periode, z.B. Januar 2018, geschlossen wird.

Stellen Sie sicher, dass Sie die Voraussetzungen erfüllen, und führen Sie diese Schritte aus, um eine Integration zwischen Task Manager und einer externen Anwendung einzurichten.

Einen Überblick über den benutzerdefinierten Integrationsfluss finden Sie unter Benutzerdefinierte Integrationen erstellen.

Voraussetzungen

Hinweis:

Die Ereignisüberwachung kann auch durch ein beliebiges Integrationstool ausgelöst werden, das REST-APIs aufrufen kann. In diesem Fall müssen die nachstehenden Voraussetzungen nicht erfüllt sein.

Um Task Manager mit einer externen Anwendung zu integrieren, benötigen Sie Folgendes:
  • Ein Abonnement für Oracle Integration Cloud Service, zur Integration mit On-Premise- und Nicht-EPM Cloud-Services.

    Hinweis:

    Sie benötigen eine Integration Cloud-Instanz pro Oracle EPM Cloud-Instanz.
  • Die externe Anwendung muss eingerichtet sein.
  1. Abonnieren Sie Oracle Integration Cloud/Oracle Autonomous Integration Cloud. Ausführliche Informationen finden Sie unter Integration Cloud Service-Dokumentation .
  2. Installieren Sie Integration Cloud Agent in Ihrer Anwendungsumgebung, um mit der Oracle EPM Cloud-Instanz zu kommunizieren. Details zum Einrichten des Integration Cloud-Agents finden Sie unter Agent-Gruppen verwalten.

    Hinweis:

    Wenn die On-Premise-Anwendungsservices in einer Umgebung bereitgestellt werden, die in einer DMZ-(Demilitarized Zone-)Konfiguration so eingerichtet ist, dass ein öffentlicher Zugriff auf diese Services über das Internet möglich ist, müssen Sie Integration Cloud Agent nicht installieren.

Integrationen in Task Manager einrichten

  1. Klicken Sie auf der Homepage auf Anwendung, Task Manager.
  2. Klicken Sie auf die Registerkarte Integrationen auf der linken Seite, und klicken Sie auf Neu.
  3. Geben Sie auf der Registerkarte Eigenschaften die erforderlichen Informationen an:

    1. Geben Sie unter Name einen Namen für die Integration ein.

    2. Geben Sie unter Code einen Integrationscode für die Integrationsaufgabe ein.

      Der Code wird zur Ausführung der Integration und zur Zuordnung von Aktualisierungen zu einer Integration aus einem Dateiimport verwendet.

    3. Optional: Geben Sie unter Beschreibung eine Beschreibung für die Integrationsaufgabe ein.

    4. Wählen Sie für Verbindung eine Anwendung aus, zu der die Aufgabe gehört.

      Sie können die Liste der Anwendungen im Dialogfeld "Verbindungen verwalten" über das Symbol "Verbindungen verwalten" verwalten.

    5. Wählen Sie für Ausführungstyp die Option Ereignisüberwachung aus.

    6. Geben Sie für Ereignisname einen Namen für das Ereignis ein.

  5. Klicken Sie in der Registerkarte Parameter auf Neu , und geben Sie die erforderlichen Informationen an:

    1. Geben Sie für Name einen Namen für den Parameter ein.

    2. Geben Sie für Parametercode einen Parametercode ein.

    3. Optional: Geben Sie eine QuickInfo für den Parameter ein.

    4. Wählen Sie in der Liste Parametertyp einen Typ aus, und geben Sie zusätzliche Informationen für den Parameter ein:

      • Kontrollkästchen: Boolescher Wert

      • Datum: Datumswert

      • Ganzzahl: Numerischer Wert in ganzen Zahlen

      • Zahl: Numerischer Wert in ganzen Zahlen oder Brüchen

      • Optionengruppe: Kontrollkästchen für ein vordefiniertes Werteset

      • Statische Liste: Vordefiniertes Set von Textwerten

      • Aufgabeninformationen: Aufgabeninformationen, z.B. Bearbeiter, Dauer, Start- und Enddatum

      • Text: Wert für Freiformtext

      • EPM-Artefakt: Name des Artefakts, z.B. Formular oder Bericht

    5. Wenn für den Parameter ein Wert eingegeben werden muss, wählen Sie Erforderlich aus.

    6. Klicken Sie zum Speichern des Parameters auf OK.

    7. Klicken Sie zum Speichern der Integration auf Speichern und schließen.

Aufgabentypen für die Integration erstellen

  1. Klicken Sie auf der Homepage auf Anwendung, Task Manager.

  2. Klicken Sie links auf die Registerkarte Aufgabentypen.

  3. Klicken Sie auf Neu.

  4. Geben Sie in der Registerkarte Eigenschaften einen Namen für den Aufgabentyp und eine Aufgabentyp-ID an.

  5. Klicken Sie unter Integration auf Suchen, wählen Sie die Integration aus, und klicken Sie auf OK.

  6. Legen Sie auf der Registerkarte Parameter die Parameter für den Aufgabentyp fest.

Integration Cloud-Verbindung in Task Manager einrichten

Task Manager verwendet Oracle Integration Cloud für alle Integrationen in externe Anwendungen. In Task Manager können Sie eine Verbindung zu Oracle Integration Cloud mit Basisauthentifizierung oder OAuth 2.0-Authentifizierung einrichten.

Hinweis:

  • Für Oracle Integration Cloud Generation 2 werden Basisauthentifizierung und OAuth 2.0 unterstützt.
  • For Oracle Integration Cloud Generation 3 wird nur OAuth 2.0 unterstützt.
  • Für die Basisauthentifizierung benötigt der Benutzer die Rolle "Serviceadministrator" für Oracle Integration Cloud.
  • Für OAuth 2.0 werden nur Clientzugangsdaten unterstützt. Die OAuth 2.0-Clientanwendung benötigt die Rolle "Serviceadministrator" für Integration Cloud, und der zulässige Geltungsbereich muss "Alle" lauten.

Stellen Sie vor der Einrichtung der OAuth 2.0-Verbindung sicher, dass Sie die Clientzugangsdaten wie Zugriffstoken-URL, Client-ID, Client Secret und Geltungsbereich zur Hand haben. Informationen zum Einrichten der OAuth-Clientanwendung finden Sie unter OAuth-Authentifizierung in Oracle Integration in der Dokumentation zu Oracle Integration Cloud der 3. Generation.

So richten Sie die Integration Cloud-Verbindung in Task Manager ein:

  1. Klicken Sie auf der Homepage auf Anwendung, Task Manager.

  2. Klicken Sie links auf die Registerkarte Integrationen.

  3. Klicken Sie auf Verbindungen verwalten, und wählen Sie unter Aktionen die Option Integration Cloud-Verbindung aus.
  4. Wählen Sie einen der folgenden Authentifizierungsmechanismen aus:
    • Basisauthentifizierung: Geben Sie die Integration Cloud-URL, die Benutzer-ID des Serviceadministrators und das Kennwort an.
    • OAuth 2.0: Geben Sie die Integration Cloud-URL, die Zugriffstoken-URL, die Client-ID, das Client Secret und den Geltungsbereich an.

    Hinweis:

    Geben Sie die URL ein: https://<SERVICE_NAME>-<TENANT_NAME>.integration.ocp.oraclecloud.com
  5. Klicken Sie auf Validieren. Nachdem die Validierung erfolgreich war, klicken Sie auf Speichern. Dadurch werden der Server und die Zugangsdaten der Verbindung gespeichert.

Integrationen in Integration Cloud einrichten

Hinweis:

Wenn Sie nicht vorhaben, Integration Cloud zu verwenden, überspringen Sie diesen Schritt.

So richten Sie die Integration in Integration Cloud ein:

  1. Melden Sie sich bei Integration Cloud an.
  2. Erstellen Sie mit dem Oracle Enterprise Performance Management Cloud-Adapter eine Verbindung zum EPM-Service. Weitere Einzelheiten finden Sie unter dem folgenden Link: Verbindung zu Oracle Enterprise Performance Management Cloud erstellen.
  3. Erstellen Sie nach Bedarf eine oder mehrere Verbindungen zu der anderen Anwendung.
  4. Erstellen Sie mit den erstellten Verbindungen eine Integration zur Ereignisüberwachung, und aktivieren Sie sie. Weitere Informationen finden Sie im folgenden Beispiel: Oracle Enterprise Performance Management Cloud-Adapter mit Oracle Integration verwenden.

Die Integration ohne Integration Cloud einrichten

Hinweis:

Wenn Sie vorhaben, Integration Cloud zu verwenden, überspringen Sie diesen Schritt.
Konfigurieren Sie das Integrationstool, das Sie verwenden möchten.

1. Überprüfen Sie die REST-API, Aufgabenstatus für Ereignisüberwachung aktualisieren unter REST-API für Oracle Enterprise Performance Management Cloud.

2. Konfigurieren Sie das Integrationstool, um die REST-API zum Abschließen der Ereignisüberwachungsaufgabe mit der Übergabe der Parameter für das Ereignis abzurufen.

Informationen hierzu finden Sie unter Aufgabenstatus für Ereignisüberwachung aktualisieren in der Dokumentation REST-API für Oracle Enterprise Performance Management Cloud.

Integrationssetups in Task Manager abschließen

Führen Sie die folgenden Schritte aus, um das Integrationssetup in Task Manager abzuschließen.

  1. Klicken Sie auf der Homepage auf Anwendung, Task Manager.
  2. Klicken Sie auf die Registerkarte Integrationen auf der linken Seite, und prüfen Sie, ob die neue Integration angezeigt wird.
  3. Klicken Sie in Task Manager auf Zeitpläne, und erstellen Sie einen neuen Zeitplan mit dem Status "Anstehend". Informationen hierzu finden Sie unter Zeitpläne manuell erstellen.
  4. Erstellen Sie die Aufgabe zur Ereignisüberwachung, und fügen Sie sie dem Zeitplan hinzu. Informationen hierzu finden Sie unter Aufgaben erstellen.
  5. Wählen Sie unter Zeitpläne den Zeitplan aus, und öffnen Sie ihn.
  6. Lösen Sie die Aktion aus, die das Ereignis in der externen Anwendung (z.B. EBS) generiert. Wenn Sie anstelle von Integration Cloud ein anderes Integrationstool verwenden, rufen Sie die REST-API über das Integrationstool auf.

    Hinweis:

    Übergeben Sie die erwarteten Parameter abhängig vom Integrationstyp, vom Ereignis und von den Parametern. Bei fehlender Übereinstimmung wird die Aufgabe nicht berücksichtigt.
  7. Warten Sie, bis die Aufgabe abgeschlossen ist.
  8. Optional: Um den Status der Integration in Integration Cloud Services zu überwachen, melden Sie sich bei Integration Cloud an, und navigieren Sie zu Überwachung.