Prozessintegration zwischen Oracle Integration und Oracle Content Management konfigurieren

Bevor Sie oder Benutzer auf Dokument- und Unterhaltungsfeatures zugreifen können, muss ein Administrator Einstellungen in Oracle Content Management und Oracle Integration konfigurieren.

Nur ein Benutzer mit Administratorberechtigungen kann eine Verbindung zwischen den beiden Services herstellen.

Für Prozessanwendungen, die erstellt wurden, bevor die Verbindung mit Oracle Content Management konfiguriert wurde, sind die Dokument- und Unterhaltungsfunktionen standardmäßig deaktiviert. Entwickler können diese Features in ihren vorhandenen Anwendungen manuell aktivieren.

Zugriffsanforderungen für eine erfolgreiche Integration

Beachten Sie die folgenden Zugriffsanforderungen für eine erfolgreiche Integration:

Der Oracle Content Management-Benutzer, der in Oracle Integration konfiguriert ist, muss vollständigen Zugriff auf den Ordner (d.h. den Ordner des eingehenden Dokuments) haben, der in Oracle Content Management konfiguriert ist, um einen Prozess starten zu können.
Bei einem von einem Ordner initiierten Prozess (d.h. einem Prozess mit dem Ereignis Ordnerstart) muss der in Oracle Integration konfigurierte Oracle Content Management-Benutzer Managerzugriff auf den Ordner haben, um auf seinen Ordner in Oracle Integration zugreifen zu können. Beispiel: Der Managerzugriff ist erforderlich, um den Ordner auf der Seite "Aufgabendetails" und der Seite "Prozessüberwachung" anzuzeigen, um beim Einbetten von Komponenten der Prozess-UI in eine externe Anwendung auf den Ordner zuzugreifen oder den Ordner in der Process Mobile-Anwendung anzuzeigen.
Um einen Prozess in der Prozessliste für einen Ordner anzuzeigen und eine Prozessinstanz beim Eintreffen eines neuen Dokuments initiieren zu können, muss dem Oracle Integration-Benutzer, der in Oracle Content Management konfiguriert ist, die Prozessinitiatorrolle erteilt werden.

Dokumente oder Anhänge in einer Prozessanwendung verwenden

Oracle Integration enthält in Ihren Prozessanwendungen automatisch die Standardfunktionalität für Dateianhänge. Sie können Dateien hochladen und an einen Prozess anhängen. Wenn Sie Oracle Content Management mit Oracle Integration verwenden, erhalten Sie auch die Funktion Dokumente, mit der Sie Dateien hochladen, Dateien in Ordner organisieren, den Zugriff auf jeden Ordner verwalten und sogar einen Prozess starten können, indem Sie ein Dokument hochladen. Darüber hinaus kann jede Prozessanwendung Dokumente oder Anhänge verwenden.

Sie steuern, ob ein Prozess Dokumente oder Anhänge auf Anwendungsebene verwendet. Dokumente sind standardmäßig aktiviert. Die Einstellung befindet sich im Bereich "Informationen" für die Anwendung.

Beschreibung von enable-docs-app-level-cb.png folgt
Beschreibung der Abbildung enable-docs-app-level-cb.png

Eine Anwendung, für die Dokumentintegration aktiviert ist, kann Dokumente (und nur Dokumente) verwenden. Eine Anwendung mit deaktivierter Dokumentintegration kann nur Anhänge verwenden. Wenn Sie Dokumente für eine Anwendung deaktivieren, aktivieren Sie Anhänge für diese Anwendung.

Beachten Sie, dass die Einstellung für die Anwendung gilt. Sie können Dokumente oder Anhänge in einer Anwendung verwenden, jedoch nicht beides.

Stellen Sie bei Anhängen sicher, dass die Option Anhänge ausblenden im Fenster "UI-Anpassung" deaktiviert ist. Wenn die Option Anhänge ausblenden ausgewählt ist, können Sie keine Anhänge in Aufgabendetails und Startformularen anzeigen.

Wenn Sie REST-APIs für die Interaktion mit Oracle Integration verwenden, müssen Sie die entsprechende API verwenden, je nachdem, ob Ihre Prozessanwendung Dokumente oder Anhänge verwendet:

Verwenden Sie für Dokumente die /folders-REST-APIs.
Verwenden Sie für Anhänge unbedingt die /attachments-REST-APIs.

Wenn Sie die falsche API verwenden, gibt die Anwendung entweder eine Fehlermeldung zurück oder endet ohne Vorgang.

Wenn Sie keine Anhänge in Aufgabendetails anzeigen können, prüfen Sie die Optionen im Fenster "UI-Anpassung". Stellen Sie sicher, dass das Kontrollkästchen Anhänge ausblenden deaktiviert ist, um Anhänge anzuzeigen.

Oracle Integration-Einstellungen in Oracle Content Management konfigurieren

Aktivieren Sie Oracle Integration für Dokumente in Oracle Content Management.

Melden Sie sich als Administrator bei Oracle Content Management an.
Wählen Sie im Menü Administration die Option Integrationen.
Wählen Sie unter Anwendungen die Option Oracle Integration aus, um den Service zu aktivieren, und legen Sie dann die folgenden Werte fest:
- Service-URL: Die URL des REST-Service, auf die Benutzer für ihre Anwendungen zugreifen können. Sie endet auf bpm/api/4.0/processes (Beispiel: https://servicename/bpm/api/4.0/processes).
- Servicebenutzer: Geben Sie die E-Mail-Adresse des Benutzers ein, dessen Eigentümer der Prozess ist, der in Oracle Content Management verwendet werden soll.
- Servicekennwort: Geben Sie das Benutzerkennwort ein.

Wenn ein Aufgabenschritt abgeschlossen ist, kann die Datei entsprechend dem definierten Prozess verwaltet werden. Bei einem eingehenden Dokument kann ein Benutzer Aktionen basierend auf der zugewiesenen Rolle für dieses Dokument ausführen: Beitragender, Downloader oder Viewer.

Wenn Oracle Content Management einen Prozess startet, wird die folgende Payload gesendet, um den Prozess zu starten:

{

        "operation":"startEvent",

        "processDefId":"testing~LoanApplicationProcessing!1.0~LoanApplicationProcessing"

        "params": {

               "id": "abc123",

               "name": "document name",

               "startedBy": "user id",

               "type": "d",

               "role": "role that should be used to generate subsequent applinks",

                "version": "version"

         }

}

Als Entwickler müssen Sie die folgenden Anforderungen für den von Ihnen entwickelten Prozess berücksichtigen:

Es muss sich um einen Prozess handeln, der ein Oracle Content Management-Dokumentstartereignis verwendet.
Wenn Sie den Prozess bereitstellen, müssen Sie ihn für den Benutzer freigeben, der für die Aktivierung der Integration angegeben ist, damit der Benutzer über die Rechte zum Auslösen des Prozesses verfügt.
Damit der Benutzer, der die Datei hochgeladen hat, als der Benutzer angezeigt wird, der die Aufgabe gestartet hat, muss der Prozess den Wert verwenden, der im Feld Startedby als Anzeigename für den Initiator übergeben wurde.

Dokumenteinstellungen in Oracle Integration konfigurieren

Als Administrator müssen Sie auch die Verbindung zwischen Oracle Integration und Oracle Content Management konfigurieren. Sie müssen Informationen wie die URL und die Anmeldedaten für Oracle Content Management eingeben.

So konfigurieren Sie die Einstellungen in Oracle Integration:

Klicken Sie im Navigationsbereich von Oracle Integration auf Meine Aufgaben, Workspace und dann auf Administration.
Klicken Sie auf Services.
Geben Sie im Abschnitt Oracle Content Management die folgenden Informationen ein:
- URL: Die Webadresse Ihres Oracle Content Management. Ihr Serviceadministrator erhält eine Willkommens-E-Mail an Oracle Cloud, wenn der Service verwendet werden kann. Die E-Mail enthält die URL für Oracle Content Management. Beispiel: https://your_service_name.com/documents.
- Identitätsdomain: Der Name der Identitätsdomain, zu der Ihre Oracle Content Management gehört. Sie können eine Verbindung zu Oracle Content Management (für das Dokumentfeature) erfolgreich konfigurieren, ohne eine Identitätsdomain anzugeben.
- Benutzer und Kennwort: Die Accountzugangsdaten für einen Benutzer, der Zugriff auf Oracle Content Management hat. Mit diesem Benutzeraccount wird die Verbindung zwischen den Services getestet. Es wird auch während der Laufzeit verwendet, um eine Verbindung zu den Services herzustellen und alle Laufzeitvorgänge auszuführen, wie z.B. das Erstellen von Ordnern.
Wichtig:

Wenn Sie mit Unterhaltungen zusammenarbeiten möchten, muss dem hier angegebenen Benutzer die folgende Rolle zugewiesen werden:

service_instance_name.CECIntegrationUser

Mit der Oracle Cloud-Anwendung "Meine Services" können Sie Ihren Benutzern Rollen zuweisen.
Klicken Sie auf Test.

Wenn Sie Änderungen an den Konfigurationseinstellungen vornehmen, sollten Sie prüfen, ob die eingegebenen Werte korrekt sind. Sie möchten bestätigen, dass eine erfolgreiche Verbindung mit Oracle Content Management hergestellt wurde.

Prüfen Sie die Testergebnisse, die Meldungen, Fehler und Warnungen enthalten können.
Wählen Sie eine der folgenden Optionen aus, um fortzufahren:
- Wenn Fehler oder Warnungen vorliegen, nehmen Sie die erforderlichen Änderungen vor, und klicken Sie erneut auf Test, um die neuen Werte zu prüfen. Wiederholen Sie den Test bei jeder Änderung der Einstellungen.
- Wenn der Verbindungstest erfolgreich war, klicken Sie auf Speichern, um die Konfigurationseinstellungen zu speichern.
- Wenn Sie abbrechen und zu den zuletzt gespeicherten Werten zurückkehren möchten, klicken Sie auf Wiederherstellen.