runIntegration

Aplica-se a

Funções Necessárias

Uso

• Para integrações do Modo Padrão, é preciso especificar os valores para importMode, exportMode e periodName
• Para integrações do Modo Rápido, é preciso especificar o valor para exportMode
• Nomes de parâmetro e seus valores fazem distinção entre maiúsculas e minúsculas

• JOB_NAME é o nome de um job de integração definido na Integração de Dados.
• importMode determina como os dados são importados na Integração de Dados. Os modos de importação aceitáveis são:
  • Append para adicionar aos dados de PDV existentes na Integração de Dados.
  • Replace para excluir os dados do PDV e substituí-los pelos dados do arquivo.
  • Map and Validate para ignorar a importação de dados, mas reprocessar os dados com mapeamentos atualizados e contas lógicas.
  • No Import para ignorar a importação de dados na tabela intermediária da Integração de Dados.
• exportMode determina como os dados são carregados no aplicativo de destino. Em integrações do Modo Rápido, não é possível usar Check e No Export como o valor do parâmetro exportMode. Os valores aceitáveis do modo de exportação são:
  • Merge para atualizar os dados existentes e adicionar novos dados.
  • Replace para limpar os dados existentes no PDV e carregá-los com novos dados. No modo Padrão, os dados são limpos para as dimensões Cenário, Versão, Ano, Período e Entidade. No Modo Rápido, os dados são limpos para as dimensões Ano, Período e Entidade. Você pode definir regiões de limpeza personalizadas para ambos os modos.
  • Accumulate para adicionar os dados aos dados existentes. Aplicável ao Planning, Módulos do Planning, Financial Consolidation and Close, Tax Reporting, Profitability and Cost Management e Enterprise Profitability and Cost Management.
  • Subtract para subtrair os dados do saldo existente. Aplicável ao Profitability and Cost Management, e Enterprise Profitability and Cost Management.

    Para integrações do Modo Rápido:

    • Não é possível usar Check e No Export como o valor desse parâmetro.

    • Para o Planning, Planning Modules e Financial Consolidation and Close, os valores válidos são somente Replace, Merge e Accumulate.

  • No Export para ignorar a exportação de dados. Use esse modo para carregar dados na tabela intermediária a fim de revisar antes de carregar no aplicativo de destino.

  • Check somente para executar uma verificação de validação de dados.

    Para o Oracle Fusion Cloud como um destino, somente os seguintes modos de exportação são suportados:

    • MERGE para mesclar os dados na tabela intermediária da Integração de Dados com os dados existentes.
    • NONE para ignorar a exportação de dados da Integração de Dados para o aplicativo
• periodName é o nome de um ou mais períodos, ou intervalos de períodos, cada um entre chaves, para os quais importar ou exportar os dados. As convenções de nomenclatura de período aceitáveis são estas:
  • Para carregamentos de período único, especifique o nome do período entre chaves, por exemplo, {Jan-21}
  • Para carregamentos de vários períodos, coloque os nomes do período de início e de término entre chaves, por exemplo, {Jan-21}{Mar-21} (para carregar dados de todos os períodos, começando em 21 de janeiro e terminando em 21 de março)
  • Para Planning, Módulos do Planning, Financial Consolidation and CloseFormato Livre, and Tax Reporting: é possível especificar o Nome do Período do Processo de Negócios e o ano no formato {Jan#FY21}{Mar#FY21} para carregar dados de todos os períodos, começando em 21 de janeiro e terminando em 21 de março.

    O nome do período deve ser colocado entre chaves.

    • Período Único – Refere-se ao nome do período do Gerenciamento de Dados para um único período definido no mapeamento Período.
    • Vários Períodos – Refere-se a um carregamento de vários períodos. O parâmetro é especificado no formato {Month-Year}{Month-Year}. Por exemplo, {Jan-20}{Mar-20} para um carregamento de vários períodos, de 20 de janeiro a 20 de março.
    • Nome do Período do Planning – Refere-se a um nome do período do Planning no formato {Month#Year}, por exemplo, {Jan#FY20}{Mar#FY20}. Usando essa convenção, não é necessário especificar nomes de período da Integração de Dados. Em vez disso, especifique os nomes de membro para as dimensões Ano e Cenário.

      Esse parâmetro é aceito nos processos de negócios do Planning,Tax Reporting e Financial Consolidation and Close. Ele funciona para seus aplicativos de serviço e implantações em nuvem derivadas de origens de dados on-premises.

      Usar essa convenção será útil se acionada de um script Groovy do EPM Cloud com a captura dos nomes de membro Ano e Período. O mapeamento do período do aplicativo ou o mapeamento do período global devem existir com o Ano e Mês nos valores de destino do mapeamento do período.

    • Variável de Substituição – Esta é uma extensão do formato de nome de período anterior do Planning em que uma variável de substituição, em vez dos nomes de membro reais Ano e Mês, pode ser especificada no formato {Month#&CurYr}{&FcstMonth#&CurYr}; por exemplo, {Jan#&CurYr}{&FcstMonth#&CurYr}.

      Uma combinação de ambos os nomes de membro reais, bem como as variáveis de substituição são permitidas.

      Esse formato é aceito nos processos de negócios do Planning,Tax Reporting e Financial Consolidation and Close .

      O mapeamento do período do aplicativo ou o mapeamento do período global devem existir na Integração de Dados do ambiente onde o comando é executado, com os valores de Ano e Mês disponíveis nos valores de destino do mapeamento do período. Nesse caso, Ano e Mês se referem ao valor atual da variável de substituição durante a execução.

    • GLOBAL POV – Executa o carregamento de dados para o período do PDV Global. Use o formato {GLOBAL_POV}.

    Note:

    Se você usar qualquer parâmetro de nomenclatura de período diferente dos parâmetros descritos nesta discussão, uma mensagem de erro Invalid Input – HTTP 400 será exibida.

    Copie a seção periodName do documento da API REST. Ela descreve os diferentes formatos, como PDV Global, Subvar, etc.

  • {GLOBAL_POV} para executar o carregamento de dados para o período definido no PDV Global no sistema ou nas Configurações de Aplicativo na Integração de Dados.

    Note:

    O formato de convenção de nomenclatura de período {Month#Year} é permitido para o Planning, Módulos do Planning, Financial Consolidation and Close e Tax Reporting. Sob essa convenção, é possível especificar nomes de membro para as dimensões Ano e Cenário em vez dos nomes de período da Integração de Dados. Essa abordagem será útil se o comando for acionado de um script Groovy com a captura dos nomes de membro Ano e Período.

    A convenção de nomenclatura da variável de substituição {Jan#&CurYr}{&FcstMonth#&CurYr} é uma extensão da convenção de nomenclatura de período anterior. Você pode especificar a variável de substituição em vez dos nomes de membro Ano e Mês se estiver executando esse comando no Planning, Módulos do Planning, Financial Consolidation and Close e Tax Reporting. Uma combinação de nomes de membro e variáveis de substituição também é permitida.

    As convenções de nomenclatura de período anterior e de nomenclatura da variável de substituição funcionarão somente se os mapeamentos do período de aplicativo ou mapeamentos do período global com o Ano e o Mês nos valores de destino já existirem na Integração de Dados.
• inputFileName, para carregamentos de dados baseados em arquivo, especifica o nome do arquivo, disponível na caixa de entrada, do qual os dados devem ser importados. Se você especificar o nome do diretório na definição da Integração, passe somente o nome do arquivo. Se não incluir um nome de diretório na definição de Integração, use o formato inbox/DIR_NAME/FILE_NAME, por exemplo, inbox/GLBALANCES.txt ou inbox/EBSGL/GLBALANCES.txt. Se o arquivo tiver sido carregado no local padrão do ambiente, use a convenção #epminbox/FILE_NAME, por exemplo, #epminbox/GLBALANCES.txt, para identificar o arquivos de dados de entrada.

  Esse parâmetro só se aplica a carregamentos de dados baseados em arquivo nativo. Se esse valor de parâmetro não for especificado para carregamentos de dados baseados em arquivo, esse comando importará dados do arquivo especificado na definição de integração. Caso esse valor de parâmetro seja especificado para carregamentos de dados que não sejam baseados em arquivo, o comando irá ignorá-lo.

• PARAMETERS identifica opcionalmente os parâmetros de tempo de execução no formato PARAMETER_NAME="PARAMETER" . Os parâmetros incluem filtros de origem e opções de destino.

  Note:

  O único parâmetro que pode ser usado neste momento para um tipo de dimensão (metadados) do aplicativo de destino é "Refresh Database"=Yes|No.

Exemplos

• Importação de período único:

  epmAutomate runIntegration VisionDataLoad importMode=Replace exportMode=Merge period="{Mar-15}"

• Importação de Vários Períodos:

  epmAutomate runIntegration VisionDataLoad importMode=Replace exportMode=Merge period="{Mar-15} {Jun-15}"

• Integração de dados baseada em arquivo incremental:

  epmAutomate runIntegration IncrementalFileLoad importMode=Replace exportMode=Merge period="{Jan-20}{Mar-20}" inputFileName=File1.txt