Configurare l'integrazione dei processi tra Oracle Integration e Oracle Content Management

Prima che l'utente o qualsiasi utente possa accedere alle funzioni di documento e conversazione, un amministratore deve configurare le impostazioni sia in Oracle Content Management che in Oracle Integration.

Solo un utente con privilegi di amministratore può stabilire una connessione tra i due servizi.

Per le applicazioni di processo che sono state create prima di configurare la connessione con Oracle Content Management, le funzioni di documento e conversazioni sono disabilitate per impostazione predefinita. Gli sviluppatori possono abilitare manualmente queste funzioni nelle applicazioni esistenti.

Requisiti di accesso per un'integrazione riuscita

Tenere presenti i requisiti di accesso riportati di seguito per una corretta integrazione.

• L'utente Oracle Content Management configurato in Oracle Integration deve disporre dell'accesso completo alla cartella (ovvero la cartella del documento in entrata) configurata in Oracle Content Management per poter avviare un processo.

• Per un processo avviato dalla cartella, ovvero un processo con un evento Avvio cartella, l'utente Oracle Content Management configurato in Oracle Integration deve disporre dell'accesso manager alla cartella per accedere alla cartella in Oracle Integration. Ad esempio, è necessario disporre dell'accesso manager per visualizzare la cartella nella pagina Dettagli task e nella pagina Registrazione processo, per accedere alla cartella durante l'integrazione dei componenti dell'interfaccia utente di processo in un'applicazione esterna o per visualizzare la cartella nell'applicazione Process Mobile.

• Per visualizzare un processo nell'elenco dei processi per una cartella e per poter avviare un'istanza di processo all'arrivo di un nuovo documento, è necessario concedere al ruolo di responsabile avvio del processo l'utente Oracle Integration configurato in Oracle Content Management.

Usa documenti o allegati in un'applicazione di processo

Oracle Integration include automaticamente la funzionalità standard di allegato file nelle applicazioni di processo. È possibile caricare e allegare file a un processo. Quando si utilizza Oracle Content Management con Oracle Integration, è inoltre disponibile la funzionalità documenti, che consente di caricare i file, organizzare i file in cartelle, gestire l'accesso a ogni cartella e persino avviare un processo caricando un documento. Inoltre, ogni applicazione di processo può utilizzare documenti o allegati.

È possibile controllare se un processo utilizza documenti o allegati a livello di applicazione. I documenti sono abilitati per impostazione predefinita. L'impostazione si trova nel riquadro Informazioni per l'applicazione.

Descrizione dell'illustrazione enable-docs-app-level-cb.png

Un'applicazione con Integrazione documenti abilitata può utilizzare documenti (e solo documenti). Un'applicazione con Integrazione documenti disabilitata può utilizzare solo allegati. In pratica, disabilitando i documenti per un'applicazione, è possibile abilitare gli allegati per tale applicazione.

Tenere presente che l'impostazione si applica all'applicazione. È possibile utilizzare documenti o allegati in un'applicazione, ma non entrambi.

Per gli allegati, assicurarsi che l'opzione Nascondi allegati sia deselezionata nella schermata di personalizzazione dell'interfaccia utente. Se è selezionata l'opzione Nascondi allegati, non sarà possibile visualizzare gli allegati nei dettagli del task e avviare i form.

Se si utilizzano le API REST per interagire con Oracle Integration, assicurarsi di utilizzare l'API appropriata a seconda che l'applicazione di processo utilizzi documenti o allegati:

• Per i documenti, assicurarsi di utilizzare le API REST delle cartelle.

• Per gli allegati, assicurarsi di utilizzare le API REST /attachments.

Se si utilizza l'interfaccia API errata, l'applicazione restituisce un messaggio di errore o termina senza operazione.

Tenere presente che se non si è in grado di visualizzare gli allegati nei dettagli del task, controllare le opzioni nella schermata Personalizzazione interfaccia utente. Assicurarsi che la casella di controllo Nascondi allegati sia deselezionata per visualizzare gli allegati.

Configurare le impostazioni di Oracle Integration in Oracle Content Management

Abilitare Oracle Integration per i documenti in Oracle Content Management.

1. Accedere a Oracle Content Management come amministratore.
2. Nel menu Amministrazione scegliere Integrazioni.
3. In Applicazioni, selezionare Oracle Integration per abilitare il servizio, quindi impostare i valori riportati di seguito.
   • URL servizio: l'URL del servizio REST a cui gli utenti possono accedere per le proprie applicazioni, che termina con bpm/api/4.0/processes (ad esempio, https://servicename/bpm/api/4.0/processes).
   • Utente servizio: immettere l'indirizzo di posta elettronica dell'utente proprietario del processo da usare in Oracle Content Management.
   • Password servizio: immettere la password dell'utente.

Una volta completata l'esecuzione di un passo del task, è possibile gestire il file in base al processo definito. Per un documento in entrata, un utente può eseguire azioni in base al ruolo assegnato per tale documento: Collaboratore, Downloader o Visualizzatore.

Quando Oracle Content Management avvia un processo, viene inviato il payload riportato di seguito per avviare il processo.

{

        "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"

         }

}

Gli sviluppatori hanno bisogno di essere consapevoli dei seguenti requisiti per il processo sviluppato:

• Deve essere un processo che utilizza un evento di avvio documento di Oracle Content Management.
• Quando si distribuisce il processo, è necessario condividerlo con l'utente specificato per abilitare l'integrazione in modo che l'utente disponga dei diritti per attivare il processo,
• Affinché l'utente che ha caricato il file venga visualizzato come l'utente che ha avviato il task, il processo deve utilizzare il valore passato nel campo startedby come nome visualizzato per il responsabile avvio.

Configurare le impostazioni dei documenti in Oracle Integration

L'amministratore deve inoltre configurare la connessione tra Oracle Integration e Oracle Content Management. È necessario immettere informazioni quali l'URL e le credenziali di accesso per Oracle Content Management.

Per configurare le impostazioni in Oracle Integration:

1. Nel riquadro di navigazione Oracle Integration fare clic su Task personali, fare clic su Area di lavoro, quindi fare clic su Amministrazione.
2. Fare clic su Servizi.
3. Nella sezione Oracle Content Management immettere le informazioni riportate di seguito.
   • URL: l'indirizzo Web di Oracle Content Management. L'amministratore del servizio riceve un'e-mail di benvenuto di Oracle Cloud quando il servizio è pronto per l'uso. Il messaggio di posta elettronica contiene l'URL per Oracle Content Management. Ad esempio, https://your_service_name.com/documents.
   • Dominio di Identity: il nome del dominio di Identity a cui appartiene Oracle Content Management. È possibile configurare correttamente una connessione a Oracle Content Management (per la funzione Documenti) senza fornire un dominio di Identity.
   • Utente e Password: le credenziali dell'account per un utente che ha accesso a Oracle Content Management. Questo account utente viene utilizzato per eseguire il test della connessione tra i servizi. Viene utilizzato anche durante il runtime per connettersi ai servizi ed eseguire tutte le operazioni di runtime, ad esempio la creazione di cartelle.

   Importante:

   Se si desidera collaborare utilizzando le conversazioni, all'utente specificato qui deve essere assegnato il ruolo seguente:

   service_instance_name.CECIntegrationUser

   Usare l'applicazione Oracle Cloud My Services per assegnare ruoli agli utenti.

4. Fare clic su Test.

   Ogni volta che si apportano modifiche alle impostazioni di configurazione, è consigliabile verificare che i valori immessi siano corretti. Si desidera confermare che è stata stabilita una connessione riuscita con Oracle Content Management.

   Esaminare i risultati del test, che possono includere messaggi, errori e avvertenze.

5. Per continuare, selezionare una delle seguenti opzioni:
   • Se si verificano errori o avvertenze, apportare le modifiche necessarie, quindi fare di nuovo clic su Test per verificare i nuovi valori. Ripetere la verifica ogni volta che si modificano le impostazioni.
   • Se il test della connessione ha esito positivo, fare clic su Salva per salvare le impostazioni di configurazione.
   • Se si desidera annullare e tornare agli ultimi valori salvati, fare clic su Ripristina.