1. Importar dados baseados em arquivo para o Oracle Fusion Cloud Enterprise Resource Planning
  2. Gerar um Arquivo FBDI (File-Based Data Import)

Gerar um Arquivo FBDI (File-Based Data Import)

A primeira etapa é gerar o arquivo de Importação de Dados Baseada em Arquivo (FBDI) para consumo pelo Oracle Cloud ERP.

A maioria das integrações em massa com o ERP usa arquivos FBDI. Um arquivo FBDI é um arquivo de dados simples com conteúdo semelhante ao seguinte:

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 o arquivo de dados do aplicativo de origem não estiver no formato FBDI, você deverá convertê-lo no formato FBDI usando a funcionalidade do mapeador (XSLT) do Oracle Integration para transformá-lo do formato de origem no formato de destino. No entanto, pode haver casos em que o arquivo gerado pela origem é muito grande, por exemplo, 500 MB.

A leitura de um arquivo grande na memória pode fazer com que ele fique sem memória. Como o Oracle Integration é uma oferta PaaS, há verificações nos tamanhos dos arquivos que podem ser lidos com o Adaptador FTP. O Oracle Integration limita o maior arquivo que pode ser lido na memória usando o Adaptador FTP a um máximo de 1 MB. No entanto, o Oracle Integration pode ler arquivos de origem grandes em uma série de chunks usando um recurso chamado Leitura Temporária. Preparação é um recurso de redução de mapa no Oracle Integration.

Como a leitura de chunk de um Servidor FTP é cara em termos de processo e largura de banda, a Oracle recomenda que você primeiro faça download do arquivo localmente para o Oracle Integration antes de usar Leitura Temporária no fluxo do Oracle Integration.

Usar um Padrão de Orquestração de Importação de Dados Baseada em Arquivo (FBDI)

Veja a seguir um exemplo de padrão de orquestração do Oracle Integration para converter um ou mais arquivos em um arquivo ZIP de origem no formato FBDI.

O fluxo lógico para converter de um formato de origem para o formato FBDI segue estas etapas:

  1. Leia o arquivo de trigger.
  2. Faça download do arquivo de dados de origem.
  3. Chunk lê e transforma os dados no formato FBDI. O loop externo garante que vários arquivos de dados sejam processados.
  4. Crie um arquivo de lista.
  5. Gere um ou mais arquivos de propriedade e grave o arquivo ZIP.
  6. Arquive o arquivo de origem.
  7. Arquive o arquivo de acionador.

Por exemplo:


Veja a seguir a descrição do diário-entry-1.png
Descrição da ilustração diário - entry-1.png

Ler o Arquivo de Trigger

A leitura do arquivo de trigger é uma integração programada do Oracle Integration.

O arquivo de trigger é acessado com base em uma programação configurada. A primeira etapa é ler o arquivo de trigger que você coloca em um servidor FTP. O arquivo de trigger é zero byte com o mesmo nome que o arquivo de dados de origem. O arquivo de trigger fornece o nome do arquivo de dados de origem a ser lido pelas atividades downstream neste fluxo do Oracle Integration. Um arquivo de trigger é usado para garantir que o aplicativo de origem tenha gravado o arquivo de dados completamente antes que o Oracle Integration tente acessar o arquivo de dados para leitura. O Adaptador FTP no Oracle Integration suporta a propriedade minimum age, mas às vezes o aplicativo de origem pode estar tentando anexar a um arquivo de dados se houver muitos registros. Como minimum age não está disponível para esses cenários, um arquivo de trigger é usado.

  1. Inicie o upload do seu arquivo de dados para o servidor FTP.
  2. Aguarde que o arquivo de dados seja completamente gravado.
  3. Escreva um arquivo trigger no mesmo local no servidor FTP.
    Quando o fluxo programado do Oracle Integration vê o arquivo de trigger no servidor, ele começa a fazer download do arquivo de dados com o mesmo nome.

Fazer Download do Arquivo de Dados de Origem

A próxima etapa é fazer download do arquivo de dados de origem no Oracle Integration.

O fluxo do Oracle Integration foi gravado com o requisito de que o arquivo de dados de origem seja um arquivo ZIP compactado que possa conter um ou mais arquivos de formato de dados de origem.

  1. No Assistente de Configuração do Ponto Final do Oracle Adapter, Configure os Parâmetros de Operação para o Ponto Final FTP de Destino, informe suas Informações Básicas e clique em Próximo para acessar a etapa Operações.
  2. Em Selecionar Operação, selecione Fazer Download do ICS.
  3. Em Fazer Download do Caminho do Diretório, informe /fbdi/.
    O caminho está no servidor do Oracle Integration, que você não pode acessar. O Oracle Integration cria essa pasta quando necessário e, em seguida, limpa a pasta após sua conclusão.
  4. Marque a caixa Descompactar o arquivo.
  5. Clique em Próximo e conclua as etapas restantes do assistente.

Chunk Read and Transform the Data File

Use o recurso Leitura de Estágio no Oracle Integration para ler um arquivo de dados em partes menores.

Cada chunk é transformado do formato de origem para o formato FBDI e, em seguida, cria um arquivo FBDI de saída. O loop for externo mostrado no diagrama garante que, se houver vários arquivos como parte do arquivo ZIP de origem, cada um seja lido e transformado em um arquivo formatado FBDI separado.

Gerar o Arquivo de Lista

Gere um arquivo de lista para o Oracle Integration para determinar quantos arquivos FBDI foram criados.

Criar a Propriedade e os Arquivos ZIP

Nesta etapa, gere um arquivo de propriedade e grave o arquivo ZIP.

O Oracle Integration usa o Oracle Cloud ERP Adapter para fazer upload de arquivos FBDI para o Oracle Cloud ERP. Embora o Adaptador do Oracle Cloud ERP utilize internamente serviços Web fornecidos pelo Oracle Cloud ERP, ele ofusca muitas complexidades envolvidas nos serviços Web brutos. O Adaptador do Oracle Cloud ERP espera que um arquivo ZIP contendo FBDI e arquivos de Propriedade faça upload para o Oracle Cloud ERP. O arquivo de propriedade é um arquivo de manifesto que contém informações sobre Jobname e Parameterlist que o Adaptador do Oracle Cloud ERP precisa fazer upload do arquivo FBDI no Oracle Cloud ERP.

Arquivar os Arquivos de Origem e de Trigger

Os arquivos de origem e de acionamento são arquivados para referência futura em um local FTP.

Por exemplo, você pode usar esses arquivos para fins de reenvio.