Fase 1: Migra le applicazioni di processo all'automazione dei processi OCI
Provisioning e preparazione di un'istanza di automazione processo OCI
Creare una nuova istanza di OCI Process Automation. Oracle consiglia di eseguire il provisioning di un ambiente OCI Process Automation standalone.
Per ulteriori dettagli su questo suggerimento, vedere Domande frequenti sull'aggiornamento.
Le altre istruzioni si basano sull'utilizzo di un'istanza standalone di OCI Process Automation. Non deviare da questo suggerimento a meno che non si disponga di un piano di migrazione alternativo.
- Creare una nuova istanza standalone di OCI Process Automation.
Vedere Provisioning a Process Automation Instance in Amministrazione di Oracle Cloud Infrastructure Process Automation.
Quando si crea l'istanza:
- Seleziona un modello di misurazione basato su un Execution Pack per sfruttare i prezzi del livello gratuito durante l'upgrade.
- L'utente che crea l'istanza standalone di OCI Process Automation deve appartenere allo stesso dominio di Identity dell'utente che ha creato l'istanza di Oracle Integration Generation 2.
- È necessario creare l'istanza standalone OCI Process Automation nella stessa tenancy, nella stessa area e, preferibilmente, nello stesso compartimento dell'istanza di Oracle Integration Generation 2.
Se non si utilizza lo stesso compartimento, assicurarsi che l'utente che crea l'istanza di OCI Process Automation disponga delle autorizzazioni per gestire sia l'istanza di Oracle Integration che l'istanza di OCI Process Automation.
Queste autorizzazioni vengono gestite con i criteri IAM.
Per 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
Ad esempio:
allow group admin/oci-integration-admins to manage integration-instance in tenancy
Per 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
Ad esempio:
allow group admin/oci-integration-admins to manage process-automation-instance in tenancy
- Concedi agli sviluppatori l'accesso a OCI Process Automation.
Per garantire che gli sviluppatori possano accedere all'istanza di OCI Process Automation di cui è stato appena eseguito il provisioning e possano lavorare sui task successivi, assicurarsi che a tali sviluppatori sia assegnato il ruolo applicazione appropriato per accedere all'istanza. Vedere Assign Application Roles to Groups in an Identity Domain in Administering Oracle Cloud Infrastructure Process Automation.
- Registrare un'istanza di Oracle Integration Generation 2 non di produzione per i test.
Se le applicazioni di processo richiamano le integrazioni esistenti, registrare Oracle Integration Generation 2 nella nuova istanza di OCI Process Automation. Ciò consente all'istanza di OCI Process Automation di connettersi e scoprire le integrazioni esistenti.
Assicurarsi di utilizzare un'istanza di Oracle Integration Generation 2 non di produzione per la registrazione del servizio in questo passo. Assicurarsi che la registrazione dell'istanza di Oracle Integration Generation 2 selezionata non avrà effetti negativi sui processi in produzione.
- Scegliere un'istanza di Oracle Integration Generation 2 non di produzione da registrare.
- Nella console di Oracle Cloud Infrastructure, trova e prendi nota dell'OCID dell'istanza di Oracle Integration Generation 2 selezionata.
- In OCI Process Automation, registrare l'istanza di Oracle Integration Generation 2. Vedere Register Services in Using Oracle Cloud Infrastructure Process Automation.
Nota
È possibile creare un utente ServiceAccount dedicato per questa connessione.
Migra applicazioni processo alla nuova istanza
Eseguire la migrazione delle applicazioni di processo esistenti nella nuova istanza standalone OCI Process Automation.
- Determinare le applicazioni di cui eseguire la migrazione.
Si consiglia di cogliere questa opportunità per sbarazzarsi di applicazioni inutili. È opportuno valutare se si desidera eseguire la migrazione solo delle applicazioni presenti nell'ambiente di produzione oppure se si desidera eseguire la migrazione anche delle applicazioni in fase di test e sviluppo.
Se si intende eseguire la migrazione di singole applicazioni, prendere nota delle applicazioni di cui si desidera eseguire la migrazione e delle eventuali dipendenze.
- Eseguire la migrazione delle applicazioni utilizzando uno dei metodi riportati di seguito.
- Esegui migrazione di massa di tutte le applicazioni
- Nella console di Oracle Cloud Infrastructure, creare un bucket di storage degli oggetti. Vedere Creazione di un bucket di storage degli oggetti.
L'URL del bucket di storage necessario nel passo successivo è nel formato seguente:
https://swiftobjectstorage.region.oraclecloud.com/v1/namespace/bucket
Where:
- region è l'identificativo del data center Oracle Cloud Infrastructure (OCI).
- namespace è la tenancy in cui è stato creato il bucket.
- bucket è il nome del bucket.
- Effettuare una richiesta POST nell'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à stato 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 di decisione.
- 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 tue informazioni sul secchio:
{ "bucketInfo": { "region": "region", "namespace": "namespace", "bucket": "bucket" } }
Consulta la sezione relativa a sicurezza, autenticazione e autorizzazione nell'API REST per Oracle Cloud Infrastructure Process Automation.
- Attende il completamento del job di migrazione. Per controllare lo stato del job di migrazione, effettuare le operazioni riportate di seguito.
curl http://localhost:8080/process/internal-api/v1/oic-migration/jobs/job_ID
- Nella console di Oracle Cloud Infrastructure, creare un bucket di storage degli oggetti. Vedere Creazione di un bucket di storage degli oggetti.
- Eseguire la migrazione di singole applicazioni
- 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 Esporta un'applicazione in Uso dei processi in Oracle Integration Generation 2.
- Importare le applicazioni di processo in OCI Process Automation.
In OCI Process Automation, importare le applicazioni di processo Oracle Integration Generation 2. Vedere Importa un'applicazione in Uso di Oracle Cloud Infrastructure Process Automation.
OCI Process Automation converte le applicazioni di processo legacy nella versione più recente del prodotto.
- Esportare le applicazioni di processo di Oracle Integration Generation 2.
- Esegui migrazione di massa di tutte le applicazioni
- Rivedere il report migrazione.
Al termine dell'importazione e della conversione, verrà visualizzato un report di 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.
Eseguire il mapping di utenti e gruppi a nuovi ruoli applicazione
I ruoli applicazione sono stati modificati in modo significativo in OCI Process Automation. I ruoli ProcessOwner, AnalyticsViewer e ProcessReviewer sono ora definiti in modo esplicito per ogni applicazione, consentendo di controllare i relativi membri e autorizzazioni.
Nella tabella seguente viene illustrato come i ruoli di Oracle Integration Generation 2 vengono mappati ai ruoli di OCI Process Automation.
Oracle Integration Generazione 2 | Automazione dei processi OCI |
---|---|
<nome-applicazione>. ProcessOwner | Proprietario processo |
<nome-applicazione>. AnalyticsViewer | N/A |
<nome-applicazione>.<swim-lane> | <swim-lane> |
<nome-applicazione>. ProcessReviewer | Revisore processo |
I nuovi ruoli sono disponibili dopo la migrazione, ma è necessario aggiungervi membri (utenti e gruppi). Probabilmente dovrai fare riferimento all'ambiente di Oracle Integration Generation 2 per vedere quali membri devono essere assegnati a ciascun ruolo.
Se OCI Process Automation 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 in Designer o dopo l'attivazione nell'area di lavoro.
Per ulteriori informazioni su OCI Process Automation, vedere Configure Roles for Process Applications in Using 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.
- Convalida ogni applicazione e correggi 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.
- Attiva l'applicazione.
Dopo aver risolto tutti gli errori di convalida, è possibile attivare l'applicazione. Vedere Activate Applications in Using Oracle Cloud Infrastructure Process Automation.
Aggiorna client che chiamano applicazioni processo
A seconda del tuo utilizzo specifico, eseguirai diversi passaggi per aggiornare i tuoi client.
Processo chiamata integrazioni
Le API e gli endpoint del processo sono stati modificati dopo l'upgrade. È necessario riconfigurare l'integrazione utilizzando la procedura guidata di chiamata di Process Automation. Vedere Riconfigurare l'integrazione.
Integrazioni richiamate dal processo
OCI Process Automation supporta la comunicazione basata su REST solo tramite la registrazione del servizio. Ciò significa che la connettività alle integrazioni basate su SOAP non sarà più possibile.
Se si dispone di integrazioni che utilizzano un trigger SOAP e queste vengono richiamate dai processi in Oracle Integration Generation 2, sarà necessario eseguire ulteriori passi per presentare un'interfaccia basata su REST a OCI Process Automation. Ciò potrebbe significare che è necessario eseguire una delle seguenti operazioni:
- Crea integrazioni wrapper basate su REST.
In alternativa
- Modificare il trigger esistente da SOAP a REST.
Inoltre, affinché la registrazione del servizio funzioni come previsto, assicurarsi che il trigger REST utilizzi il criterio OAuth 2.0 o Basic Authentication Security.
Applicazioni Visual Builder
Elabora la modifica degli endpoint API dopo l'upgrade. Di conseguenza, è necessario aggiornare qualsiasi applicazione Visual Builder che interagisca con esse, sostituendo qualsiasi modello di integrazione non più valido. Fare riferimento alla sezione Utilizzo dei processi aziendali in Creazione di applicazioni reattive con Visual Builder Studio.
A tale scopo, potrebbe essere necessario valutare l'uso corrente del processo. Esamina ciascuna delle tue applicazioni Visual Builder e determina se stanno effettuando chiamate per elaborare le API tramite concatenazioni di azioni, chiamate dirette o utilizzando componenti di processo incorporabili (noti anche come CCA).
Se le applicazioni richiamano gli endpoint del processo, effettuare le operazioni riportate di seguito.
- Eseguire la connessione a OCI Process Automation.
Creare una connessione backend a OCI Process Automation. Questo backend verrà utilizzato per stabilire una connessione alla nuova istanza di OCI Process Automation. Vedere Connettersi alle API di automazione di Oracle Process in Creazione di applicazioni reattive con Visual Builder Studio.
- Creare una nuova versione delle applicazioni.
Oracle consiglia di creare una nuova versione delle applicazioni Visual Builder per implementare le modifiche necessarie. Vedere How to Create Versions of an Application in Developing Applications with Oracle Visual Builder.
- Catene azione
Se l'applicazione utilizza catene di azioni per avviare un processo o eseguire un'azione su un task, sarà necessario sostituire ognuna di esse 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.
- 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.
- Creare una connessione al servizio basata sul catalogo per il processo nella nuova versione dell'applicazione Visual Builder. Vedere Create a Service Connection from an OCI Process Automation Catalog in Building Responsive Applications with Visual Builder Studio. Assicurarsi di selezionare lo stesso processo a cui si faceva riferimento in precedenza.
Nota
È necessario che il processo sia già stato attivato. - Creare un tipo in base all'endpoint del processo precedente. Vedere Create a Type from an Endpoint in Developing Applications with Oracle Visual Builder.
- Creare una variabile in base al tipo precedente. Vedere Create Variables in Developing Applications with Oracle Visual Builder.
- Passare alle catene di azioni ed eseguire le azioni riportate di seguito.
- Trascinare un'azione Assegna variabile sopra l'azione Avvia processo corrente.
- Mappare i campi dati e i parametri di input necessari per richiamare il processo. Per un esempio, vedere Integra Oracle Process Automation con Visual Builder.
- Trascinare l'azione REST di chiamata sopra l'azione di avvio del processo corrente.
- Configurare l'azione REST di chiamata selezionando l'endpoint POST/Istanze.
- Mappare la variabile sopra riportata al corpo della richiesta dell'azione REST.
- Eliminare l'azione precedente Avvia processo.
- Eseguire il test della chiamata e assicurarsi che il processo venga richiamato correttamente in OCI Process Automation.
Recupera istanza processo
Sostituire la catena di azioni Recupera istanza processo con una connessione di servizio basata su catalogo.
Se al processo è stata creata una connessione al servizio basata su catalogo seguendo i passi precedenti, l'endpoint Recupera istanza processo sarà ora disponibile nella connessione al servizio.
Sostituire l'azione precedente Recupera processo istanza processo con un'azione REST di chiamata configurata con l'endpoint precedente e mappare di nuovo il campo instanceID.
Nota
I valori del payload delle risposte 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.
- Passare a Oracle Integration Generation 2 e prendere nota delle azioni processo in uso.
- Sostituire queste azioni con connessioni al servizio basate su endpoint.
La tabella riportata di seguito mappa ciascuna di queste azioni all'API OCI Process Automation corrispondente.
Azione di Visual Builder API REST OCI Process Automation descrizione; Esegui task Invia /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 così via. Esegui task PUT /process/api/v1/tasks/{id}/payload Aggiornare il payload del task. Esegui task Invia /process/api/v1/tasks/{id}/claim Rivendicazione di un task. Esegui task Invia /process/api/v1/tasks/{id}/release Rilasciare un task. Esegui task Invia /process/api/v1/tasks/{id}/request-for-info Richiesta di informazioni su un task. Esegui task Invia /process/api/v1/tasks/{id}/submit-info Sottomettere le informazioni richieste per un task. Esegui task Invia /process/api/v1/tasks/{id}/reassign Riassegnazione di un task. Recupera raccolta task OTTIENI /process/api/v1/tasks Recupera task OTTIENI /process/api/v1/tasks/{id} Recupera raccolta processi distribuita OTTIENI /process/api/v1/instances Recupera raccolta istanze processo Invia /process/api/v1/instances
- Chiamate dirette
Elabora le modifiche delle API e degli endpoint dopo l'upgrade. Di conseguenza, è necessario aggiornare tutte le connessioni dirette al servizio. Consulta l'API REST per Oracle Cloud Infrastructure Process Automation.
- Componenti CCA
Se si utilizzano i componenti CCA del processo Oracle Integration Generation 2, è necessario sostituirli con il relativo componente equivalente di OCI Process Automation.
Nome componente CCA di generazione 2 di Oracle Integration Equivalente OCI Process Automation Elenco task oj-pcs-task-list oj-opac-task-list Dettaglio task oj-pcs-task-dettaglio dettaglio task oj-opac Elenco applicazioni oj-pcs-app-list elenco oj-opac Form iniziale oj-pcs-start-form oj-opac-start-form 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 richiamano applicazioni di processo dall'esterno di Oracle Integration (ad esempio, la propria applicazione personalizzata), è necessario aggiornare gli endpoint REST e i criteri di autenticazione utilizzati per chiamare la nuova istanza di OCI Process Automation configurata. Per ulteriori informazioni sui nuovi endpoint API e sui criteri di autenticazione supportati, vedere API REST per 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:
- OCI Process Automation - Processi per Oracle Integration Generation 2 - Integrazioni
- Oracle Integration Generation 2 - Integrazioni per OCI Process Automation - Processi
- Visual Builder - Applicazioni per OCI Process Automation - Processi