Creare una cartella o un documento in Oracle Content and Experience Cloud mediante l'utilizzo di processo in Oracle Integration Cloud

Utilizzare l'evento Avvio documento per modellare un processo che può essere avviato da un documento. Utilizzare l'evento Avvio cartella per modellare un processo che può essere avviato da una cartella.

Prima di poter creare uno di questi processi, è necessario disporre di un account Oracle Content Management ed è necessario configurare una connessione tra tale servizio e Oracle Integration.

Se si abilita l'integrazione di Oracle Content Management, è possibile definire le cartelle che verranno create automaticamente in Oracle Content Management per ogni istanza di processo, fornendo un'organizzazione predefinita dei documenti interessati. È inoltre possibile eseguire l'override del tipo di accesso a livello di task per definire le autorizzazioni appropriate per la cartella o il documento per un task specifico in base alle esigenze aziendali. Ad esempio, potrebbe essere necessario impedire agli utenti di visualizzare un documento classificato o una cartella associata a un task.

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

Per poter avviare un processo, l'utente Oracle Content Management configurato in Oracle Integration deve disporre dell'accesso completo alla cartella, ovvero alla cartella del documento in entrata, configurata in Oracle Content Management.
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 accedervi 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.

Per progettare un processo che può essere avviato da un documento o da una cartella, effettuare le operazioni riportate di seguito.

Definire il documento in entrata o la cartella in entrata in Oracle Integration.
Modella un processo con un evento di inizio documento o un evento di inizio cartella.
Personalizzare la relativa implementazione per mappare l'evento iniziale al documento o alla cartella in entrata corrispondente creati. Le opzioni di implementazione consentono di definire la modalità di esposizione del documento o della cartella agli utenti.
Facoltativamente, modificare il ruolo che può accedere al documento o alla cartella a livello di task.
Configurare la cartella in Oracle Content Management per avviare un processo all'arrivo di un documento.

In alternativa, puoi utilizzare l'API REST e fornire tutti i valori di input.

Definisce il documento o la cartella in entrata

È possibile utilizzare la pagina Documenti in Oracle Integration (Process Builder) per definire un documento o una cartella in entrata.

Aprire l'applicazione di processo da modellare, quindi fare clic su Documenti. La pagina Documenti elenca i documenti in entrata e le cartelle in entrata già definite.

Per creare un nuovo documento o cartella in entrata, fare clic su Nuovo , selezionare il tipo appropriato, immettere un nome e selezionare l'autorizzazione di accesso predefinita.

Processi modello che possono essere avviati da eventi di inizio documenti o cartelle

È possibile modellare un processo in Oracle Integration che può essere avviato dall'inizio di un documento o da un evento di avvio di una cartella.

Prima di iniziare, aggiungere l'evento di avvio documento o cartella dalla tavolozza Elementi. Verrà supportato solo il primo evento di avvio aggiunto a un processo.

Nella scheda Home applicazione, fare clic su Processi.
Fare clic su Nuovo processo per aprire la finestra di dialogo Crea processo.
Selezionare Nessuno
Immettere un nome per il processo, assicurarsi che la casella di controllo Apri immediatamente sia selezionata, quindi fare clic su Crea.
Nella tavolozza Elementi fare clic su Eventi.
Trascinare l'evento Inizio documento o l'evento Inizio cartella sullo sfondo.
Aggiungere un flusso di sequenza dall'evento di inizio del nuovo documento o della cartella all'evento finale.
Elimina l'evento di avvio vuoto.
Continuare a modificare e definire il processo. Assicurarsi di testarlo e distribuirlo.

Abilita i ruoli utente per avviare un processo avviato da un documento o da una cartella

È possibile abilitare determinati ruoli utente per avviare il processo avviato da un documento o da una cartella in Oracle Integration.

Per consentire a un ruolo utente di caricare un documento per avviare un processo, effettuare le operazioni riportate di seguito.

Aprire il processo.
Nel nuoto con l'evento di avvio documento o cartella, fare clic sul nome del ruolo, quindi fare clic su Modifica .
Nel campo Ruolo selezionare Handler automatico.

Personalizzare un processo avviato da documento o da cartella

Dopo aver modellato un processo in Oracle Integration, è possibile aggiungere un documento o una cartella iniziale in un processo e personalizzarlo.

Per personalizzare un processo avviato da un documento o da una cartella, effettuare le operazioni riportate di seguito.

Nel diagramma di processo fare clic sull'evento Avvio documento o Avvio cartella.
Fare clic su Menu e selezionare Apri proprietà.
Definire la modalità di gestione del documento o della cartella in entrata.
- In luogo: se si seleziona questo valore, la posizione del documento viene mantenuta così com'è. Se si desidera, è possibile mappare il documento o la cartella in entrata a uno dei documenti o delle cartelle predefiniti per la relativa gestione. A tale scopo, aprire l'elenco a discesa.
  
  Se non esiste un documento o una cartella in entrata predefinita adatta a questo processo specifico, fare clic su Nuovo per crearne uno.
- Non gestito: il documento o la cartella vengono ignorati dal processo corrente. Oracle Integration Cloud non mostrerà un documento o una cartella non gestita in runtime. Il programma di modellazione del processo consente di gestire il documento o la cartella in entrata. Ad esempio, se si desidera spostare la cartella o il documento in entrata in un'altra posizione, è possibile utilizzare un'espressione XPath per ottenere le proprietà, ad esempio Id o Type, e passare le informazioni sulla proprietà a un servizio REST.

Configura una cartella

Per impostare l'avvio automatico di un processo quando un documento viene caricato in una cartella, è necessario configurare la cartella in Oracle Content Management.

Per configurare la cartella per avviare un processo all'arrivo di un documento, effettuare le operazioni riportate di seguito.

Accedere a Oracle Content Management.
Selezionare la cartella.
Selezionare Proprietà dalla barra dei menu.
Abilitare l'impostazione Avvia processo all'arrivo del documento.
Selezionare il processo nella lista.
Fare clic su Salva.

Ora la cartella e le relative cartelle secondarie possono essere utilizzate nell'interfaccia di Oracle Integration. Qualsiasi modifica a un file nella cartella o a qualsiasi nuovo file caricato nella cartella attiva il processo associato alla cartella. È possibile sostituire il processo ereditato per una cartella secondaria, ma non è possibile disabilitare l'associazione a un processo.

Quando un file viene caricato da Oracle Content Management in una cartella configurata per l'uso con Oracle Integration, il file viene utilizzato per il task associato a tale cartella. Gli utenti di Oracle Integration possono eseguire qualsiasi azione sui file, ad esempio le approvazioni. Una volta completata l'esecuzione di un passo del task, è possibile spostare o gestire il file in base al processo definito.

Quando Oracle Content Management avvia un processo, il payload inviato per avviare il processo include le informazioni riportate di seguito.

ID documento
Nome documento
ID dell'utente che ha avviato il processo
Tipo
Ruolo (indica il ruolo da utilizzare per generare i collegamenti applicazione successivi)
Versione

Nell'esempio seguente vengono utilizzati solo l'ID documento e il nome documento da visualizzare nel form di Oracle Integration. Inoltre, utilizza l'ID documento quando effettua chiamate API REST per spostare o copiare il file in Oracle Content Management nella cartella dei task.

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

Gli sviluppatori devono essere consapevoli dei seguenti requisiti per il processo in fase di sviluppo:

Il processo deve utilizzare un evento di avvio di Oracle Content Management.
Quando si distribuisce il processo, è necessario condividerlo con l'utente specificato per abilitare l'integrazione. In caso contrario, l'utente non avrà i 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.
Se si abilita l'integrazione dei processi per una cartella, è necessario condividere questa cartella con l'account utente di Oracle Content Management utilizzato per abilitare l'integrazione in Oracle Integration.