Descrizione del processo di integrazione di dati di Oracle ERP Cloud mediante una query customizzata

È possibile recuperare dati da Oracle ERP Cloud con una query customizzata e caricarli in Oracle Enterprise Performance Management Cloud. La query customizzata viene eseguita su qualsiasi report di Oracle Business Intelligence Publisher che crea un file dati in formato CSV e quindi carica i dati in EPM Cloud. In questo caso, Integrazione dati esegue il report per estrarre i dati e li carica in EPM Cloud.

Di seguito è riportata la procedura per caricare i dati da Oracle ERP Cloud in EPM Cloud utilizzando le estrazioni di report di BI Publisher tramite una query customizzata.

Nota:

Per creare una definizione di integrazione di Oracle ERP Cloud customizzata con EPM Cloud e registrarla come job ESS, fare riferimento alla sezione Registrazione di un report di BI Publisher come job di Oracle Enterprise Scheduler (ESS).
  1. Un'integrazione Oracle ERP Cloud richiede i privilegi o il ruolo utente e l'accesso ai dati di tutti i libri contabili ERP da integrare. Per ulteriori informazioni sui requisiti relativi ai ruoli di sicurezza di Oracle ERP Cloud, fare riferimento a Oracle ERP Cloud - Protezione del sistema ERP.

  2. Passare a Oracle ERP Cloud ed eseguire un report di BI Publisher facendo clic su Programma nuovo processo.

    Immagine di BI Publisher con l'opzione Programma nuovo processo selezionata.

  3. Nella pagina Cerca e seleziona, in Nome selezionare un report o un'estrazione e fare clic su OK.

    È possibile selezionare qualsiasi report di BI Publisher se produce un file di output in formato CSV. Non tutti i report di Fusion producono un file in formato CSV.

    Immagine delle selezioni dei report

    Nell'esempio seguente viene immesso Trial per cercare un report del bilancio di verifica.

    Immagine della pagina Cerca e seleziona

  4. In Dettagli processo selezionare i parametri per l'estrazione o il report e fare clic su Sottometti.

    Nell'esempio seguente, il valore per "Ledger" è Vision Operations e "Tipo di importo" è Progressivo anno o Progressivo periodo.

    Ricordarsi di specificare il periodo contabile. Il periodo contabile è il parametro che verrà impostato in Integrazione dati per consentire il riutilizzo del report.

    Nota:

    L'integrazione di Oracle ERP Cloud e EPM Cloud avrà esito positivo solo se l'estrazione selezionata sul lato Oracle ERP Cloud contiene uno o più parametri di associazione passati da EPM Cloud. Il parametro di associazione è un segnaposto dei valori effettivi nell'istruzione SQL. I parametri di associazione devono essere racchiusi tra caratteri tilde (~~). Ad esempio, per utilizzare il periodo come parametro di associazione, specificare: ~PERIOD~. Il nome deve corrispondere esattamente al nome specificato nella query SQL.

    A questo scopo, creare direttamente nel report un parametro di associazione che non sia utilizzato come riferimento nella query del modello di dati. In Integrazione dati, specificare nell'elenco dei parametri del report una stringa casuale, come "ABC", che verrà passata al parametro di associazione creato nella definizione del report.

    Immagine della pagina Cerca e seleziona.

    Immagine che mostra la pagina Dettagli processo.

    Dopo che il report è stato generato, nella sezione Output vengono visualizzati i risultati della sottomissione.

    Immagine con la sezione Output del report.

  5. Fare clic su Ripubblica, quindi nella pagina Output report fare clic su csv.

  6. Selezionare il file di output CSV, fare clic su di esso con il pulsante destro del mouse, quindi selezionare Apri.

    Immagine con il file di output CSV del report.

  7. Salvare il report localmente nel file system.

    Rinominare il file di output scaricato come Appname.csv, dove Appname è il nome applicazione che si intende utilizzare per l'applicazione "origine dati" in Integrazione dati, che rappresenta l'estrazione del report di BI Publisher.

  8. Nella home page di Integrazione dati, quindi in Azioni, selezionare Applicazioni.

  9. Nella pagina Applicazioni fare clic su Immagine del pulsante Aggiungi. (icona Aggiungi).

  10. In Categoria selezionare Origine dati.

  11. In Tipo selezionare Oracle ERP Cloud (customizzato).

    Immagine visualizzata

  12. In File, fare clic su Immagine che illustra l'icona Sfoglia e passare alla cartella in cui è stato salvato il file CSV, selezionarlo e fare clic su OK.

    Immagine visualizzata

    Il report viene salvato come applicazione target e viene inserito automaticamente il nome dell'applicazione.

  13. In Prefisso, specificare un prefisso per rendere univoco il nome dell'applicazione.

    Il prefisso viene concatenato al nome del file formando un nome di applicazione univoco. Ad esempio, se si desidera dare a un'applicazione lo stesso nome di un'applicazione esistente, è possibile assegnare le proprie iniziali come prefisso.

  14. Fare clic su OK.

  15. Fare clic su Salva.

    Integrazione dati registra l'applicazione e restituisce tutte le colonne in Dettagli dimensione.

  16. Nella pagina Applicazione, fare clic su Immagine che mostra l'icona Seleziona. accanto all'applicazione origine dati e selezionare Dettagli applicazione.

  17. In Nome connessione, specificare il nome del sistema di origine.

    Ad esempio, se il nome del sistema di origine è "ERP Cloud," specificare ERP Cloud.

    È anche possibile utilizzare il nome di un sistema di origine Oracle ERP Cloud o GL oppure definirne uno nuovo.

  18. Metodo di esecuzione: specificare il metodo per eseguire il job.

    Opzioni valide:

    • Report BIP: esegue il report di BI Publisher in modalità sincrona, pertanto è previsto un limite timeout di circa 5 minuti all'interno dell'istanza di Oracle ERP Cloud. Questo metodo è adatto per i set di dati più piccoli o per le query che vengono eseguite rapidamente.

    • Job ESS: esegue il report di BI Publisher in modalità asincrona, senza limitazioni correlate al tempo di esecuzione.

  19. Nome report: immettere il nome del report e il percorso completo se il metodo di esecuzione è Report BIP. Ad esempio, immettere /Custom/MyReport.xdo. Lasciare vuoto questo campo se il metodo di esecuzione è Job ESS.

    Se è necessario trovare il nome del report in Oracle ERP Cloud, completare i passi seguenti.

    1. Passare a Oracle ERP Cloud, trovare il report e selezionare Report e analitica per recuperare le informazioni sul parametro.

      Immagine che mostra l'opzione Report e analitica

    2. Fare clic su Sfoglia catalogo.

    3. Individuare e selezionare l'estrazione o il report.

      Immagine che mostra l'individuazione del report del saldo di verifica

    4. Fare clic su Altro e quindi su Proprietà.

      Immagine che mostra la schermata Proprietà.

    5. Nella sezione Proprietà customizzate scorrere verso il basso fino al campo percorso.

    6. Copiare il valore di path (insieme al nome) e incollarlo nel campo Nome report durante la registrazione dell'applicazione target in Integrazione dati.

  20. Tornare a Integrazione dati e in Elenco parametri report specificare i parametri report della query customizzata.

    Se è necessario identificare i parametri report, procedere come segue.

    1. Passare a Oracle ERP Cloud e nella pagina Panoramica selezionare il report e fare clic su Risottometti.

      Questo passaggio consente di visualizzare ed acquisire i parametri del report definiti nell'estrazione o nel report di BI Publisher.

      Immagine che mostra la nuova sottomissione del report dalla pagina Panoramica.

      Viene generato un elenco di parametri per il report.

      Immagine che mostra l'elenco di parametri.

    2. Copiare i parametri del report visualizzati nella finestra Avvisi.

      Nota:

      Se viene passato un parametro #NULL (nullo) come parametro BI Publisher da Oracle ERP Cloud a EPM Cloud, il framework basato sull'adattatore ERP avrà esito negativo.

      Per risolvere questo problema, rimuovere tutti i parametri con valore #NULL nell'elenco dei parametri, lasciare il valore vuoto e rimuovere gli spazi.

      Segue un esempio.

      Se i parametri correnti visualizzano:

      argument1=30029384;argument2=#NULL;argument3=01-JAN-2022

      Modificare argument2=#NULL in modo da visualizzare:

      argument1=30029384;argument2=;argument3=01-JAN-2022

    3. Passare a Integrazione dati e incollare l'elenco dei parametri del report dalla finestra Avvisi al campo Elenco parametri report della query customizzata.

      Ricordarsi di specificare una stringa casuale, come "ABC", nell'elenco dei parametri del report, che verrà passata al parametro di associazione creato nella definizione del report. Se si crea un report con una query che non contiene parametri di associazione passati da EPM Cloud, il processo avrà esito negativo sul lato EPM Cloud.

  21. In Integrazione dati, impostare il mapping di integrazione tra l'origine dati Oracle ERP Cloud e l'applicazione target definendo un formato di importazione.

    Fare riferimento alla sezione Mapping delle dimensioni.

  22. Definire la posizione utilizzata per associare il formato di importazione.

  23. Mappare i membri dell'origine sul target.

    Fare riferimento alla sezione Mapping dei membri.

  24. Selezionare le opzioni per origine e target.

    Fare riferimento alla sezione Impostazione delle opzioni di integrazione dati.

  25. Eseguire l'integrazione.

    Fare riferimento alla sezione Esecuzione di un'integrazione.