Esegui l'upgrade a Oracle Integration 3: fase 2

Quando questa opzione è abilitata, viene eseguito automaticamente il provisioning di un'istanza di processo con l'istanza di Oracle Integration. In tal caso, i due servizi diventano associati tra loro e vengono elencati nella pagina Servizi associati nella console di Oracle Cloud.

Impostare i criteri IAM per gestire l'istanza del processo

Per abilitare Process con Oracle Integration, è necessario creare criteri Oracle Cloud Infrastructure Identity and Access Management (IAM) che consentano agli amministratori di Oracle Integration appartenenti a un gruppo IAM specificato di gestire l'istanza di Process.

Impostare i criteri IAM seguenti per il processo:

Vedere Informazioni sui criteri IAM per l'automazione dei processi e Crea un criterio IAM in un dominio di Identity in Amministrazione di Oracle Cloud Infrastructure Process Automation.

Per informazioni sui criteri IAM per Oracle Integration, vedere Informazioni sui criteri IAM per Oracle Integration e Creare un criterio IAM in un dominio di Identity per Oracle Integration.

Abilita processo

Per abilitare un'istanza di processo con un'istanza di Oracle Integration:

1. Aprire il menu di navigazione e fare clic su Servizi per sviluppatori. In Integrazione applicazione, fare clic su Integrazione.
2. Dall'elenco a discesa Compartimento selezionare il compartimento in cui si desidera eseguire il provisioning e abilitare un'istanza di processo con un'istanza di Oracle Integration. La pagina viene aggiornata per mostrare eventuali istanze di servizio esistenti nel compartimento selezionato.
3. Scegliere un'istanza esistente o creare un'istanza di Oracle Integration e selezionarla. Viene visualizzata la pagina dei dettagli dell'istanza di integrazione.
4. Fare clic sul collegamento Abilita per il processo nella scheda Informazioni sull'istanza di integrazione.
5. Quando richiesto, fare clic su Abilita per confermare l'abilitazione del processo. Tenere presente quanto riportato di seguito.
   • L'icona di Oracle Integration diventa arancione e il relativo stato cambia in Aggiornamento.
   • Il completamento dell'abilitazione potrebbe richiedere alcuni minuti.
   • Una volta completata, ovvero quando un'istanza di processo viene abilitata e ne viene eseguito il provisioning con l'istanza di Oracle Integration, l'icona di Oracle Integration torna in verde con stato Attivo e il processo viene visualizzato come Abilitato.
6. Per passare all'istanza del processo appena creata, fare clic su Servizi associati in Risorse.
7. Selezionare l'istanza del processo e visualizzarne i dettagli.

Assegna ruoli applicazione IDCS per gestire l'accesso

Dopo aver abilitato un'istanza di processo, assegnare ruoli applicazione IDCS predefiniti agli utenti in modo che possano utilizzare le funzioni dell'istanza di processo.

In corso sono disponibili due ruoli applicazione IDCS predefiniti: ServiceDeveloper e ServiceAdministrator. Questi ruoli devono essere assegnati a utenti o gruppi nell'applicazione di istanza del servizio di elaborazione dalla console di amministrazione di Oracle Identity Cloud Service (IDCS).

Come procedura ottimale, si consiglia di assegnare questi ruoli ai gruppi anziché ai singoli utenti. Ad esempio, assegnare il ruolo applicazione IDCS ServiceDeveloper a un gruppo nelle applicazioni di istanza del servizio Oracle Integration e Process dalla console di amministrazione di Oracle Identity Cloud Service. In questo modo sarà più facile gestire l'accesso degli utenti, poiché qualsiasi utente membro del gruppo può accedere alla fase di progettazione di Oracle Integration e dei processi.

1. Determinare quali applicazioni si desidera migrare.

   Si consiglia di cogliere questa opportunità per ripulire le applicazioni non necessarie. Determinare se si desidera eseguire la migrazione solo delle applicazioni presenti nell'ambiente di produzione.

   Se si intende eseguire la migrazione di singole applicazioni, prendere nota delle applicazioni di cui si desidera eseguire la migrazione e delle eventuali dipendenze.

2. Eseguire la migrazione delle applicazioni utilizzando uno dei metodi riportati di seguito.
   • Esegui migrazione di massa di tutte le applicazioni
     1. Nella console di Oracle Cloud, creare un bucket di storage degli oggetti. Vedere Creazione di un bucket di storage degli oggetti.

        L'URL del bucket di storage di cui avrai bisogno nel passo successivo è nel seguente formato:

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

        Posizione:

        • region è l'identificativo del tuo data center Oracle Cloud Infrastructure (OCI).
        • namespace è la tenancy in cui hai creato il bucket.
        • bucket è il nome del bucket.
     2. Effettuare una richiesta POST all'istanza di Oracle Integration Generation 2 per esportare le applicazioni:

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

        Con il seguente payload:

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

        Il job di esportazione sarà completato quando verrà visualizzato il file process_status.json nel bucket. Questo file contiene lo stato del job, la relativa percentuale di completamento e, in caso di errore, il messaggio di errore. Dovresti anche vedere i seguenti contenuti nel tuo bucket:

        • Process/project folder: contiene tutte le applicazioni di processo.
        • Process/dmn folder: contiene tutti i modelli decisionali.
     3. Dopo aver esportato le applicazioni nel bucket, effettuare una richiesta POST nell'istanza di Oracle Integration 3 per eseguire la migrazione delle applicazioni:

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

        Con l'ID tenant:

        x-tenant-id: tenant_OCID

        E le informazioni sul bucket:

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

        Consulta la sezione Sicurezza, autenticazione e autorizzazione in Developer API for Oracle Cloud Infrastructure Process Automation.

     4. Attendere il completamento del job di migrazione. Per controllare lo stato del job di migrazione, procedere nel seguente modo.

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

   • Esegui migrazione singole applicazioni
     1. Esportare le applicazioni di processo di Oracle Integration Generation 2.

        Nell'istanza di Oracle Integration Generation 2 che include le applicazioni di cui si desidera eseguire la migrazione, esportare ogni applicazione di cui si desidera eseguire la migrazione. Vedere Esportazione di un'applicazione in Uso dei processi in Oracle Integration Generation 2.

     2. Importare le applicazioni di processo nel processo Oracle Integration 3.

        In Oracle Integration 3 Process importare le applicazioni di processo Oracle Integration Generation 2. Vedere Importa un'applicazione in Uso di Oracle Cloud Infrastructure Process Automation.

        Oracle Integration 3 Process converte le applicazioni di processo legacy nella versione più recente del prodotto.

3. Esaminare il report sulla migrazione.

   Una volta completata l'importazione e la conversione, verrà visualizzato un report sulla migrazione che mostra gli elementi importati correttamente, gli elementi che richiedono ulteriore lavoro e gli elementi di cui non è stato possibile eseguire la migrazione. Questo ti dà un'idea dei problemi di migrazione che dovrai gestire.

   È possibile fare riferimento al report di migrazione originale nel menu principale. Vedere Importa un'applicazione in Uso di Oracle Cloud Infrastructure Process Automation.

Convalida e attiva applicazioni processo importate

Per convalidare e attivare le applicazioni di processo, effettuare le operazioni riportate di seguito.

1. Convalidare ogni applicazione e correggere eventuali errori e avvertenze.

   Convalidare ogni applicazione dal Designer facendo clic su e scegliendo Convalida dal menu.

   Per risolvere i problemi di convalida, vedere In che modo l'aggiornamento influisce sulle funzioni del processo.

2. Attivare l'applicazione.

   Dopo aver risolto tutti gli errori di convalida, è possibile attivare l'applicazione. Vedere Attiva applicazioni in Uso di Oracle Cloud Infrastructure Process Automation.

Mappa utenti e gruppi a nuovi ruoli applicazione

I ruoli applicazione sono stati notevolmente modificati in Oracle Integration 3. I ruoli ProcessOwner, AnalyticsViewer e ProcessReviewer sono ora definiti in modo esplicito per ogni applicazione, consentendo di controllarne i membri e le autorizzazioni.

Nella tabella riportata di seguito viene illustrato come i ruoli di Oracle Integration Generation 2 vengono mappati ai ruoli del processo Oracle Integration 3.

I nuovi ruoli sono disponibili dopo la migrazione, ma è necessario aggiungervi membri (utenti e gruppi). Probabilmente sarà necessario fare riferimento all'ambiente Oracle Integration Generation 2 per vedere quali membri devono essere assegnati a ciascun ruolo.

Se il processo di Oracle Integration 3 condivide lo stesso dominio di Identity dell'istanza di Oracle Integration Generation 2 esistente, gli utenti e i gruppi esistenti devono essere disponibili per la selezione.

È possibile aggiungere membri prima dell'attivazione nel Designer o dopo l'attivazione nell'area di lavoro.

• Gestione dei ruoli in Designer
• Gestisci ruoli in area di lavoro

Per ulteriori informazioni sul processo di Oracle Integration 3, vedere Configura ruoli per applicazioni di processo in Uso di Oracle Cloud Infrastructure Process Automation.

• Processo di chiamata delle integrazioni
• Integrazioni richiamate per processo
• Applicazioni Visual Builder
• Client non Oracle-Integration
• Verifica

Processo di chiamata delle integrazioni

Le integrazioni che richiamano i processi in Oracle Integration 3 dovranno essere aggiornate per utilizzare la nuova azione di processo. A tale scopo, creare una nuova versione principale dell'integrazione, aggiungere la nuova azione del processo e fare riferimento al processo da avviare da Oracle Integration 3. Rimuovere l'azione del processo precedente e attivare l'integrazione.

Integrazioni richiamate per processo

Il processo di Oracle Integration 3 supporta la comunicazione basata su REST solo tramite la registrazione dei servizi. Ciò significa che la connettività alle integrazioni basate su SOAP non sarà più possibile.

Se si dispone di integrazioni che utilizzano un trigger SOAP richiamate da processi in Oracle Integration Generation 2, sarà necessario eseguire passi aggiuntivi per presentare un'interfaccia basata su REST al processo Oracle Integration 3. Ciò può indicare che è necessario eseguire una delle operazioni riportate di seguito.

• Crea integrazioni wrapper basate su REST.

  o

• Modificare il trigger esistente da SOAP a REST.

Rivedere tutte le connessioni di integrazione nelle applicazioni di processo di cui è stata eseguita la migrazione. Aggiorna i metadati di connessione, assicurando che la definizione più recente venga introdotta nell'applicazione del processo. Aggiornare eventuali mapping di dati non validi e ridistribuire il processo tramite una nuova versione.

Applicazioni di Visual Builder

Le API dello sviluppatore per l'applicazione Processo e Decisione vengono modificate dopo l'aggiornamento. Di conseguenza, è necessario aggiornare qualsiasi applicazione Visual Builder che interagisce con essa, sostituendo qualsiasi modello di integrazione non più valido. Vedere Lavorare con i processi aziendali in Creazione di applicazioni reattive con Visual Builder Studio.

A tale scopo potrebbe essere necessario valutare l'utilizzo corrente del processo. Esamina ciascuna delle tue applicazioni di Visual Builder e determina se stanno effettuando chiamate alle API degli sviluppatori per il processo tramite catene delle azioni, chiamate dirette o utilizzando componenti di processo incorporabili (noti anche come CCA).

Se le applicazioni richiamano gli endpoint del processo, eseguire le operazioni riportate di seguito.

1. Connettiti al processo di Oracle Integration 3.

   Creare una connessione backend al processo Oracle Integration 3. Questo backend verrà utilizzato per stabilire una connessione alla nuova istanza del processo Oracle Integration 3. Vedere Connect to Developer API for Process Automation nella sezione Creazione di applicazioni reattive con Visual Builder Studio.

2. Creare una nuova versione delle applicazioni.

   Oracle consiglia di creare una nuova versione delle applicazioni di Visual Builder per implementare le modifiche necessarie. Vedere Come creare versioni di un'applicazione in Sviluppo di applicazioni con Oracle Visual Builder.

3. Catene azioni

   Se la tua applicazione utilizza catene di azioni per avviare un processo o intraprendere un'azione su un task, dovrai sostituire ognuna di queste con una connessione al servizio basata su REST. Ripetere questi passi per ogni task della catena di azioni del processo.

   Attivazione di un processo

   Sostituire la catena di azioni Avvia processo con una connessione al servizio basata su catalogo.

   1. Passare a Oracle Integration Generation 2 e prendere nota del processo che si sta chiamando. È possibile determinarlo dal passo del processo della catena di azioni o dalla scheda Processi nel menu dell'applicazione a sinistra.
   2. Creare una connessione al servizio basata su catalogo per il processo nella nuova versione dell'applicazione Visual Builder. Vedere Create a Service Connection from a OCI Process Automation Catalog in Creazione di applicazioni reattive con Visual Builder Studio. Assicurarsi di selezionare lo stesso processo a cui si faceva riferimento in precedenza.
      Nota
      
      Il processo deve essere già attivato.
   3. Creare un tipo in base all'endpoint del processo precedente. Vedere Crea un tipo da un endpoint in Sviluppo di applicazioni con Oracle Visual Builder.
   4. Creare una variabile in base al tipo precedente. Vedere Crea variabili in Sviluppo di applicazioni con Oracle Visual Builder.
   5. Passare alle catene di azioni ed eseguire le azioni riportate di seguito.
      1. Trascinare un'azione Assegna variabile sopra l'azione di avvio del processo corrente.
      2. Mappare i campi dati e i parametri di input necessari per richiamare il processo. Ad esempio, vedere Integrare Oracle Process Automation con Visual Builder.
      3. Trascinare l'azione REST chiamata sopra l'azione di avvio del processo corrente.
      4. Configurare l'azione REST di chiamata selezionando l'endpoint POST/Istanze.
      5. Mappare la variabile sopra riportata al corpo della richiesta dell'azione REST.
      6. Elimina l'azione di avvio processo precedente.
   6. Eseguire il test della chiamata e assicurarsi che il processo venga richiamato correttamente nel processo di Oracle Integration 3.

   Recupera istanza processo

   Sostituire la catena di azioni Recupera istanza processo con una connessione al servizio basata su catalogo.

   Se al processo è stata creata una connessione di servizio basata su catalogo seguendo i passi precedenti, si noterà che l'endpoint Recupera istanza processo è ora disponibile nella connessione al servizio.

   Sostituire l'azione processo recupero istanza processo precedente con un'azione REST chiamata configurata con l'endpoint precedente e mappare di nuovo il campo instanceID.

   Nota
   
   I valori del payload della risposta qui sono stati modificati.

   Altre azioni processo

   Eseguire i passi riportati di seguito per tutte le altre azioni del processo, ad esempio Esegui task e Recupera task.

   1. Passare a Oracle Integration Generation 2 e prendere nota delle azioni di processo in uso.
   2. Sostituire queste azioni con connessioni di servizio basate su endpoint.

      La tabella seguente mappa ciascuna di queste azioni alla corrispondente API Developer per il processo.

      Azione di Visual Builder	API sviluppatore per processo	Descrizione
      Esegui task	POST /process/api/v1/tasks/{id}/complete	Azioni di approvazione quali Approva, Rifiuta e così via.
      Esegui task	PUT /process/api/v1/tasks/{id}	Aggiornare priorità task, payload, titolo e simili.
      Esegui task	PUT /process/api/v1/tasks/{id}/payload	Aggiornare il payload del task.
      Esegui task	POST /process/api/v1/tasks/{id}/claim	Richiedere un task
      Esegui task	POST /process/api/v1/tasks/{id}/release	Rilascia un task.
      Esegui task	POST /process/api/v1/tasks/{id}/request-for-info	Richiesta di informazioni su un task.
      Esegui task	POST /process/api/v1/tasks/{id}/submit-info	Sottomettere le informazioni richieste per un task.
      Esegui task	POST /process/api/v1/tasks/{id}/reassign	Riassegnazione di un task
      Recupera raccolta task	OTTIENI /process/api/v1/tasks
      Recupera task	Recupera /process/api/v1/tasks/{id}
      Recupera raccolta processi distribuiti	OTTIENI /process/api/v1/instances
      Recupera raccolta istanze processo	POST /process/api/v1/instances

4. Chiamate dirette

   Le API dello sviluppatore per l'applicazione Processo e Decisione vengono modificate dopo l'aggiornamento. Di conseguenza, è necessario aggiornare tutte le connessioni di servizio diretto. Consulta l'API Developer per Oracle Cloud Infrastructure Process Automation.

5. Componenti CCA

   Se si utilizzano i componenti CCA del processo di Oracle Integration Generation 2, è necessario sostituirli con il componente equivalente di Oracle Integration 3Process.

   Nome componente	CCA di generazione 2 di Oracle Integration	Equivalente a un processo di Oracle Integration 3
   Elenco task	oj-pcs-task-list	elenco attività oj-opac
   Dettagli task	oj-pcs-task-detail	oj-opac-task-dettaglio
   Elenco app	oj-pcs-app-list	oj-opac-applist
   Form iniziale	modulo oj-pcs-start	modulo oj-opac-start
   Elenco DP	oj-pcs-dplist	oj-opac-instance-list (Visualizza sia il processo strutturato che il processo dinamico)
   Visualizzazione	oj-pcs-visualizzazione	oj-opac-analytics (impossibile salvare le visualizzazioni)

Client non Oracle-Integration

Se si chiamano applicazioni di processo dall'esterno di Oracle Integration (ad esempio, l'applicazione personalizzata), è necessario aggiornare gli endpoint REST e i criteri di autorizzazione utilizzati per chiamare l'istanza di processo Oracle Integration 3 appena configurata. Per ulteriori informazioni sui nuovi endpoint API e sui criteri di autorizzazione supportati, vedere Developer API for Oracle Cloud Infrastructure Process Automation.

Verifica

Eseguire un test di integrazione del sistema per convalidare il lavoro.

Eseguire il test della connettività al nuovo ambiente di processo. Questo test dovrebbe concentrarsi sulla convalida dei seguenti pattern di interazione in base all'uso:

• Processo Oracle Integration 3 - Oracle Integration 3 - Integrazioni
• Oracle Integration 3 - Integrazioni con Oracle Integration 3 - Processi
• Visual Builder - Applicazioni al processo Oracle Integration 3 - Processi

Effettuare le seguenti operazioni:

1. Attivare e distribuire le modifiche client per assicurarsi che tutte le nuove richieste basate sul sistema vengano inviate al processo di Oracle Integration 3 come descritto in precedenza.
2. Comunicare il nuovo URL di Process Workspace di Oracle Integration 3 agli utenti e assicurarsi che gli utenti:
   • Aggiungere un segnalibro all'area di lavoro Processo di Oracle Integration 3.
   • Creare solo nuovi processi nel processo di Oracle Integration 3.
   • Completare i nuovi task nel processo di Oracle Integration 3.
3. Disattivare le applicazioni Oracle Integration Generation 2 in modo che non sia possibile creare nuovi processi, ma quelli esistenti possano essere completati. Vedere Gestisci applicazioni attive in Utilizzo dei processi in Oracle Integration 2.

Durante questo intervallo di tempo:

• Le nuove istanze di processo verranno gestite dal processo di Oracle Integration 3.
• Le istanze di processo esistenti continueranno a essere eseguite sul processo di Oracle Integration Generation 2 fino al completamento.

Durante questo periodo, gli utenti del processo devono:

• Lavorare principalmente da Oracle Integration 3 Process Workspace.
• A volte, controllare l'elenco dei task personali di Oracle Integration Generation 2.
• Affidati il più possibile alle approvazioni basate su e-mail, poiché i collegamenti nelle e-mail li porteranno nel posto giusto per eseguire l'attività.

Il periodo di coesistenza dura fino al completamento di tutte le transazioni create in Oracle Integration Generation 2. Si dovrebbe cercare attivamente di ridurre la durata di questo periodo il più possibile. Ecco alcune linee guida:

• Impedisci la creazione di nuove transazioni in Oracle Integration Generation 2 utilizzando la funzionalità Disattiva. Ciò è applicabile a tutti i processi strutturati che non contengono attività di ricezione. La funzionalità di ritiro impedisce la creazione di nuove istanze, ma consente anche il completamento delle transazioni esistenti. Vedere Gestisci applicazioni attive in Utilizzo dei processi in Oracle Integration 2.
• Cerca di accelerare il più possibile il completamento delle istanze di Oracle Integration Generation 2 contattando gli utenti per intraprendere azioni che le vedano fino al completamento. È possibile visualizzare il numero di transazioni aperte per processo e l'assegnatario per i task associati utilizzando un nuovo report disponibile se si passa a Processo, Amministrazione e quindi a Report migrazione.
• Per un processo con tempi di esecuzione molto lunghi, le istanze che non possono essere completate in diversi mesi, esplorare le opzioni riportate di seguito.
  • Ricreare l'istanza nel processo di Oracle Integration 3 e utilizzare la funzionalità Modifica flusso per aggiornare il payload e spostare l'istanza del processo nell'azione corrente (dove si trova attualmente nel processo di generazione 2 di Oracle Integration). Al termine, è possibile interrompere l'istanza di Oracle Integration Generation 2 esistente. Vedere Modifica del flusso di un processo in Utilizzo di Oracle Cloud Infrastructure Process Automation.
  • Modificare l'applicazione migrata in modo che possa essere avviata utilizzando lo stato più recente dell'istanza di processo Oracle Integration Generation 2 esistente.

È possibile tenere traccia delle transazioni del processo Oracle Integration Generation 2 rimanenti facendo clic su Task personali, quindi scegliendo Processi nell'istanza di Oracle Integration Generation 2. Eseguire l'accesso con un utente che dispone del ruolo di amministratore dei servizi.

È possibile spostare le applicazioni di processo in Oracle Integration 3 prima del 31 dicembre 2026 abilitando Process in Oracle Integration 3. Vedere Abilita processo con Oracle Integration 3. Per informazioni sull'esportazione o l'importazione degli artifact di fase di progettazione dell'applicazione di processo, vedere Eseguire la migrazione di tutti gli endpoint REST delle applicazioni.

Salva i dati di runtime dal processo di generazione 2 di Oracle Integration. Questo passo è importante per evitare di perdere la cronologia delle transazioni completate. È necessario eseguire questa operazione prima dell'aggiornamento. Vedere Archiviazione e rimozione dei dati di Process Automation in Oracle Integration.

Nell'ambito di questi passaggi, configurerai Oracle Storage Service e schedulerai le istanze per l'archiviazione e la rimozione. Tenere presente quanto riportato di seguito.

• Le informazioni archiviate saranno disponibili nel bucket di storage degli oggetti configurato.
• Gli allegati non sono inclusi nei file di archivio. È necessario esportarli manualmente. Vedere Recupero di un allegato processo come flusso in API REST per Oracle Integration 2.