Tecniche pratiche di reinserimento nell'agente di integrazione EPM

In questo argomento vengono illustrati i passi necessari per utilizzare l'agente di integrazione EPM per il caricamento dei dati in un data warehouse in locale da un'applicazione Oracle Enterprise Performance Management Cloud. Per caricare i dati sono disponibili due metodi diversi.

  1. Caricare rispettivamente i dati in base a un nome tabella nell'opzione dell'applicazione e le colonne della tabella in Dimensioni applicazione. La query Insert viene generata automaticamente dall'agente di integrazione EPM.

  2. Caricare i dati in base a un nome tabella e le colonne mediante una query Insert SQL customizzata.

Per utilizzare l'agente di integrazione EPM per il caricamento dei dati in un data warehouse in locale da un'applicazione EPM Cloud, procedere come segue.

  1. Creare una tabella RDBMS in cui verranno esportati i dati.

    In questo esempio, una tabella denominata VISION_DATA include tutte le dimensioni dell'applicazione Vision e due colonne aggiuntive denominate BATCH_ID e DATA_AMOUNT. La colonna BATCH_ID viene utilizzata per popolare l'ID processo di Integrazione dati da EPM Cloud. La colonna DATA_AMOUNT viene utilizzata per popolare la colonna dell'importo.

    Immagine che mostra una tabella RDBMS.

  2. Esportare il contenuto della tabella in un file CSV per la registrazione dell'applicazione includendo il record di intestazione per i nomi delle colonne.

    Immagine che mostra l'Esportazione guidata

    Il file di output CSV ha l'aspetto seguente:

    Immagine che mostra il file di output CSV.

    Si presuppone che tali colonne siano l'esatta rappresentazione delle colonne della tabella target. L'istruzione insert SQL viene generata in base ai nomi delle colonne.

  3. Passare a Scambio dati, alla scheda Integrazione dati, quindi al menu Azioni e scegliere Applicazioni.

    Immagine che mostra l'opzione Applicazioni del menu Azioni.

  4. Nella pagina Applicazioni registrare un'applicazione Esportazione dei dati per il processo di reinserimento procedendo come segue.

    1. In Categoria selezionare Esportazione dei dati.

    2. In Tipo selezionare Esportazione dati nel database in locale.

    3. Caricare e selezionare il file creato nel passo 2.

    Immagine che mostra la pagina Crea applicazione.

    Viene creata un'applicazione "Esportazione dei dati" il cui nome corrisponde al nome file utilizzato per registrare l'applicazione.

    Immagine che mostra la pagina Applicazioni.

  5. Nella pagina Applicazioni fare clic su Immagine che mostra l'icona Seleziona. a destra dell'applicazione, quindi selezionare Dettagli applicazione.

  6. Selezionare la scheda Dimensioni.

    Il processo di registrazione dell'applicazione assegna automaticamente "Generica" come classificazione della dimensione per tutte le colonne nel file CSV, oltre ad assegnare di conseguenza un "Nome colonna tabella dati".

    Immagine che mostra la scheda Dimensioni della pagina Dettagli applicazione.

  7. Classificare le colonne Account (Conto), Amount (Importo), Period (Periodo) e Year (Anno) in modo appropriato.

    • Classificare una colonna come Account (Conto) quando è mappata su una colonna di origine nel formato di importazione e ha sempre un valore nel campo di origine. Nell'esempio seguente, la colonna "ACCOUNT" è stata classificata come "Conto". Il Nome colonna tabella dati per tale dimensione è stato classificato come "ACCOUNT".

    • Classificare DATA_AMOUNT come "Importo" e lasciare vuoto il campo Nome colonna tabella dati.

    • Classificare YEAR come "Anno" e lasciare vuoto il campo Nome colonna tabella dati.

    • Classificare PERIOD come "Periodo" e lasciare vuoto il campo Nome colonna tabella dati.

      Immagine che mostra la scheda Dimensioni in Dettagli applicazione.

  8. Nella pagina Applicazioni, fare clic su Immagine che mostra l'icona Seleziona. a destra dell'applicazione, quindi selezionare Dettagli applicazione.

  9. Selezionare la scheda Opzioni.

  10. Specificare un valore per Nome tabella e per URL JDBC, oltre alle credenziali di database.

    Lasciare vuoto il campo Inserisci query. Se non si specifica un valore per "Inserisci query", si presuppone che le dimensioni dell'applicazione denotino esattamente lo stesso nome delle colonne di database target. Le dimensioni dell'applicazione devono contenere ognuna delle colonne della tabella target da popolare nel processo di reinserimento. In caso contrario, l'integrazione ha esito negativo.

    Immagine che mostra la scheda Opzioni della pagina Dettagli applicazione

  11. Creare l'integrazione tra l'applicazione di origine e l'applicazione EPM Cloud target.

    Nell'esempio seguente vengono mostrate un'applicazione di origine "Vision di Planning" e un'applicazione Esportazione dei dati target denominata "ORACLE_DWH".

    Immagine che mostra la pagina Crea integrazione.

  12. Mappare tutte le colonne e utilizzare "copysource()" come espressione target per tutte le dimensioni tranne "Amount" (Importo) e "BATCH_ID."

    A "BATCH_ID" viene applicata un'espressione nei mapping dei membri. La dimensione "Amount" (Importo) non ha un'espressione target.

    Immagine che mostra il mapping delle dimensioni nella pagina Crea integrazione.

  13. In Mappa membri creare un mapping #SQL per BATCH_ID utilizzando la colonna LOADID della tabella TDATASEG_T.

    Immagine che mostra il mapping #SQL per BATCH_ID con la colonna LOADID

    Immagine che mostra la dimensione BATCH_ID mappata

  14. Da Opzioni, in Filtri specificare gli eventuali filtri dell'applicazione di pianificazione di origine in base alle esigenze.

    Nell'esempio seguente non sono stati selezionati filtri perché tutti i dati provenienti dall'applicazione Vision (per l'intervallo di periodi di inizio/fine) vengono importati ed esportati nell'applicazione target.

    Immagine che mostra la scheda Filtri della pagina Opzioni.

  15. Da Opzioni, in Cubo di origine specificare il cubo di origine (tipo di piano). Quindi in Tipo di mapping periodi specificare Predefinito. Fare quindi clic su Salva come mostrato di seguito.

    Immagine che mostra la scheda Opzioni della pagina Opzioni.

  16. Avviare l'agente di integrazione EPM nell'host in locale in cui è accessibile il database target.

    Agente avviato nell'host in locale.

  17. In Integrazione dati eseguire l'integrazione per l'intervallo di periodi specificato.

    Nell'esempio seguente sono stati selezionati i periodi da Jan-16 a Dec-16:

    Immagine che mostra la pagina Esegui integrazione.

  18. Osservare l'agente in locale che recupera i dettagli del job da EPM Cloud e attendere il completamento del processo.

    Immagine che mostra i dettagli del job nell'agente.

    Immagine che mostra i dettagli del job quando questo viene eseguito in Integrazione dati.

  19. Da Dettagli processo aprire il file di log e notare il numero totale di record di dati esportati e l'istruzione della query Insert:

    Immagine che mostra il file di log in Dettagli processo.

  20. Verificare che i record siano stati esportati correttamente nel database target.

    Notare che l'ID processo cloud è mappato correttamente sulla colonna BATCH_ID nel database.

    Immagine che mostra il database target.

  21. Esportare gli stessi dati in un'altra tabella denominata VISION_DATA_2 utilizzando una query Insert in EPM Cloud.

    La query INSERT consente di utilizzare espressioni SQL complesse per il mapping delle colonne del database. Le espressioni SQL vengono eseguite sul database target e non sul database cloud (Oracle). Ciò garantisce la flessibilità necessaria per utilizzare espressioni SQL specifiche del tipo di database, ad esempio MS SQL Server, MYSQ e così via. È inoltre possibile derivare i valori di colonna utilizzando una subquery da un'altra tabella.

    Nell'esempio seguente:

    • BATCH_ID è stato rinominato come BATCH_NUMBER.

    • ENTITY è stata rinominata come ORGANIZATION.

    • Le colonne YEAR e PERIOD sono state rimosse ed è stata creata una colonna PERIOD_NAME per popolare sia Year (Anno) che Period (Periodo) nella stessa colonna.

    • La scala di DATA_AMOUNT è stata ridotta in modo da memorizzare solo due posizioni decimali.

    Non è necessario un file CSV per registrare l'applicazione perché si dispone già di un'applicazione registrata con un diverso set di nomi di colonna. Il ricorso alla query Insert SQL offre il vantaggio di poter utilizzare i nomi di colonna dell'applicazione registrata per mappare i nomi di colonna effettivi mediante tale query. L'applicazione può pertanto contenere dimensioni completamente diverse dai nomi di colonna effettivi del database target. Le dimensioni dell'applicazione possono inoltre denotare solo un subset delle colonne effettive popolate nella tabella di database target.

    Per ulteriori informazioni, fare riferimento alla sezione:Write-back con una query INSERT customizzata.

    I valori nella query INSERT vengono denotati racchiudendo il nome di dimensione target tra ~~ (due simboli di tilde). Ad esempio, se una dimensione denominata ABC nell'applicazione Esportazione dei dati deve essere mappata su una colonna DEF nel database, specificare il valore per la colonna DEF come ~ABC~.

  22. Creare una nuova query con i valori seguenti.

    1. Rimappare BATCH_ID su BATCH_NUMBER.

    2. Utilizzare il prefisso Acc, ad esempio ACCOUNT.

    3. Utilizzare il prefisso Org, ad esempio ORGANISATION.

    4. Concatenare Period (Periodo) e Year (Anno) in PERIOD_NAME.

    5. Utilizzare il prefisso Prd, ad esempio PRODUCT.

    6. Arrotondare DATA_AMOUNT a due posizioni decimali.

    Immagine che mostra la pagina Crea query.

  23. In Dettagli applicazione specificare il nome della query nell'applicazione Esportazione dei dati registrata e lasciare vuoto il campo Nome tabella.

    Immagine che mostra la pagina Dettagli applicazione.

  24. Eseguire di nuovo il processo di integrazione per un intervallo di periodi e attendere che il processo abbia esito positivo.

    Immagine che mostra la pagina Esegui integrazione.

  25. Verificare che la tabella di destinazione sia stata popolata correttamente.

    Immagine che mostra il database target popolato.