Creazione di integrazioni customizzate di Monitoraggio eventi

In Task Manager è possibile creare un'integrazione di Monitoraggio eventi per un'applicazione esterna. L'integrazione di Monitoraggio eventi viene attivata quando si verifica un evento esterno in un altro servizio cloud o in un'applicazione in locale. Un esempio di un'integrazione di Monitoraggio eventi è un trigger di Oracle E-Business Suite - General Ledger quando viene chiuso un periodo, ad esempio gennaio 2018.

Verificare di disporre dei prerequisiti necessari e procedere come segue per impostare un'integrazione tra Task Manager e un'applicazione esterna.

Per una panoramica del flusso di integrazioni customizzate, vedere Creazione di integrazioni customizzate.

Prerequisiti

Nota:

Monitoraggio eventi può essere attivato anche tramite qualsiasi strumento di integrazione in grado di richiamare le API REST. In tal caso, i prerequisiti indicati di seguito non saranno necessari.

Per integrare Task Manager con un'applicazione esterna, sono necessari gli elementi riportati di seguito.
  • Una sottoscrizione a Oracle Integration Cloud Service, per l'integrazione con i servizi in locale e non EPM Cloud.

    Nota:

    È necessaria un'istanza di Integration Cloud per singola istanza di Oracle EPM Cloud.
  • L'impostazione dell'applicazione esterna.
  1. Eseguire la sottoscrizione a Oracle Integration Cloud o a Oracle Autonomous Integration Cloud. Per informazioni dettagliate, fare riferimento alla sezione Documentazione di Integration Cloud Service .
  2. Installare l'agente Integration Cloud nell'ambiente dell'applicazione per comunicare con l'istanza di Oracle EPM Cloud in uso. Per i dettagli sull'impostazione dell'agente Integration Cloud, fare riferimento alla sezione Gestione di gruppi di agenti.

    Nota:

    Se i servizi dell'applicazione in locale sono stati distribuiti in un ambiente impostato in una configurazione di tipo DMZ (zona smilitarizzata, demilitarized zone) in modo da essere accessibili pubblicamente tramite Internet, l'installazione dell'agente Integration Cloud non è necessaria.

Impostazione dell'integrazione in Task Manager

  1. Nella home page fare clic su Applicazione, quindi su Task Manager.
  2. Fare clic sulla scheda Integrazioni posta sulla sinistra, quindi fare clic su Nuovo.
  3. Nella scheda Proprietà specificare le informazioni richieste:

    1. In Nome, immettere un nome per l'integrazione.

    2. In Codice, immettere un codice integrazione per l'attività di integrazione.

      Il codice viene utilizzato per eseguire l'integrazione e il mapping degli aggiornamenti a un'integrazione da un'importazione file.

    3. Facoltativo: nel campo Descrizione immettere una descrizione per il task di integrazione.

    4. In Connessione selezionare un'applicazione a cui appartiene il task.

      È possibile gestire l'elenco di applicazioni tramite l'icona Gestisci connessioni nella finestra di dialogo Gestisci connessioni.

    5. In Tipo di esecuzione selezionare Monitoraggio eventi.

    6. In Nome evento immettere un nome per l'evento.

  5. Nella scheda Parametri fare clic su Nuovo, quindi specificare le informazioni richieste.

    1. In Nome immettere un nome per il parametro.

    2. In Codice parametro immettere un codice parametro.

    3. Facoltativo: immettere una descrizione del parametro.

    4. Nell'elenco Tipo di parametro selezionare un tipo, quindi immettere le informazioni aggiuntive relative al parametro:

      • Casella di controllo: valore booleano

      • Data: valore data

      • Numero intero: valore numerico nei numeri interi

      • Numero: valore numerico nei numeri interi o nelle frazioni

      • Gruppo opzioni: casella di controllo per un set predefinito di valori

      • Elenco statico: set predefinito di valori di testo

      • Informazioni sul task: informazioni sul task, ad esempio assegnatario, durata, data di inizio e data di fine

      • Testo: valore di testo libero

      • Artifact EPM: nome dell'artifact, ad esempio il form o il report

    5. Se il parametro richiede un valore, selezionare Obbligatorio.

    6. Fare clic su OK per salvare il parametro.

    7. Fare clic su Salva e chiudi per salvare l'integrazione.

Creazione di un tipo di task per l'integrazione

  1. Nella home page fare clic su Applicazione, quindi su Task Manager.

  2. Fare clic sulla scheda Tipi di task a sinistra.

  3. Fare clic su Nuovo.

  4. Nella scheda Proprietà specificare un valore per i campi Nome tipo di task e ID tipo di task.

  5. In Integrazione, fare clic su Cerca, selezionare l'integrazione, quindi fare clic su OK.

  6. Nella scheda Parametri impostare i parametri del tipo di task.

Impostazione della connessione di Integration Cloud in Task Manager

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 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 configurare l'applicazione client OAuth, fare riferimento alla sezione 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.

  1. Nella home page fare clic su Applicazione, quindi su Task Manager.

  2. Fare clic sulla scheda Integrazioni posta sulla sinistra.

  3. Fare clic su Gestisci connessioni, quindi, in Azioni, selezionare Connessione di Integration Cloud.
  4. 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:

    Immettere l'URL: https://<SERVICE_NAME>-<TENANT_NAME>.integration.ocp.oraclecloud.com
  5. 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.

Impostazione dell'integrazione in Integration Cloud

Nota:

Se non si intende utilizzare Integration Cloud, saltare questo passo.

Per impostare l'integrazione in Integration Cloud:

  1. Accedere a Integration Cloud.
  2. Creare una connessione utilizzando l'adattatore Oracle Enterprise Performance Management Cloud per il servizio EPM. Per ulteriori dettagli, fare riferimento a questo collegamento: Creazione di una connessione a Oracle Enterprise Performance Management Cloud.
  3. Creare una o più connessioni all'altra applicazione in base alle esigenze specifiche.
  4. Creare un'integrazione di Controllo eventi utilizzando le connessioni create e attivarla. Fare riferimento a questo esempio: Utilizzo dell'adattatore Oracle Enterprise Performance Management Cloud con Oracle Integration.

Impostazione dell'integrazione senza Integration Cloud

Nota:

Se si intende utilizzare Integration Cloud, saltare questo passo.
Configurare lo strumento di integrazione che si intende utilizzare.

1. Rivedere l'API REST, Aggiornare lo stato del task per Monitoraggio eventi in API REST per Oracle Enterprise Performance Management Cloud.

2. Configurare lo strumento di integrazione per chiamare l'API REST per chiudere il task di Monitoraggio eventi passando i parametri per l'evento.

Per ulteriori informazioni, fare riferimento alla sezione Aggiornare lo stato del task per Monitoraggio eventi in API REST per Oracle Enterprise Performance Management Cloud.

Completamento dell'impostazione dell'integrazione in Task Manager

Per completare l'impostazione dell'integrazione in Task Manager, attenersi alla procedura riportata di seguito.

  1. Nella home page fare clic su Applicazione, quindi su Task Manager.
  2. Fare clic sulla scheda Integrazioni posta sulla sinistra, quindi verificare che la nuova integrazione sia visualizzata.
  3. In Task Manager fare clic su Programmazioni, quindi creare una nuova programmazione con stato In sospeso. Fare riferimento alla sezione Creazione manuale di programmazioni.
  4. Creare il task di monitoraggio eventi e aggiungerlo alla programmazione. Fare riferimento alla sezione Creazione di task.
  5. In Programmazioni, selezionare e aprire la programmazione.
  6. Attivare l'azione che genera l'evento nell'applicazione esterna (ad esempio, EBS). Se non si utilizza Integration Cloud e si usa invece uno strumento di integrazione diverso, richiamare l'API REST tramite lo strumento di integrazione.

    Nota:

    Passare i parametri come previsto dal tipo di integrazione, evento, parametri, in caso di mancata corrispondenza il task non verrà preso in considerazione.
  7. Attendere il completamento del task.
  8. Facoltativo: per monitorare lo stato dell'integrazione in Integration Cloud Services, accedere a Integration Cloud e passare a Monitoraggio.