Generare un file di importazione dati basata su file (FBDI)
Il primo passo è generare il file FBDI (File Based Data Import) per l'utilizzo da parte di Oracle Cloud ERP.
La maggior parte delle integrazioni in blocco con l'ERP utilizza i file FBDI. Un file FBDI è un file di dati flat con contenuti simili ai seguenti:
NEW,1,2018/03/01,Balance Transfer,Remote Transfer,USD,2018/03/01,A,01,000,1212,0000,000,,,,,,,,,,,,,,,,,,,,,,,,,,99.00,,,,Team A Team Batch5,,,Orange Journal5,,,,,,,,,,,,,,,,,,,,,123,,,,,,,,,,,,,,,,,,,,,,,,,,END
NEW,1,2018/03/01,Balance Transfer,Remote Transfer,USD,2018/03/01,A,01,000,4111,0000,000,,,,,,,,,,,,,,,,,,,,,,,,, ,99.00,,,,Team A Team Batch5,,,Orange Journal5,,,,,,,,,,,,,,,,,,,,,123,,,,,,,,,,,,,,,,,,,,,,,,,,END
Se il file di dati dell'applicazione di origine non è in formato FBDI, è necessario convertirlo in formato FBDI utilizzando la funzionalità di mapper Oracle Integration (XSLT) per trasformarlo dal formato di origine al formato di destinazione. Tuttavia, possono verificarsi casi in cui il file generato dall'origine è troppo grande, ad esempio 500 MB.
La lettura di un file di grandi dimensioni in memoria può provocare l'esaurimento della memoria. Poiché Oracle Integration è un'offerta PaaS, sono disponibili controlli sulle dimensioni dei file che è possibile leggere con l'adattatore FTP. Oracle Integration limita al massimo 1 MB il file più grande che è possibile leggere in memoria utilizzando l'adattatore FTP. Tuttavia, Oracle Integration è in grado di leggere file di origine di grandi dimensioni in una serie di chunk utilizzando una funzione denominata Lettura fase. Lettura fase è una funzione di riduzione della mappa all'interno di Oracle Integration.
Poiché la lettura chunk da un server FTP è costosa per il processo e la larghezza di banda, Oracle consiglia di scaricare il file in locale in Oracle Integration prima di utilizzare lettura nel flusso di Oracle Integration.
Usa pattern di orchestrazione FBDI (File-Based Data Import)
Di seguito è riportato un pattern di orchestrazione di esempio di Oracle Integration per convertire uno o più file in un file ZIP di origine nel formato FBDI.
Il flusso logico da convertire da un formato di origine al formato FBDI segue i passi riportati di seguito.
- Leggere il file di trigger.
- Scaricare il file di dati di origine.
- Chunk ha letto e trasformato i dati in formato FBDI. Il loop esterno garantisce l'elaborazione di più file di dati.
- Creare un file di elenco.
- Generare uno o più file di proprietà e scrivere il file ZIP.
- Archiviare il file di origine.
- Archiviare il file di trigger.
Ad esempio:

Descrizione della scrittura contabile dell'illustrazione: entry-1.png
Lettura del file di trigger
La lettura del file trigger è un'integrazione pianificata di Oracle Integration.
L'accesso al file trigger viene eseguito in base a una pianificazione configurata. Il primo passo consiste nel leggere il file di trigger posizionato su un server FTP. Il file trigger è un file a zero byte con lo stesso nome del file di dati di origine. Il file trigger fornisce il nome del file di dati di origine che deve essere letto dalle attività a valle in questo flusso di Oracle Integration. Viene utilizzato un file trigger per assicurarsi che l'applicazione di origine abbia scritto completamente il file di dati prima che Oracle Integration tenti di accedere al file di dati da leggere. L'adattatore FTP in Oracle Integration supporta la proprietà minimum age
, ma a volte l'applicazione di origine sta tentando di aggiungere un file di dati in presenza di numerosi record. Poiché minimum age
non è disponibile per tali scenari, viene utilizzato un file trigger.
Scaricare il file di dati di origine
Il passo successivo consiste nel scaricare il file di dati di origine in Oracle Integration.
Il flusso Oracle Integration è stato scritto con il requisito che il file di dati di origine sia un file ZIP compresso che può contenere uno o più file di formato dati di origine.
Leggi e trasforma il file di dati
Utilizzare la funzione Lettura fase in Oracle Integration per leggere un file di dati in chunk più piccoli.
Ogni chunk viene trasformato dal formato di origine al formato FBDI e quindi crea un file FBDI di output. Il for-loop esterno mostrato nel diagramma garantisce che se vi sono più file come parte del file ZIP di origine, ognuno viene letto e trasformato in un file in formato FBDI separato.
Generazione del file lista
Generare un file di elenco per Oracle Integration per determinare il numero di file FBDI creati.
Creazione della proprietà e dei file ZIP
In questo passo, generare un file delle proprietà e scrivere il file ZIP.
Oracle Integration utilizza l'adattatore Oracle Cloud ERP per caricare i file FBDI in Oracle Cloud ERP. Sebbene l'adattatore Oracle Cloud ERP utilizzi internamente i servizi Web forniti da Oracle Cloud ERP, offusca molte complessità legate ai servizi Web di tipo RAW. L'adattatore Oracle Cloud ERP prevede il caricamento di un file ZIP contenente i file FBDI e delle proprietà in Oracle Cloud ERP. Il file delle proprietà è un file manifesto che contiene informazioni su Jobname
e Parameterlist
che l'adattatore Oracle Cloud ERP deve caricare il file FBDI in Oracle Cloud ERP.