Ordner oder Dokumente in Oracle Content and Experience Cloud mit Prozess in Oracle Integration Cloud erstellen

Mit dem Ereignis Dokumentstart können Sie einen Prozess modellieren, der von einem Dokument initiiert werden kann. Mit dem Ereignis Ordnerstart können Sie einen Prozess modellieren, der von einem Ordner initiiert werden kann.

Bevor Sie einen dieser Prozesse erstellen können, benötigen Sie einen Oracle Content Management-Account. Außerdem müssen Sie eine Verbindung zwischen diesem Service und Oracle Integration konfigurieren.

Durch Aktivieren der Oracle Content Management-Integration können Sie Ordner definieren, die automatisch in Oracle Content Management für jede Prozessinstanz erstellt werden und eine vordefinierte Organisation der beteiligten Dokumente bereitstellen. Sie können den Zugriffstyp auch auf Aufgabenebene überschreiben, um basierend auf Ihren Geschäftsanforderungen die richtigen Berechtigungen für den Ordner oder das Dokument für eine bestimmte Aufgabe zu definieren. Beispiel: Sie können verhindern, dass Benutzer ein klassifiziertes Dokument oder einen klassifizierten Ordner anzeigen, der einer Aufgabe zugeordnet ist.

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

Um einen Prozess starten zu können, muss der Oracle Content Management-Benutzer, der in Oracle Integration konfiguriert ist, vollständigen Zugriff auf den Ordner (d.h. den Ordner des eingehenden Dokuments) haben, der in Oracle Content Management konfiguriert ist.
Bei einem von einem Ordner initiierten Prozess (d.h. einem Prozess mit dem Ereignis Ordnerstart) muss der Oracle Content Management-Benutzer, der in Oracle Integration konfiguriert ist, Managerzugriff auf den Ordner haben, damit er in Oracle Integration darauf zugreifen kann. Beispiel: Der Managerzugriff ist erforderlich, um den Ordner auf der Seite "Aufgabendetails" und der Seite "Prozessüberwachung" anzuzeigen, um den Ordner beim Einbetten von Komponenten der Prozess-UI in eine externe Anwendung aufzurufen 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.

So entwerfen Sie einen Prozess, der von einem Dokument oder Ordner gestartet werden kann:

Definieren Sie das eingehende Dokument oder den eingehenden Ordner in Oracle Integration.
Modellieren Sie einen Prozess mit einem Dokumentstartereignis oder einem Ordnerstartereignis.
Passen Sie die Implementierung an, um das Startereignis dem entsprechenden eingehenden Dokument oder Ordner zuzuordnen, das Sie erstellt haben. Mit Implementierungsoptionen können Sie definieren, wie das Dokument oder der Ordner Benutzern angezeigt wird.
Ändern Sie optional, welche Rolle auf Aufgabenebene auf das Dokument oder den Ordner zugreifen kann.
Konfigurieren Sie den Ordner in Oracle Content Management, um einen Prozess zu starten, wenn ein Dokument eingeht.

Alternativ können Sie die REST-API verwenden und alle Eingabewerte angeben.

Eingehende Dokumente oder Ordner definieren

Auf der Seite Dokumente in Oracle Integration (Process Builder) können Sie ein eingehendes Dokument oder einen eingehenden Ordner definieren.

Öffnen Sie die Prozessanwendung, die Sie modellieren, und klicken Sie auf Dokumente. Auf der Seite "Dokumente" werden die eingehenden Dokumente und eingehenden Ordner aufgeführt, die bereits definiert wurden.

Um ein neues eingehendes Dokument oder einen neuen Ordner zu erstellen, klicken Sie auf Neu , wählen Sie den entsprechenden Typ aus, geben einen Namen ein und wählen die Standardzugriffsberechtigung aus.

Modellprozesse, die mit den Startereignissen für Dokumente oder Ordner gestartet werden können

Sie können einen Prozess in Oracle Integration modellieren, der von einem Dokumentstart oder einem Ordnerstartereignis gestartet werden kann.

Bevor Sie beginnen, fügen Sie das Startereignis für das Dokument oder den Ordner aus der Elementpalette hinzu. Nur das erste Startereignis, das Sie einem Prozess hinzufügen, wird unterstützt.

Klicken Sie in der Registerkarte "Anwendungs-Home" auf Prozesse.
Klicken Sie auf Neuer Prozess , um das Dialogfeld "Prozess erstellen" zu öffnen.
Wählen Sie Kein Wert aus
Geben Sie einen Namen für den Prozess ein. Stellen Sie sicher, dass das Kontrollkästchen Sofort öffnen aktiviert ist, und klicken Sie auf Erstellen.
Klicken Sie in der Elements Palette auf Ereignisse.
Ziehen Sie entweder das Ereignis Dokumentstart oder das Ereignis Ordnerstart auf die Leinwand.
Fügen Sie dem Endereignis einen Sequenzfluss aus dem neuen Dokument- oder Ordnerstartereignis hinzu.
Löschen Sie das leere Startereignis.
Fahren Sie mit der Bearbeitung und Definition des Prozesses fort. Sie müssen sie testen und bereitstellen.

Benutzerrollen zum Starten eines vom Dokument oder Ordner initiierten Prozesses aktivieren

Sie können bestimmte Benutzerrollen aktivieren, um einen vom Dokument oder Ordner initiierten Prozess in Oracle Integration zu starten.

So aktivieren Sie eine Benutzerrolle, um ein Dokument zum Starten eines Prozesses hochzuladen:

Öffnen Sie den Prozess.
Klicken Sie im Swimlane mit dem Dokument- oder Ordnerstartereignis auf den Rollennamen, und klicken Sie dann auf Bearbeiten .
Wählen Sie im Feld Rolle die Option Automatischer Handler.

Von Dokumenten oder Ordnern initiierte Prozesse anpassen

Nachdem Sie einen Prozess in Oracle Integration modelliert haben, können Sie ein Startdokument oder einen Ordner in einem Prozess hinzufügen und es anpassen.

So passen Sie einen vom Dokument oder Ordner initiierten Prozess an:

Klicken Sie im Prozessdiagramm auf das Ereignis Dokumentstart oder Ordnerstart.
Klicken Sie auf Menü, und wählen Sie Eigenschaften öffnen aus.
Definieren Sie, wie das eingehende Dokument oder der eingehende Ordner behandelt werden soll.
- In Bearbeitung: Wenn Sie diesen Wert auswählen, bleibt der Speicherort des Dokuments unverändert. Bei Bedarf können Sie das eingehende Dokument oder den eingehenden Ordner einem der vordefinierten Dokumente oder Ordner für die Verwaltung zuordnen. (Öffnen Sie dazu die Dropdown-Liste.)
  
  Wenn für diesen bestimmten Prozess kein vordefiniertes eingehendes Dokument oder Ordner vorhanden ist, klicken Sie auf Neu , um ein Dokument zu erstellen.
- Nicht verwaltet: Das Dokument oder der Ordner wird vom aktuellen Prozess ignoriert. Oracle Integration Cloud zeigt zur Laufzeit kein nicht verwaltetes Dokument oder Ordner an. Der Prozessmodellierer kann das eingehende Dokument oder den eingehenden Ordner verarbeiten. Beispiel: Wenn Sie den eingehenden Ordner oder das eingehende Dokument in einen anderen Speicherort verschieben möchten, können Sie mit einem XPath-Ausdruck Eigenschaften wie Id oder Type abrufen und die Eigenschaftsinformationen an einen REST-Service übergeben.

Ordner konfigurieren

Um einen Prozess so festzulegen, dass er automatisch gestartet wird, wenn ein Dokument in einen Ordner hochgeladen wird, müssen Sie den Ordner in Oracle Content Management konfigurieren.

So konfigurieren Sie den Ordner so, dass ein Prozess beim Eintreffen eines Dokuments gestartet wird:

Melden Sie sich bei Oracle Content Management an.
Wählen Sie den Ordner aus.
Wählen Sie Eigenschaften aus der Menüleiste aus.
Aktivieren Sie die Einstellung Prozess bei Dokumenteingang starten.
Wählen Sie den Prozess aus der Liste.
Klicken Sie auf Speichern.

Der Ordner und seine Unterordner können jetzt auf der Oracle Integration-Oberfläche verwendet werden. Jede Änderung einer Datei im Ordner oder einer neuen Datei, die in den Ordner hochgeladen wurde, löst den mit dem Ordner verknüpften Prozess aus. Sie können den vererbten Prozess für einen Unterordner außer Kraft setzen, nicht jedoch die Verknüpfung mit einem Prozess deaktivieren.

Wenn eine Datei aus Oracle Content Management in einen Ordner hochgeladen wird, der zur Verwendung mit Oracle Integration konfiguriert ist, wird die Datei für die Aufgabe verwendet, die diesem Ordner zugeordnet ist. Benutzer in Oracle Integration können dort Aktionen für die Dateien ausführen, z.B. Genehmigungen. Wenn ein Aufgabenschritt abgeschlossen ist, kann die Datei entsprechend dem definierten Prozess verschoben oder verwaltet werden.

Wenn Oracle Content Management einen Prozess startet, enthält die zum Starten des Prozesses gesendete Payload folgende Informationen:

Dokument-ID
Dokumentname
ID des Benutzers, der den Prozess gestartet hat
Typ
Rolle (gibt die Rolle an, die zum Generieren von nachfolgenden Anwendungslinks verwendet werden soll)
Version

Im folgenden Beispiel werden nur die Dokument-ID und der Dokumentname zur Anzeige im Formular in Oracle Integration verwendet. Außerdem wird die Dokument-ID verwendet, wenn REST-API-Aufrufe ausgeführt werden, um die Datei in Oracle Content Management in den Aufgabenordner zu verschieben oder zu kopieren.

{
   "processDefId":"testing~UserFileApproval!1.0~FormApprovalProcess",
   "operation": "startEvent",
   "params": {
        "id": "D2806600E495B744E66BF3981212FF6185DE89BE6812",
        "type": "d",
        "name": "document-name",
        "startedBy": "user-id",
        "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:

Der Prozess muss ein Oracle Content Management-Startereignis verwenden.
Wenn Sie den Prozess bereitstellen, müssen Sie ihn für den Benutzer freigeben, der für die Aktivierung der Integration angegeben ist. Andernfalls ist der Benutzer nicht berechtigt, den Prozess auszulösen.
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.
Wenn Sie die Prozessintegration für einen Ordner aktivieren, müssen Sie diesen Ordner mit dem Oracle Content Management-Benutzeraccount teilen, mit dem die Integration in Oracle Integration aktiviert wurde.