Execução de Regras de Dados

Executa uma regra de carregamento de dados do Oracle Hyperion Financial Data Quality Management, Enterprise Edition com base no período de início e período de término, e nas opções de importação ou exportação que você especifica.

Pré-requisitos

  • Regras de Dados: As regras de carregamento de dados definem como o Integrations carrega dados de um arquivo. Você deve ter regras de carregamento de dados predefinidas para carregar dados.

  • É preciso ter os privilégios necessários para executar uma regra de dados específica.

Recurso REST

POST /aif/rest/{api_version}/jobs

Solicitação

Tipos de Mídia Suportados: application/json

Parâmetros

A tabela a seguir resume a solicitação do cliente.

Tabela A-1 Parâmetros

Nome Descrição Tipo Obrigatório Padrão
api_version Versão da API com a qual você está trabalhando, como V1 Caminho Sim Nenhum
jobType deve ser definido como "DATARULE"   Sim Nenhum
jobName O nome de uma regra de carregamento de dados definida no FDMEE. Você deverá colocar o nome da regra entre aspas se ele contiver um espaço.   Sim Nenhum
startPeriod O primeiro período para o qual os dados deve ser carregados. Esse nome de período deve ser definido no mapeamento de período do FDMEE.   Sim Nenhum
endPeriod O último período para o qual os dados devem ser carregados. Esse nome de período deve ser definido no mapeamento de período do FDMEE.   Sim Nenhum
importMode determina como os dados são importados no FDMEE.

Os valores aceitáveis são:

  • APPEND para adicionar aos dados de PDV existentes no FDMEE

  • REPLACE para excluir os dados de PDV e substituí-los pelos dados do arquivo

  • RECALCULATE para ignorar a importação dos dados, mas processá-los novamente com Mapeamentos e Contas Lógicas atualizados.

  • NONE para ignorar a importação de dados na tabela intermediária do FDMEE

  Sim Nenhum
exportMode determina como os dados são exportados no FDMEE.

Os valores aceitáveis para um aplicativo Oracle Hyperion Planning são:

  • STORE_DATA para mesclar os dados na tabela intermediária do FDMEE com os dados existentes do Planning

  • ADD_DATA para adicionar os dados na tabela intermediária do FDMEE ao Planning

  • SUBTRACT_DATA para subtrair os dados na tabela intermediária do FDMEE de dados existentes do Planning

  • REPLACE_DATA para limpar os dados de PDV e substituí-los por dados na tabela intermediária do FDMEE. Os dados referentes a Cenário, Versão, Ano, Período e Entidade são limpos

  • NONE para ignorar a exportação de dados do FDMEE para o Planning

Os valores aceitáveis para aplicativos do Financial Consolidation and Close e Tax Reporting são:

  • MERGE — Por padrão, todo o carregamento de dados é processado no modo Mesclar. Se já existirem dados no aplicativo, o sistema os substituirá pelos novos dados do arquivo de carregamento. Se não existirem dados, os novos dados serão criados.

  • REPLACE — Primeiro, o sistema limpa os dados existentes no aplicativo referenciados no arquivo de carregamento de dados. Em seguida, o sistema executa o carregamento de dados no modo Mesclar.

  • NONE — Ignora a exportação de dados do FDMEE para o Financial Consolidation and Close

  Sim Nenhum
fileName Um nome de arquivo opcional. Se você não especificar um nome de arquivo, essa API importará os dados contidos no nome de arquivo especificado para a regra de carregamento de dados. O arquivo de dados já deverá estar na CAIXA DE ENTRADA antes da execução da regra de dados.   Sim Nenhum

Exemplo de URL

https://<NOME_DO_SERVIÇO>-<NOME_DO_INQUILINO>.<dcX>.oraclecloud.com/aif/rest/V1/jobs

Exemplo de Corpo da Solicitação

{"jobType":"DATARULE",
"jobName":"aso to bso dr",
"startPeriod":"Dec-18",
"endPeriod":"Dec-18",
"importMode":"REPLACE",
"exportMode":"NONE",
"fileName":""
}

Resposta

Tipos de Mídia Suportados: application/json

Tabela A-2 Parâmetros

Nome Descrição

status

Status do job: -1 = em andamento; 0 = sucesso; 1 = erro; 2 = pendente de cancelamento; 3 = cancelado; 4 = parâmetro inválido

jobStatus

Uma representação de texto do status do job, com um dos seguintes valores "RUNNING", "SUCCESS". "FAILED"

jobId

O ID do processo gerado no FDMEE para o job

logFileName

Arquivo de Log contendo entradas para essa execução.

outputFileName

Nome do arquivo de saída gerado, se houver.

processType

Tipo do processo executado. Conterá "COMM_LOAD_BALANCES" para todas as execuções de Regra de Dados

executedBy

Nome de login do usuário usado para executar a regra.

details

Retorna o rastreamento de pilha de exceções no caso de um erro de aplicativo

Exemplo do Corpo de Resposta

Veja a seguir um exemplo do corpo da resposta no formato JSON.

{
    "jobStatus": "RUNNING"
"jobId": 2019
"logFileName": "\outbox\logs\Account Reconciliation Manager_2019.log"
"outputFileName": null
"processType": "COMM_LOAD_BALANCES"
"executedBy": "admin"
"status": -1
"links": [1]
    0:  {
    "rel": "self"
    "href": "https://<SERVICE_NAME>-<TENANT_NAME>.<dcX>.oraclecloud.com/aif/rest/V1/jobs/2019"
    "action": "GET"
}
"details": null

}