Criação de uma Integração do Arquivo de Exportação de Dados

A Exportação de Dados para um Arquivo permite que você exporte dados de um aplicativo do Oracle Fusion Cloud Enterprise Performance Management para um arquivo de dados. Você pode usar o arquivo de dados a fim de carregar dados em um aplicativo do Oracle ERP Cloud ou em um sistema externo.

Ao criar um aplicativo de exportação de dados para um arquivo, observe o seguinte:

Quando dimensões são criadas, a ordem da coluna no arquivo de dados é usada para atribuir a ordem das colunas. A primeira coluna do arquivo é atribuída à coluna de dados CONTA.
É recomendável exportar somente um ano por vez. Se os intervalos de datas ultrapassarem o limite de um ano, pode ser que a data seja duplicada.
A categoria de PDV não é validada.
Regras de Verificação podem ser criadas com base em um arquivo de exportação de dados. Regras de verificação não podem ser baseadas em valores de destino.
O write-back não se aplica a arquivos de exportação de dados.
Só há suporte para os tipos de dados numéricos. Se você precisar exportar texto, SmartList e datas, use um aplicativo de arquivo de dados EPM com o tipo: "Arquivo de Dados do EPM" e a opção de extração de dados "Dados de Nível 0". Use este aplicativo como alvo ao criar sua integração.

Você também pode usar a classe pública groovy DataExporter. Para obter mais informações, consulte Exportador de Dados de Classe.
A definição do Modo de Workflow padrão é Simples para Exportação de Dados para Arquivo. Ao exportar dados do Cloud EPM, não há suporte para drill, então o modo de workflow padrão é definido como Simples.

Se você quiser ver os dados no Workbench para fins de teste, defina o Modo de Workflow como Completo. Para obter mais informações, consulte Definição das Opções de Detalhes de Aplicativo.
Para adicionar um timestamp, crie uma nova coluna de exportação no aplicativo de destino. Em seguida, crie um Mapeamento para SQL Like na próxima coluna. Por fim, no script, digite CURRENT_TIMESTAMP.

Observe que esse método usa um timestamp completo, como 21-JAN-22 04.14.33.677306 PM +00:00, que se baseia no horário do servidor e não necessariamente no horário local.

Para formatar o timestamp, use a sintaxe TO_CHAR. Para obter mais informações, consulte TO_CHAR (datetime).
Os valores de destino não são validados para aplicativos de exportação de dados para um arquivo.
Quando a integração é executada, o Data Integration exporta os dados. O Data Integration cria um arquivo de dados de saída. O nome do arquivo de dados é <Target App Name>_<Process ID>.dat, e ele é gravado no diretório <APPL ROOT FOLDER>/outbox. Você pode acessar o arquivo de dados da página Detalhes do Processo na coluna Arquivo de SAÍDA.
Usando o campo Nome do Arquivo de Download nas opções do Aplicativo de Destino de Exportação de Dados, você também pode especificar seu próprio nome de arquivo ao gerar um arquivo de saída de exportação de dados como parte de uma exportação de dados para a definição de integração de arquivo, por exemplo, PlanExport.csv.

O sistema cria o arquivo de saída na pasta inbox/outbox da plataforma. A pasta inbox/outbox pode ser acessada pelo cartão Aplicativo na página Início, em Visão Geral. Em seguida, na lista suspensa Ações, selecione Inbox/Outbox Explorer.

Você também pode criar o arquivo em pastas do Data Integration prefixando a pasta no nome do arquivo; por exemplo, inbox/PlanExport.csv ou outbox/PlanExport.csv.

Nota:
São suportadas subpastas para inbox; por exemplo, inbox/userx/PlanExport.csv. Não é possível criar subpastas em outbox.

Se o campo Nome do Arquivo de Download for deixado em branco, o arquivo de saída será criado na pasta da caixa de saída com o nome <Nome do Aplicativo>_<ID do Processo>.dat.
Se você tiver um job de exportação de dados agendado diariamente e precisar que o arquivo de saída seja distribuído automaticamente a um indivíduo, use Fazer Download do Instantâneo do Aplicativo na API REST para Enterprise Performance Management Cloud para baixar um arquivo específico e forneça o caminho para esse arquivo como o valor de applicationSnapshotName. Por exemplo, para baixar um arquivo do Data Integration chamado s112.csv na caixa de entrada, faça referência ao arquivo como "inbox/s112.csv" no parâmetro de caminho.

Para criar uma definição de integração de Arquivo de Exportação de Dados:

Crie um arquivo .CSV com a lista de colunas na ordem que deseja exportar.

Nota:
Não inclua a coluna Valor no arquivo de dados. Se estiver incluído, você poderá excluí-lo após a criação do aplicativo.

O nome do arquivo é o nome do aplicativo. Portanto, nomeie o arquivo apropriadamente.
Na página inicial do Data Integration, no menu Ações, na lista suspensa de ações Configuração, selecione Aplicativos.
Na página Aplicativos, clique em .
Na página Criar Aplicativo e depois em Categoria, selecione Exportação de Dados.
Em Tipo, selecione Exportação de Dados para Arquivo.
Em Arquivo, selecione o nome do arquivo de origem de onde deseja criar o aplicativo.

Você também pode clicar em e procurar um arquivo na página Navegador de Arquivos.
Em Prefixo, especifique um prefixo para tornar exclusivo o nome do aplicativo.
O prefixo está concatenado com o nome do arquivo para formar um nome de aplicativo exclusivo. Por exemplo, se desejar nomear um aplicativo com o mesmo nome de um que já existe, você poderá atribuir as suas iniciais como o prefixo.
Clique em OK.

O sistema registra o aplicativo.
Na página Aplicativo, clique em à direita do aplicativo de destino de dados e selecione Detalhes do Aplicativo.
Selecione a guia Dimensões.
Em Detalhes do Aplicativo, selecione a guia Detalhes da Dimensão.
Edite o Nome da Dimensão e o Nome da Coluna de Dados, conforme necessário.
Em Sequência, especifique a ordem na qual os mapas são processados.

Por exemplo, quando a Conta for definida como 1, Produto será definido como 2, e Entidade será definida como 3, em seguida, o Data Integration primeiro processa o mapeamento da dimensão Conta, depois o Produto e, por fim, Entidade.
Em Ordem das Colunas, especifique a ordem de cada coluna no arquivo de exportação de dados.
Por padrão, a Integração de Dados atribui a dimensão "Conta" como a primeira coluna na ordem.
Clique em Salvar.
Em Detalhes do Aplicativo, selecione a guia Opções.
Selecione propriedades e valores aplicáveis para o arquivo de exportação de dados.
Para obter mais informações, consulte Opções de Aplicativos de Destino para Exportação de Dados.
Clique em Salvar.
Na página inicial da Integração de Dados, clique em (Criar) e depois selecione Integração.

A página Geral é mostrada na exibição Criar Integração.
Em Nome e Descrição, digite um nome e a descrição para a nova integração direta.
Em Local, digite o nome de um novo local ou escolha um local existente para especificar onde carregar os dados.

É usado um local para vincular uma Origem e um Destino juntamente com os mapeamentos de membros associados. Você pode definir várias integrações dentro de um mesmo local com um conjunto diferente de Opções e critérios de Filtro. O local é usado principalmente para controlar o acesso a uma integração. Você pode usar a Segurança do Local para controlar o acesso a usuários finais.

Se você inserir um novo local, deverá fornecer a Origem e o Destino. Quando você salva a integração, a Integração de Dados cria o local manualmente.

Se você selecionar um local existente, a Integração de Dados preencherá os valores de Origem e de Destino automaticamente e não será possível alterá-los.
Clique em (Selecione uma Origem).
Na página Selecione uma Origem, selecione o sistema de origem da integração direta.
Clique em (Selecione um Destino).
Na página Selecionar um Destino, selecione o aplicativo de destino do arquivo de exportação de dados.
Clique em Salvar.
Selecione Mapear Dimensões e mapeie membros da dimensão de origem para os respectivos membros da dimensão do aplicativo de destino correspondente.

Para obter mais informações, consulte Mapeamento de Dimensões.
Execute a integração para extrair os dados do sistema de origem e carregá-los no arquivo de exportação de dados do aplicativo de destino.
Para obter mais informações, consulte Execução de uma Integração.