Weitere Informationen zu dieser Empfehlung finden Sie unter Upgrade - Häufig gestellte Fragen.

1. Erstellen Sie eine neue Standalone-Instanz von OCI Process Automation.

   Siehe Process Automation-Instanz bereitstellen in Oracle Cloud Infrastructure Process Automation verwalten.

   Wenn Sie die Instanz erstellen:

   • Wählen Sie ein auf einem Ausführungspaket basierendes Messmodell aus, um während des Upgrades die kostenlosen Stufenpreise zu nutzen.
   • Der Benutzer, der die OCI Process Automation-Standalone-Instanz erstellt, muss aus derselben Identitätsdomain stammen wie der Benutzer, der die Oracle Integration-Instanz der 2. Generation erstellt hat.
   • Sie müssen die Standalone-Instanz von OCI Process Automation im selben Mandanten, in derselben Region und vorzugsweise im selben Compartment wie Ihre Oracle Integration-Instanz der 2. Generation erstellen.

     Wenn Sie nicht dasselbe Compartment verwenden, stellen Sie sicher, dass der Benutzer, der die OCI Process Automation-Instanz erstellt, über Berechtigungen zum Verwalten der Oracle Integration-Instanz und der OCI Process Automation-Instanz verfügt.

     Sie verwalten diese Berechtigungen mit IAM-Policys.

     Für Oracle Integration:

     • allow group domain-name/group_name to manage integration-instance in compartment compartment-name
     • allow group domain-name/group_name to manage integration-instance in tenancy

     Beispiel:

     • allow group admin/oci-integration-admins to manage integration-instance in tenancy

     Für OCI Process Automation:

     • allow group domain-name/group_name to manage process-automation-instance in compartment compartment-name
     • allow group domain-name/group_name to manage process-automation-instance in tenancy

     Beispiel:

     • allow group admin/oci-integration-admins to manage process-automation-instance in tenancy
2. Erteilen Sie Entwicklern Zugriff auf OCI Process Automation.

   Um sicherzustellen, dass Ihre Entwickler auf die neu bereitgestellte OCI Process Automation-Instanz zugreifen und an nachfolgenden Aufgaben arbeiten können, stellen Sie sicher, dass ihnen die entsprechende Anwendungsrolle für den Zugriff auf die Instanz zugewiesen ist. Siehe Anwendungsrollen Gruppen in einer Identitätsdomain zuweisen in Oracle Cloud Infrastructure Process Automation verwalten.

3. Registrieren Sie eine Nicht-Produktions-Oracle Integration-Instanz der 2. Generation zum Testen.

   Wenn Ihre Prozessanwendungen vorhandene Integrationen aufrufen, registrieren Sie Oracle Integration der 2. Generation in der neuen OCI Process Automation-Instanz. Auf diese Weise kann Ihre OCI Process Automation-Instanz Ihre vorhandenen Integrationen verbinden und ermitteln.

   Stellen Sie sicher, dass Sie in diesem Schritt eine Oracle Integration-Instanz der 2. Generation der Nicht-Produktions für die Serviceregistrierung verwenden. Stellen Sie sicher, dass sich die Registrierung der ausgewählten Oracle Integration-Instanz der 2. Generation nicht negativ auf Prozesse in der Produktion auswirkt.

   1. Wählen Sie eine Nicht-Produktions-Oracle Integration-Instanz der 2. Generation zum Registrieren aus.
   2. Suchen Sie in der Oracle Cloud Infrastructure-Konsole die OCID der ausgewählten Oracle Integration-Instanz der 2. Generation, und beachten Sie sie.
   3. Registrieren Sie in OCI Process Automation die Oracle Integration-Instanz der 2. Generation. Siehe Services registrieren in Oracle Cloud Infrastructure Process Automation verwenden.
      Hinweis
      
      Sie können einen dedizierten ServiceAccount-Benutzer für diese Verbindung erstellen.

1. Festlegen, welche Anwendungen migriert werden sollen.

   Sie können diese Gelegenheit nutzen, um unnötige Anwendungen loszuwerden. Überlegen Sie, ob Sie nur die Anwendungen migrieren möchten, die sich in Ihrer Produktionsumgebung befinden, oder ob Sie auch Anwendungen migrieren möchten, die getestet und entwickelt werden.

   Wenn Sie einzelne Anwendungen migrieren möchten, beachten Sie die Anwendungen, die Sie migrieren möchten, und alle Abhängigkeiten, die sie haben.

2. Migrieren Sie Ihre Anwendungen mit einer der folgenden Methoden:
   • Alle Anwendungen im Bulkverfahren migrieren
     1. Erstellen Sie in der Oracle Cloud Infrastructure-Konsole einen Objektspeicher-Bucket. Siehe Object Storage-Bucket erstellen.

        Die Speicher-Bucket-URL, die Sie im nächsten Schritt benötigen, hat das folgende Format:

        https://swiftobjectstorage.region.oraclecloud.com/v1/namespace/bucket

        Dabei gilt:

        • region ist die ID Ihres Oracle Cloud Infrastructure-(OCI-)Data Centers.
        • namespace ist der Mandant, in dem Sie den Bucket erstellt haben.
        • bucket ist Ihr Bucket-Name.
     2. Erstellen Sie eine POST-Anforderung an die Oracle Integration-Instanz der 2. Generation, um Ihre Anwendungen zu exportieren:

        curl -X POST https://Generation2_hostname/ic/api/process/v1/exportArtifactsInternal

        Mit der folgenden Payload:

        {
            "jobId": "enter_a_descriptive_ID",
            "storageInfo": {
                "storageUrl": "Swift_storage_bucket_URL",
                "storageUser": "OCI_Console_user",
                "storagePassword": "OCI_Console_user_password"
            }
        }

        Sie wissen, dass der Exportjob abgeschlossen ist, wenn die Datei process_status.json in Ihrem Bucket angezeigt wird. Diese Datei enthält den Status des Jobs, seinen Abschluss in Prozent und, falls er nicht erfolgreich war, die Fehlermeldung. Außerdem sollte der folgende Inhalt in Ihrem Bucket angezeigt werden:

        • Process/project folder - Enthält alle Ihre Prozessanwendungen.
        • Process/dmn folder - Enthält alle Ihre Entscheidungsmodelle.
     3. Nachdem die Anwendungen in Ihren Bucket exportiert wurden, erstellen Sie eine POST-Anforderung an die Oracle Integration 3-Instanz, um Ihre Anwendungen zu migrieren:

        curl -X POST https://Integration3_hostname/process/api/v1/oic-migration/jobs/

        Mit Ihrer Mandanten-ID:

        x-tenant-id: tenant_OCID

        Und Ihre Bucket-Informationen:

        {
            "bucketInfo": {
                "region": "region",
                "namespace": "namespace",
                "bucket": "bucket"
            }
        }

        Siehe Sicherheit, Authentifizierung und Autorisierung in REST-API für Oracle Cloud Infrastructure Process Automation.

     4. Warten Sie auf den Abschluss des Migrationsjobs. So prüfen Sie den Status des Migrationsjobs:

        curl http://localhost:8080/process/internal-api/v1/oic-migration/jobs/job_ID

   • Einzelne Anwendungen migrieren
     1. Exportieren Sie die Oracle Integration-Prozessanwendungen der 2. Generation.

        Exportieren Sie in der Oracle Integration-Instanz der 2. Generation, die die zu migrierenden Anwendungen enthält, jede zu migrierende Anwendung. Siehe Anwendung exportieren in Prozesse in Oracle Integration der 2. Generation verwenden.

     2. Importieren Sie die Prozessanwendungen in OCI Process Automation.

        Importieren Sie in OCI Process Automation die Oracle Integration-Prozessanwendungen der 2. Generation. Siehe Anwendung importieren in Oracle Cloud Infrastructure Process Automation verwenden.

        OCI Process Automation konvertiert die Legacy-Prozessanwendungen in die neueste Produktversion.

3. Prüfen Sie den Migrationsbericht.

   Wenn der Import und die Konvertierung abgeschlossen sind, wird ein Migrationsbericht angezeigt, in dem angezeigt wird, was erfolgreich importiert wurde, was zusätzliche Arbeit erfordert und welche Elemente nicht migriert werden konnten. Dies gibt Ihnen eine Vorstellung von Migrationsproblemen, mit denen Sie umgehen müssen.

   Sie können auf den ursprünglichen Migrationsbericht im Hauptmenü zurückgreifen. Siehe Anwendung importieren in Oracle Cloud Infrastructure Process Automation verwenden.

Anwendungsrollen haben sich in OCI Process Automation erheblich geändert. Die Rollen ProcessOwner, AnalyticsViewer und ProcessReviewer sind jetzt explizit für jede Anwendung definiert, sodass Sie ihre Mitglieder und Berechtigungen kontrollieren können.

Die folgende Tabelle zeigt, wie die Oracle Integration-Rollen der 2. Generation den OCI Process Automation-Rollen zugeordnet werden.

Die neuen Rollen sind nach der Migration verfügbar. Sie müssen ihnen jedoch Mitglieder (Benutzer und Gruppen) hinzufügen. Sie müssen wahrscheinlich Ihre Oracle Integration-Umgebung der 2. Generation referenzieren, um zu sehen, welche Elemente jeder Rolle zugewiesen werden sollen.

Wenn OCI Process Automation dieselbe Identitätsdomain wie Ihre vorhandene Oracle Integration-Instanz der 2. Generation verwendet, müssen vorhandene Benutzer und Gruppen zur Auswahl verfügbar sein.

Sie können Elemente entweder vor der Aktivierung im Designer oder nach der Aktivierung im Workspace hinzufügen.

• Mit Rollen in Designer arbeiten
• Rollen im Workspace verwalten

Weitere Informationen zu OCI Process Automation finden Sie unter Rollen für Prozessanwendungen konfigurieren in Oracle Cloud Infrastructure Process Automation verwenden.

Um Prozessanwendungen zu validieren und zu aktivieren, gehen Sie wie folgt vor:

1. Validieren Sie jede Anwendung, und beheben Sie alle Fehler und Warnungen.

   Validieren Sie jede Anwendung im Designer, indem Sie auf klicken und im Menü die Option Validieren auswählen.

   Informationen zum Beheben von Validierungsproblemen finden Sie unter How Upgrade Affects Process Features.

2. Aktivieren Sie die Anwendung.

   Nachdem Sie alle Validierungsfehler behoben haben, können Sie Ihre Anwendung aktivieren. Siehe Anwendungen aktivieren in Oracle Cloud Infrastructure Process Automation verwenden.

• Integrationsaufrufprozess
• Aufgerufene Integrationen nach Prozess
• Visual Builder-Anwendungen
• Nicht-Oracle-Integrationsclients
• Verifizierung

Integrationsaufrufprozess

Prozess-APIs und Endpunkte wurden nach dem Upgrade geändert. Sie müssen die Integration mit dem Prozessautomatisierungsaufrufassistenten neu konfigurieren. Siehe Integration neu konfigurieren.

Aufgerufene Integrationen nach Prozess

OCI Process Automation unterstützt REST-basierte Kommunikation nur über die Serviceregistrierung. Das bedeutet, dass die Konnektivität zu SOAP-basierten Integrationen nicht mehr möglich ist.

Wenn Integrationen einen SOAP-Trigger verwenden und diese von Prozessen in Oracle Integration der 2. Generation aufgerufen werden, müssen Sie zusätzliche Schritte ausführen, um eine REST-basierte Schnittstelle für OCI Process Automation bereitzustellen. Dies kann bedeuten, dass Sie einen der folgenden Schritte ausführen müssen:

• Erstellen Sie REST-basierte Wrapper-Integrationen.

  oder

• Ändern Sie den vorhandenen Trigger von SOAP in REST.

Stellen Sie außerdem sicher, dass der REST-Trigger die Policy OAuth 2.0 oder Basisauthentifizierungssicherheit verwendet, damit die Serviceregistrierung wie erwartet funktioniert.

Visual Builder-Anwendungen

Prozess-API-Endpunkte ändern sich nach dem Upgrade. Daher müssen Sie alle Visual Builder-Anwendungen aktualisieren, die mit ihnen interagieren, und alle veralteten Integrationsmuster ersetzen. Siehe Mit Geschäftsprozessen arbeiten in Responsive Anwendungen mit Visual Builder Studio erstellen.

Dazu müssen Sie möglicherweise die aktuelle Prozessverwendung bewerten. Sehen Sie sich jede Ihrer Visual Builder-Anwendungen an und bestimmen Sie, ob sie APIs über Aktionsketten, direkte Anrufe oder über einbettbare Prozesskomponenten (auch als CCA bezeichnet) verarbeiten.

Wenn Ihre Anwendungen Prozessendpunkte aufrufen, gehen Sie wie folgt vor:

1. Stellen Sie eine Verbindung zu OCI Process Automation her.

   Erstellen Sie eine Backend-Verbindung zu OCI Process Automation. Dieses Backend wird verwendet, um eine Verbindung zur neuen OCI Process Automation-Instanz herzustellen. Siehe Verbindung zu Oracle Process Automation-APIs herstellen in Responsive Anwendungen mit Visual Builder Studio erstellen.

2. Erstellen Sie eine neue Version Ihrer Anwendungen.

   Oracle empfiehlt, eine neue Version Ihrer Visual Builder-Anwendungen zu erstellen, um die erforderlichen Änderungen zu implementieren. Siehe Versionen einer Anwendung erstellen in Anwendungen mit Oracle Visual Builder entwickeln.

3. Aktionsketten

   Wenn Ihre Anwendung Aktionsketten zum Starten eines Prozesses oder zum Ausführen von Aktionen für eine Aufgabe verwendet, müssen Sie diese jeweils durch eine REST-basierte Serviceverbindung ersetzen. Wiederholen Sie diese Schritte für jede Prozessaktionskettenaufgabe.

   Prozesse auslösen

   Ersetzen Sie die Aktionskette "Prozess starten" durch eine katalogbasierte Serviceverbindung.

   1. Navigieren Sie zu Oracle Integration der 2. Generation, und notieren Sie sich den von Ihnen aufgerufenen Prozess. Sie können dies entweder über den Schritt des Aktionskettenprozesses oder über die Registerkarte "Prozesse" im Anwendungsmenü auf der linken Seite bestimmen.
   2. Erstellen Sie eine katalogbasierte Serviceverbindung zu Ihrem Prozess in der neuen Version der Visual Builder-Anwendung. Siehe Serviceverbindung aus einem OCI Process Automation-Katalog erstellen in Responsive Anwendungen mit Visual Builder Studio erstellen. Stellen Sie sicher, dass Sie denselben Prozess auswählen, auf den Sie zuvor verwiesen haben.
      Hinweis
      
      Ihr Prozess sollte bereits aktiviert sein.
   3. Erstellen Sie einen Typ basierend auf dem Endpunkt des obigen Prozesses. Siehe Typ aus einem Endpunkt erstellen in Anwendungen mit Oracle Visual Builder entwickeln.
   4. Erstellen Sie eine Variable basierend auf dem obigen Typ. Siehe Variablen erstellen in Anwendungen mit Oracle Visual Builder entwickeln.
   5. Navigieren Sie zu den Aktionsketten, und führen Sie die folgenden Aktionen aus:
      1. Ziehen Sie eine Aktion "Variable zuweisen" über die aktuelle Aktion "Prozess starten".
      2. Ordnen Sie die Datenfelder und Eingabeparameter zu, die zum Aufrufen des Prozesses erforderlich sind. Ein Beispiel finden Sie unter Oracle Process Automation mit Visual Builder integrieren.
      3. Ziehen Sie die REST-Aktion "Aufruf" über die aktuelle Aktion "Prozess starten".
      4. Konfigurieren Sie die REST-Aktion für Aufrufe, indem Sie den Endpunkt POST/Instances auswählen.
      5. Ordnen Sie die obige Variable dem Anforderungstext der REST-Aktion zu.
      6. Löschen Sie das Legacy-System Start Process Acton.
   6. Testen Sie den Aufruf, und stellen Sie sicher, dass Ihr Prozess in OCI Process Automation erfolgreich aufgerufen wird.

   GET-Prozessinstanz

   Ersetzen Sie die Aktionskette "Prozessinstanz abrufen" durch eine katalogbasierte Serviceverbindung.

   Wenn Sie eine katalogbasierte Serviceverbindung zu Ihrem Prozess erstellt haben, indem Sie die oben genannten Schritte ausführen, werden Sie feststellen, dass der Endpunkt "Prozessinstanz abrufen" jetzt in Ihrer Serviceverbindung verfügbar ist.

   Ersetzen Sie die Legacy-Prozessaktion "Prozessinstanz abrufen" durch eine REST-Aufrufaktion, die mit dem obigen Endpunkt konfiguriert ist, und ordnen Sie das Feld instanceID erneut zu.

   Hinweis
   
   Die Antwort-Payload-Werte hier wurden geändert.

   Andere Prozessaktionen

   Führen Sie für alle anderen Prozessaktionen wie "Aufgabe ausführen" und "Aufgabe abrufen" die folgenden Schritte aus:

   1. Navigieren Sie zu Oracle Integration der 2. Generation, und notieren Sie sich die von Ihnen verwendeten Prozessaktionen.
   2. Ersetzen Sie diese Aktionen durch Endpunkt-basierte Serviceverbindungen.

      In der folgenden Tabelle wird jede dieser Aktionen der entsprechenden OCI Process Automation-API zugeordnet.

      Visual Builder-Aktion	OCI Process Automation-REST-API	Beschreibung
      Aufgabe ausführen	POST /process/api/v1/tasks/{id}/complete	Genehmigungsaktionen wie Genehmigen, Ablehnen usw.
      Aufgabe ausführen	PUT /process/api/v1/tasks/{id}	Aktualisieren Sie die Aufgabenpriorität, Payload, den Titel usw.
      Aufgabe ausführen	PUT /process/api/v1/tasks/{id}/payload	Aktualisieren Sie die Aufgaben-Payload.
      Aufgabe ausführen	POST /process/api/v1/tasks/{id}/claim	Eine Aufgabe behaupten.
      Aufgabe ausführen	POST /process/api/v1/tasks/{id}/release	Geben Sie eine Aufgabe frei.
      Aufgabe ausführen	POST /process/api/v1/tasks/{id}/request-for-info	Anforderung von Informationen für eine Aufgabe.
      Aufgabe ausführen	POST /process/api/v1/tasks/{id}/submit-info	Starten Sie die angeforderten Informationen für eine Aufgabe.
      Aufgabe ausführen	POST /process/api/v1/tasks/{id}/reassign	Aufgabe erneut zuweisen.
      Aufgabenerfassung abrufen	/process/api/v1/tasks abrufen
      Aufgabe abrufen	GET /process/api/v1/tasks/{id}
      Bereitgestellte Prozesserfassung abrufen	/process/api/v1/instances abrufen
      Prozessinstanz-Collection abrufen	POST /process/api/v1/instances

4. Direkte Anrufe

   Prozess-APIs und Endpunkte ändern sich nach dem Upgrade. Daher müssen Sie alle direkten Serviceverbindungen aktualisieren. Siehe REST-API für Oracle Cloud Infrastructure Process Automation.

5. CCA-Komponenten

   Wenn Sie CCA-Komponenten für Oracle Integration-Prozesse der 2. Generation verwenden, müssen Sie diese durch die entsprechende OCI Process Automation-Komponente ersetzen.

   Komponentenname	Oracle Integration - CCA der 2. Generation	OCI Process Automation-Äquivalent
   Aufgabenliste	oj-pcs-task-list	oj-opac-task-list
   Teilprojektdetails	oj-pcs-task-detail	oj-opac-task-detail
   Anwendungsliste	oj-pcs-app-list	oj-opac-applist
   Startformular	oj-pcs-start-form	oj-opac-start-form
   DP-Liste	oj-pcs-dplist	oj-opac-instance-list (zeigt sowohl strukturierten Prozess als auch dynamischen Prozess an)
   Visualisierung	oj-pcs-Visualisierung	oj-opac-analytics (Visualisierungen können nicht gespeichert werden)

Nicht-Oracle-Integrationsclients

Wenn Sie Prozessanwendungen von außerhalb von Oracle Integration aufrufen (z.B. Ihre eigene benutzerdefinierte Anwendung), müssen Sie die REST-Endpunkte und Authentifizierungs-Policys aktualisieren, mit denen die neu konfigurierte OCI Process Automation-Instanz aufgerufen wird. Weitere Informationen zu den neuen API-Endpunkten und unterstützten Authentifizierungs-Policys finden Sie unter REST-API für Oracle Cloud Infrastructure Process Automation.

Verifizierung

Führen Sie einen Systemintegrationstest aus, um Ihre Arbeit zu validieren.

Testen Sie die Konnektivität zur neuen Prozessumgebung. Dieser Test sollte sich auf die Validierung der folgenden Interaktionsmuster basierend auf Ihrer Nutzung konzentrieren:

• OCI Process Automation - Prozesse zu Oracle Integration der 2. Generation - Integrationen
• Oracle Integration der 2. Generation – Integrationen in OCI Process Automation – Prozesse
• Visual Builder - Anwendungen für OCI Process Automation - Prozesse