Integrazioni di Controllo eventi per Oracle Cloud ERP

In questa sezione sono elencate le integrazioni di Controllo eventi pronte all'uso per Oracle Cloud ERP.

Nota:

Per informazioni sull'integrazione customizzata di Automazione processo o Controllo eventi in Oracle Cloud ERP, fare riferimento alla sezione Creazione delle integrazioni di Task Manager customizzate.

Eventi supportati per Oracle Cloud ERP General Ledger

Per General Ledger sono supportati gli eventi indicati di seguito.

Origine	Evento	Descrizione
General Ledger	Periodo contabile chiuso	Segnala che un periodo contabile General Ledger è chiuso.
General Ledger	Periodo contabile aperto	Segnala che un periodo contabile General Ledger è aperto.
General Ledger	Periodo contabile riaperto	Segnala che un periodo contabile General Ledger è riaperto.
General Ledger	Batch giornali approvato	Segnala che un batch di giornali è approvato.
General Ledger	Contabilizzazione batch giornali completata	Segnala che un batch di giornali è contabilizzato.

Integrazioni aggiunte a una connessione integrata esistente

Nella tabella sono elencate le integrazioni aggiunte per monitorare questi eventi business da Task Manager:

Tipi di integrazione in Tax Reporting
Tipi di task in Tax Reporting
Flussi di integrazione in Integration Cloud

Nome connessione	Nome integrazione	Codice integrazione	Nome evento	Descrizione	Parametro/i
Oracle Cloud ERP - General Ledger	Evento Chiusura periodo	R13GLPeriodClose	Periodo contabile chiuso	Controllo dell'evento Chiusura periodo di Oracle Cloud ERP General Ledger	LedgerName: nome del libro contabile. Ad esempio, Libro contabile principale ITA. Period: nome del periodo. Ad esempio, 01-19.
Oracle Cloud ERP - General Ledger	Evento Apertura periodo	R13GLPeriodOpen	Periodo contabile aperto	Controllo dell'evento Apertura periodo di Oracle Cloud ERP General Ledger	LedgerName: nome del libro contabile. Ad esempio, Libro contabile principale ITA. Period: nome del periodo. Ad esempio, 01-19.
Oracle Cloud ERP - General Ledger	Evento Riapertura periodo	R13GLPeriodReopen	Periodo contabile riaperto	Controllo dell'evento Riapertura periodo di Oracle Cloud ERP General Ledger	LedgerName: nome del libro contabile. Ad esempio, Libro contabile principale ITA. Period: nome del periodo. Ad esempio, 01-19.
Oracle Cloud ERP - General Ledger	Evento approvazione giornale	R13GLJournalBatchApprove	Batch giornali approvato	Controllo dell'evento Approvazione batch di scritture contabili di Oracle Cloud ERP General Ledger	BatchName: nome del batch di scritture contabili. Period: nome del periodo. Ad esempio, 01-19.
Oracle Cloud ERP - General Ledger	Evento contabilizzazione giornale	R13GLJournalBatchPost	Batch di scritture contabili contabilizzato	Controllo dell'evento Contabilizzazione del batch di scritture contabili di Oracle Cloud ERP General Ledger	BatchName: nome del batch di scritture contabili. Period: nome del periodo. Ad esempio, 01-19.

Impostazione dell'integrazione in Task Manager

In Task Manager è possibile creare un'integrazione di Controllo eventi per Oracle Cloud ERP - General Ledger. L'integrazione di Controllo eventi viene attivata quando si verifica un evento esterno in un altro servizio cloud o in un'applicazione in locale.

Assicurarsi che gli eventi business siano abilitati in Oracle Cloud ERP. Per verificare gli eventi è possibile utilizzare un'interfaccia API REST. Fare riferimento a questi argomenti nella sezione "Endpoint REST degli eventi business ERP" della guida API REST per Oracle Financials Cloud disponibile all'indirizzo docs.oracle.com.

Per verificare gli eventi, fare riferimento alla sezione "Come ottenere tutti i record degli eventi business".

Se un evento qualsiasi non è abilitato, fare riferimento alla sezione "Aggiornamento dell'indicatore Abilitato per un evento business".

Task Manager utilizza Oracle Integration Cloud per tutte le integrazioni con applicazioni esterne. È possibile impostare una connessione a Oracle Integration Cloud in Task Manager utilizzando l'autenticazione di base o OAuth 2.0.

Nota:

Per Oracle Integration Cloud Gen 2, sono supportate sia l'autenticazione di base che l'autenticazione OAuth 2.0.
Per Oracle Integration Cloud Gen3, è supportata solo l'autenticazione OAuth 2.0.
L'utente di Autenticazione di base deve disporre del ruolo di amministratore dei servizi per Oracle Integration Cloud.
Per OAuth 2.0, sono supportate solo le credenziali client. L'applicazione client OAuth 2.0 deve disporre del ruolo di amministratore dei servizi per Oracle Integration Cloud e l'ambito consentito deve essere Tutto.

Prima di impostare la connessione OAuth 2.0, assicurarsi di disporre delle credenziali client, ad esempio l'URL del token di accesso, l'ID client, il segreto client e l'ambito. Per impostare l'applicazione client OAuth, fare riferimento a Autenticazione OAuth in Oracle Integration nella documentazione di Oracle Integration Cloud Generation 3.

Per impostare la connessione di Integration Cloud in Task Manager, procedere come segue.

Nella home page fare clic su Applicazione, quindi su Task Manager.
Fare clic sulla scheda Integrazioni a sinistra.
Fare clic su Gestisci connessioni, quindi in Azioni selezionare Connessione di Integration Cloud.
Selezionare uno dei meccanismi di autenticazione descritti di seguito.
- Autenticazione di base: specificare l'URL di Integration Cloud, l'ID utente dell'amministratore del servizio e la password.
- OAuth 2.0: specificare l'URL di Integration Cloud, l'URL del token di accesso, l'ID client, il segreto client e l'ambito.
Nota:
- Per Gen 2, immettere l'URL: https://<SERVICE_NAME>-<TENANT_NAME>.integration.ocp.oraclecloud.com
- Per Gen 3, immettere l'URL: https://<SERVICE_INSTANCE>.integration.<REGION>.ocp.oraclecloud.com. Per trovare l'istanza del servizio, eseguire l'accesso a Integration Cloud e aprire la finestra delle informazioni.
Fare clic su Convalida. Quando il sistema indica che la convalida è riuscita, fare clic su Salva. Questa operazione consente di salvare il server e le credenziali della connessione.

Abilitazione della connessione a Oracle Cloud ERP - General Ledger

Per abilitare la connessione a Oracle Cloud ERP - General Ledger, procedere come segue.

Nella home page fare clic su Applicazione, quindi su Task Manager.
Fare clic sulla scheda Integrazioni a sinistra, quindi su Gestisci connessioni.
Dall'elenco selezionare Oracle Cloud ERP - General Ledger, fare clic su Azioni, quindi su Modifica.
Nella finestra di dialogo Modifica connessione selezionare Abilitato, quindi fare clic su OK.

Nota:

Quando si abilita la connessione a Integration Cloud per la prima volta, tutte le distribuzioni di Integration Cloud avranno esito negativo durante l'attivazione. L'amministratore deve effettuare l'accesso a Integration Cloud, testare e salvare le connessioni distribuite, quindi attivare le integrazioni distribuite in Integration Cloud.

Impostazione del flusso di integrazione in Integration Cloud

Per impostare il flusso di integrazione in Integration Cloud, procedere come segue.

Accedere a Integration Cloud Services
Passare a Connessioni.

Vengono create automaticamente la Connessione a EPM Fusion e la Connessione a EPM.
Modificare le connessioni fornendo le informazioni sull'ambiente e le credenziali. Per informazioni dettagliate sui prerequisiti per la creazione di una connessione, fare riferimento alla sezione Prerequisiti per la creazione di una connessione.
- Connessione a EPM Fusion è la connessione a Oracle Cloud ERP. Per ulteriori dettagli, fare riferimento alla sezione Utilizzo dell'adattatore Oracle ERP Cloud.
- La Connessione a EPM è la connessione a Oracle Fusion Cloud Enterprise Performance Management Service in Task Manager. Per ulteriori dettagli, fare riferimento alla sezione Adattatore Oracle Enterprise Performance Management Cloud con Oracle Integration.
Dopo aver eseguito le operazioni di configurazione, test e salvataggio delle connessioni, viene visualizzato un segno di spunta verde accanto alle connessioni.
Tornare a Task Manager e selezionare Integrazioni.
Selezionare l'integrazione dall'elenco, quindi fare clic su Distribuisci in Integration Cloud nella barra degli strumenti.
Nella finestra di dialogo Distribuisci su Integration Cloud fare clic su Genera.

La distribuzione dell'integrazione Cloud ha avuto esito positivo. Verificare lo stato dell'attivazione eseguendo la procedura di accesso a Oracle Integration Cloud Service e selezionando Integrazioni.

Aggiunta del task di monitoraggio eventi a un template o a una programmazione

Una volta completata l'impostazione, è possibile aggiungere i task di monitoraggio eventi a una programmazione o a un template.

Nella home page fare clic su Applicazione, quindi su Task Manager.
Fare clic sulla scheda Template a sinistra e creare un nuovo template, ad esempio Template eventi ERP.
Creare il task di monitoraggio eventi. Fare riferimento a Creazione di task.

In Tipo di task selezionare Oracle Cloud ERP - General Ledger, quindi selezionare il task di monitoraggio eventi, ad esempio Evento apertura periodo.
In Task Manager fare clic su Template, selezionare Template eventi ERP e creare una programmazione. Fare riferimento alla sezione Creazione di programmazioni da template.
In Task Manager fare clic su Programmazioni, quindi selezionare la programmazione e modificare lo stato impostandolo su Aperto.

Il task di programmazione può essere monitorato nella schermata Programmazione task.

Attivazione dell'evento chiusura periodo in Oracle Cloud ERP

Per generare l'evento chiusura periodo in Oracle Cloud ERP, procedere come segue.

Eseguire l'accesso a Oracle Cloud ERP.
Selezionare la scheda Contabilità generale, quindi Chiusura periodo.
Fare clic su General Ledger e selezionare il periodo, quindi fare clic su Chiudi periodo.
Attendere per alcuni minuti il completamento del task. Passare quindi alla schermata Programmazione task in Task per verificare che il task sia chiuso.

Attivazione dell'evento apertura/riapertura periodo in Oracle Cloud ERP

Per generare l'evento apertura periodo in Oracle Cloud ERP, procedere come segue.

Eseguire l'accesso a Oracle Cloud ERP.
Selezionare la scheda Contabilità generale, quindi Chiusura periodo.
Fare clic su General Ledger e selezionare il periodo, quindi fare clic su Apri periodo.
Attendere per alcuni minuti il completamento del task. Passare quindi alla schermata Programmazione task in Task per verificare che il task sia chiuso.

Nota:

Se si apre un periodo mai aperto in precedenza, verrà attivato l'evento Apertura periodo. Se si apre un periodo già chiuso in precedenza, verrà attivato l'evento Riapertura periodo.

Attivazione dell'evento batch di scritture contabili approvato in Oracle Cloud ERP

Per generare l'evento batch di scritture contabili approvato in Oracle Cloud ERP, procedere come segue.

Eseguire l'accesso a Oracle Cloud ERP.
Selezionare la scheda Contabilità generale, quindi Scritture contabili.
Fare clic su Che richiedono approvazione e selezionare il batch di scritture contabili, quindi fare clic su Approva.
Attendere per alcuni minuti il completamento del task. Passare quindi alla schermata Programmazione task in Task per verificare che il task sia chiuso.

Nota:
L'evento Batch di scritture contabili approvato può essere attivato solo se rappresenta l'ultima approvazione nel processo di approvazione a più livelli.

Attivazione dell'evento contabilizzazione giornale in Oracle Cloud ERP

Per generare l'evento batch di scritture contabili approvato in Oracle Cloud ERP, procedere come segue.

Eseguire l'accesso a Oracle Cloud ERP.
Selezionare la scheda Contabilità generale, quindi Scritture contabili.
Fare clic su Task e selezionare Crea scrittura contabile.
Fornire le informazioni richieste nella schermata Crea scrittura contabile, quindi fare clic su Salva.

Nota:
Il nome del batch di scritture e il periodo contabile devono corrispondere ai parametri del task definiti nella programmazione di Task Manager.
Attendere per alcuni minuti il completamento del task. Passare quindi alla schermata Programmazione task in Task per verificare che il task sia chiuso.

Risoluzione dei problemi

In questa sezione vengono fornite informazioni sulla risoluzione dei problemi correlati alle integrazioni di monitoraggio eventi per Oracle Cloud ERP.

Problema Causa principale Soluzione

Errore di comunicazione durante l'importazione in Oracle Integration Cloud

L'applicazione OAuth configurata non dispone del ruolo Amministratore servizi per Oracle Integration Cloud.

Problema	Causa principale	Soluzione
Errore di comunicazione durante l'importazione in Oracle Integration Cloud	L'applicazione OAuth configurata non dispone del ruolo Amministratore servizi per Oracle Integration Cloud.	Creare un'applicazione OAuth distinta e concedere il ruolo Amministratore servizi per l'applicazione OAuth. Aggiungere l'ambito OIC. Fare riferimento alla sezione Impostazione dell'integrazione in Task Manager. Questa operazione è necessaria per poter distribuire il flusso OIC integrato da Task Manager a OIC.
La contabilizzazione del giornale non ha attivato il flusso in Oracle Integration Cloud.	Evento business non abilitato in ERP.	Procedere come segue: Recuperare un elenco di eventi business disponibili Recuperare l'evento business specifico Aggiornare l'indicatore di abilitazione per l'evento business Controllare la sottoscrizione all'evento business È possibile chiamare la risorsa REST della sottoscrizione `PublicEvent` utilizzando qualsiasi client REST per controllare lo stato della sottoscrizione. Method : GET URL : https://fa_host.oraclecloud.com/soa-infra/PublicEvent/subscriptions La risposta contiene l'URL dell'endpoint per la sottoscrizione correlata. Per la risoluzione dei problemi relativi agli eventi business, fare riferimento alla sezione Risoluzione dei problemi correlati agli eventi business
Il giornale contabilizzato non viene chiuso in Financial Consolidation and Close	Il nome del batch del giornale viene aggiornato con informazioni aggiuntive quando si contabilizza il giornale	Procedere come segue: Creare una nuova connessione in Task Manager. Ad esempio, Custom_XXX_ERP. Creare un'integrazione customizzata e un tipo di task in Task Manager. Nota: Creare l'integrazione in una nuova connessione. Utilizzare gli stessi parametri dell'integrazione predefinita. Aggiungere come prefisso il nome dell'integrazione, il nome del codice e il nome dell'evento. Ad esempio, Custom_XXX_JournalPostEvent. In Oracle Integration Cloud: Creare una nuova connessione per Oracle Cloud ERP e Oracle Fusion Cloud EPM. Duplicare il flusso OIC predefinito. Sostituire le connessioni per puntare a nuove connessioni create per Cloud ERP ed EPM Cloud. Customizzare il flusso OIC per rimuovere le informazioni dal nome del batch. Inviare il nome del batch modificato all'API di aggiornamento task per il monitoraggio eventi. Effettuare il test del flusso end-to-end da Oracle Cloud ERP a Tax Reporting. Per ulteriori informazioni, fare riferimento alla sezione Creazione di integrazioni customizzate.

Creare un'applicazione OAuth distinta e concedere il ruolo Amministratore servizi per l'applicazione OAuth. Aggiungere l'ambito OIC. Fare riferimento alla sezione Impostazione dell'integrazione in Task Manager.

Questa operazione è necessaria per poter distribuire il flusso OIC integrato da Task Manager a OIC.

La contabilizzazione del giornale non ha attivato il flusso in Oracle Integration Cloud.

Evento business non abilitato in ERP.

Procedere come segue:

Recuperare un elenco di eventi business disponibili
Recuperare l'evento business specifico
Aggiornare l'indicatore di abilitazione per l'evento business
Controllare la sottoscrizione all'evento business
È possibile chiamare la risorsa REST della sottoscrizione PublicEvent utilizzando qualsiasi client REST per controllare lo stato della sottoscrizione.
```
Method : GET
URL : https://fa_host.oraclecloud.com/soa-infra/PublicEvent/subscriptions
```
La risposta contiene l'URL dell'endpoint per la sottoscrizione correlata.

Per la risoluzione dei problemi relativi agli eventi business, fare riferimento alla sezione Risoluzione dei problemi correlati agli eventi business

Il giornale contabilizzato non viene chiuso in Financial Consolidation and Close

Il nome del batch del giornale viene aggiornato con informazioni aggiuntive quando si contabilizza il giornale

Procedere come segue:

Creare una nuova connessione in Task Manager. Ad esempio, Custom_XXX_ERP.
Creare un'integrazione customizzata e un tipo di task in Task Manager.

Nota:
Creare l'integrazione in una nuova connessione. Utilizzare gli stessi parametri dell'integrazione predefinita. Aggiungere come prefisso il nome dell'integrazione, il nome del codice e il nome dell'evento. Ad esempio, Custom_XXX_JournalPostEvent.
In Oracle Integration Cloud:
1. Creare una nuova connessione per Oracle Cloud ERP e Oracle Fusion Cloud EPM.
2. Duplicare il flusso OIC predefinito.
3. Sostituire le connessioni per puntare a nuove connessioni create per Cloud ERP ed EPM Cloud.
4. Customizzare il flusso OIC per rimuovere le informazioni dal nome del batch.
5. Inviare il nome del batch modificato all'API di aggiornamento task per il monitoraggio eventi.
6. Effettuare il test del flusso end-to-end da Oracle Cloud ERP a Tax Reporting.

Per ulteriori informazioni, fare riferimento alla sezione Creazione di integrazioni customizzate.