Uso de um Tipo de Job do EPM Platform para Jobs do Planning

Use o tipo de Job do EPM Platform para executar jobs do Planning, fornecendo o nome, o tipo e os parâmetros do job. Espera-se que alguns jobs sejam definidos no aplicativo Planning correspondente, com alguns ou todos os parâmetros necessários salvos na definição do job. Para esses tipos de jobs, os parâmetros podem ser fornecidos na definição do job ou substituídos no tempo de execução. Os jobs restantes podem ser acionados em tempo de execução sem uma definição de job salva.

Os tipos de jobs Job do EPM Platform suportados para jobs do Planning incluem:

  • Modo de Administração

  • Previsão Automática

  • Limpar Cubo

  • Cubo Compacto

  • Atualização de Cubo

  • Executar Definição de Intermitência

  • Exportar Auditoria

  • Exportar Diários de Consolidação

  • Exportar Dados

  • Exportar Console de Jobs

  • Exportar Metadados

  • Exportar Segurança

  • Importar Diários de Consolidação

  • Importar Dados

  • Importar Taxas de Câmbio

  • Importar Metadados

  • Importar Segurança

  • Mesclar Fatias de Dados

  • Otimizar Agregação

  • Mapeamento de Tipos de Plano

  • Reestruturar Cubo

  • Regras

  • Conjunto de Regras

Note:

Para entender como os jobs são definidos no Planning, consulte Gerenciamento de Jobs em Administração do Planning.

Parâmetros de tipo de job são adicionados como pares de Rótulo e Valor (pares de valores-chave), em que Rótulo é o nome de um atributo e Valor é um valor atribuído a este atributo.

O nome dos parâmetros do tipo de job e os parâmetros abaixo devem corresponder aos suportados pelas APIs REST correspondentes (consulte Executar um Job em API REST do Enterprise Performance Management Cloud).

Table 12-7 Uso de Parâmetros de um Tipo de Job do EPM Platform para o Planning

Uso de Parâmetros de um Tipo de Job do EPM Platform para o Planning Descrição
Tipo de Job

Na lista suspensa Tipo de Job, selecione o valor ou a variável do tipo de job a ser executado no Job do EPM Platform.

Você pode qualificar o tipo de job especificando os parâmetros individuais de rótulo e valor nos campos Rótulo/Valor.

Nome do Job

Especifique o nome do job a ser usado para esta execução de job.

Rótulo/Valor

Parâmetros de tipo de job são adicionados como pares de Rótulo e Valor (pares de valores-chave), em que Rótulo é o nome de um atributo e Valor é um valor atribuído a este atributo.

Para adicionar um novo par Rótulo/Valor, clique em A imagem mostra o ícone Adicionar Rótulo..

Para excluir um par Rótulo/Valor, clique em A imagem mostra o ícone Excluir Rótulo..

Modo de Administração

Altera o nível de logon de um aplicativo do Planning . Se você definir o nível de log-in como Administradores, todos os Usuários e Planejadores interativos serão desconectados do aplicativo após a conclusão do trabalho. Para obter detalhes sobre o modo de administração, consulte Programação de Jobs.

Para obter informações detalhadas sobre valores e parâmetros de tipo de job que podem ser passados, consulte Modo de Administração em API REST do Enterprise Performance Management Cloud.

Previsão Automática

Agende previsões usando o job Previsão Automática. Com a Previsão Automática, os administradores podem definir uma previsão para prever o desempenho futuro com base em dados históricos e programar um job para executar essa definição de previsão, o que automatiza o processo de previsão.

Para obter detalhes sobre a Previsão Automática, consulte Configuração de Previsões para Execução Automática in Administração do Planning.

Para obter informações detalhadas sobre valores e parâmetros de tipo de job que podem ser passados, consulte Previsão Automática em API REST do Enterprise Performance Management Cloud.

Limpar Cubo

Use o tipo de job Limpar Cubo para limpar dados específicos nos cubos de relatório e entrada.

Você pode limpar os dados ou uma consulta MDX válida usando a seleção de membros. Também pode limpar detalhes de suporte, comentários e anexos relacionados. Você também pode optar por fazer uma limpeza física ou lógica dos dados.

Para obter informações detalhadas sobre valores e parâmetros de tipo de job que podem ser passados, consulte Uso de um Tipo de Job Limpar Cubo.

Cubo Compacto

Compacta o arquivo de outline de um cubo ASO. A compactação ajuda a manter o arquivo de outline em um tamanho ideal. A compactação do outline não limpa os dados.

Para obter informações detalhadas sobre valores e parâmetros de tipo de job que podem ser passados, consulte Cubo Compacto em API REST do Enterprise Performance Management Cloud.

Atualização de Cubo

Atualiza o cubo do aplicativo do Planning. Normalmente, você atualiza o cubo após importar metadados para o aplicativo.

Para obter informações detalhadas sobre valores e parâmetros de tipo de job que podem ser passados, consulte Atualização de Cubo em API REST do Enterprise Performance Management Cloud.

Executar Definição de Intermitência

Execute a intermitência para um único relatório ou livro para mais de um membro de uma única dimensão e publique uma saída em PDF ou Excel para cada membro.

Note:

A definição de intermitência deve estar presente na pasta especificada com o parâmetro burstingDefinitionName.

Para obter informações detalhadas sobre valores e parâmetros de tipo de job que podem ser passados, consulte Atualização de Cubo em API REST do Enterprise Performance Management Cloud.

Exportar Auditoria

Exporta os registros de auditoria para um arquivo CSV (Valores Separados por Vírgulas). O arquivo CSV de saída contém o primeiro caractere como um caractere BOM (Byte Order Mark) \ufeff. A API grava um identificador de aplicativo criptografado após o caractere BOM. Esse identificador de aplicativo é escrito entre aspas duplas. Os cabeçalhos do arquivo CSV seguem o identificador do aplicativo. Para obter mais informações, consulte Auditoria de Tarefas e Dados.

Você pode usar um parâmetro opcional excludeApplicationId para não gravar o identificador do aplicativo no arquivo de exportação. Os relatórios de auditoria exportados sem o identificador do aplicativo não podem ser importados de volta para o aplicativo.

O arquivo CSV gerado é compactado, e a saída é um arquivo ZIP.

Para obter informações detalhadas sobre valores e parâmetros de tipo de job que podem ser passados, consulte Exportar Auditoria em API REST do Enterprise Performance Management Cloud.

Exportar Diários de Consolidação

Execute um job Exportar Diários de Consolidação usando o nome do job. Antes de executar esse job, você deverá criar um job Exportar Diários de Consolidação no Financial Consolidation and Close.

Para obter informações detalhadas sobre valores e parâmetros de tipo de job que podem ser passados, consulte Exportar Diários de Consolidação em API REST do Enterprise Performance Management Cloud.

Exportar Dados

Exporta dados de aplicativos para um arquivo usando as configurações de exportação de dados, incluindo o nome do arquivo, especificadas em um job do Planning do tipo export data. O arquivo que contém os dados exportados é armazenado no repositório do Planning.

Você também pode substituir alguns parâmetros da definição do job ao executar esse job com uma API REST.

A exportação de dados oferece suporte a variáveis ​​de substituição. Você pode usar variáveis ​​de substituição ao substituir as definições rowMembers, columnMembers e povMembers. Consulte Criação e Atribuição de Valores a Variáveis de Substituição em Administração do Planning.

Para obter informações detalhadas sobre valores e parâmetros de tipo de job que podem ser passados, consulte Exportar Dados em API REST do Enterprise Performance Management Cloud.

Exportar Console de Jobs

Exporta os registros do console de jobs para um arquivo CSV (Valores Separados por Vírgulas). O arquivo CSV de saída contém o primeiro caractere como um caractere BOM (Byte Order Mark) \ufeff. A API grava um identificador de aplicativo criptografado após o caractere BOM. Esse identificador de aplicativo é escrito entre aspas duplas. Os cabeçalhos do arquivo CSV seguem o identificador do aplicativo.

Você pode usar um parâmetro opcional excludeApplicationId para não gravar o identificador do aplicativo no arquivo de exportação. Arquivos de dados do console de jobs sem o identificador do aplicativo não podem ser importados de volta para o aplicativo.

O arquivo CSV gerado é compactado, e a saída é um arquivo ZIP.

Para obter informações detalhadas sobre valores e parâmetros de tipo de job que podem ser passados, consulte Exportar Console de Jobs em API REST do Enterprise Performance Management Cloud.

Exportar Metadados

Exporta metadados para um arquivo usando as configurações especificadas em um job do Planning do tipo export metadata. O arquivo que contém os metadados exportados é armazenado no repositório do Planning.

Para obter informações detalhadas sobre valores e parâmetros de tipo de job que podem ser passados, consulte Exportar Metadados em API REST do Enterprise Performance Management Cloud.

Exportar Segurança

Exporta os registros de segurança ou os registros de lista de controle de acesso (ACL) para usuários ou grupos especificados para um arquivo de Valores Separados por Vírgulas (CSV). Para obter informações sobre permissões de acesso a artefatos do aplicativo, consulte Configuração de Permissões de Acesso.

Para obter informações detalhadas sobre valores e parâmetros de tipo de job que podem ser passados, consulte Exportar Segurança em API REST do Enterprise Performance Management Cloud.

Importar Diários de Consolidação

Execute um job Importar Diários de Consolidação usando o nome do job. Antes de executar esse job, você deverá criar um job Importar Diários de Consolidação no Financial Consolidation and Close.

Para obter detalhes sobre essa tarefa, consulte Importação de Diários de Consolidação em Como Trabalhar com o Financial Consolidation and Close.

Para obter informações detalhadas sobre valores e parâmetros de tipo de job que podem ser passados, consulte Importar Diários de Consolidação em API REST do Enterprise Performance Management Cloud.

Importar Dados

Importa dados de um arquivo no repositório do Planning para o aplicativo usando as configurações de importação de dados especificadas em um job do Planning do tipo Import Data.

Para o Planning, o Financial Consolidation and Close e o Tax Reporting, você pode revisar os registros de dados rejeitados que contêm erros. Para fazer isso, especifique um arquivo de erro que capture os registros de dados os quais não são importados para cada dimensão. Se for especificado um arquivo de erro, o arquivo ZIP será armazenado na Caixa de Saída. Você poderá fazer download do arquivo nessa caixa usando o Explorador da Caixa de Entrada/Caixa de Saída ou ferramentas como o EPM Automate ou APIs REST; por exemplo, com a API de Fazer Download.

Para obter informações detalhadas sobre valores e parâmetros de tipo de job que podem ser passados, consulte Importar Dados em API REST do Enterprise Performance Management Cloud.

Importar Taxas de Câmbio

Importe o modelo Taxas de Câmbio no repositório do Planning e, se necessário, altere as taxas. Você poderá, então, importar as taxas para o aplicativo usando as configurações de Importar Taxas de Câmbio especificadas em um job do Planning do tipo importar taxas de câmbio. Para obter mais informações, consulte o Guia do Administrador do Oracle Enterprise Performance Management WorkspaceTipos de Job.

Para obter informações detalhadas sobre valores e parâmetros de tipo de job que podem ser passados, consulte Importar Taxas de Câmbio em API REST do Enterprise Performance Management Cloud.

Importar Metadados

Importa metadados de um arquivo no repositório do Planning para o aplicativo usando as configurações de importação de metadados especificadas em um job do Planning do tipo import metadata.

Para o Planning, o Financial Consolidation and Close e o Tax Reporting, você pode revisar os registros de dados rejeitados que contêm erros.

Para obter informações detalhadas sobre valores e parâmetros de tipo de job que podem ser passados, consulte Importar Metadados em API REST do Enterprise Performance Management Cloud.

Importar Segurança

Importa os registros de segurança ou os registros de lista de controle de acesso (ACL) de um arquivo de Valores Separados por Vírgulas (CSV). Para obter informações sobre permissões de acesso a artefatos do aplicativo, consulte Configuração de Permissões de Acesso.

Formato de Arquivo do Excel:

  • Object Name: O nome do objeto para o qual a ACL está definida
  • Name: O nome do usuário ou grupo para o qual a ACL está definida
  • Parent: O nome do pai do objeto
  • Is User: O indicador (Y ou N) que determina se a ACL está definida para um usuário ou grupo
  • Object Type: o tipo de objeto; por exemplo, Forms folder
  • Access Type: O tipo de privilégio, como READ ou READWRITE
  • Access Mode: Informações adicionais, como se a ACL é aplicável aos descendentes
  • Remove: Para remover uma ACL específica, defina como Y

Todos os valores possíveis:

Object Type:

  • SL_FORM - Formulário
  • SL_COMPOSITE - Formulário Composto
  • SL_TASKLIST - Lista de tarefas
  • SL_CALCRULE - Regra
  • SL_FORMFOLDER (pasta de formulários)
  • SL_CALCFOLDER (pasta de regras)
  • SL_DIMENSION - Dimensão
  • SL_CALCTEMPLATE - Modelo
  • SL_REPORT (relatório de gerenciamento)
  • SL_REPORTSSHOT (instantâneo do relatório de gerenciamento)

Access Type:

  • NONE - Nenhum
  • READ - Leitura
  • WRITE - Gravação
  • READWRITE - Leitura/Gravação
  • LAUNCH - Iniciar

Access Mode:

  • MEMBER
  • CHILDREN
  • @ICHILDREN
  • @DESCENDANTS
  • @IDESCENDANTS

Exemplo de Arquivo CSV:

Object Name,Name,Parent,Is User,Object Type,Access Type,Access
          Mode,Remove
Object Name,Name,Parent,Is User,Object Type,Access Type,Access
          Mode,Remove
"Exchange Rates to
          USD","ats_user3","Y","SL_FORM","READWRITE","MEMBER","N" 
"Exchange Rates to
          USD","ats_user4","Y","SL_FORM","READWRITE","MEMBER","N" 
"Exchange Rates to
          USD","ats_user15","Y","SL_FORM","READ","MEMBER","N" 
"Exchange Rates to
          USD","ats_user10","Y","SL_FORM","NONE","MEMBER","N" 
"Calculate
          Benefits","group_1","N","SL_COMPOSITE","READWRITE","MEMBER","N"

Para obter informações detalhadas sobre valores e parâmetros de tipo de job que podem ser passados, consulte Importar Segurança em API REST do Enterprise Performance Management Cloud.

Mesclar Fatias de Dados

Mescla fatias de dados incrementais de um cubo ASO. O uso de menos fatias melhora o desempenho de um cubo. É possível mesclar todas as fatias de dados incrementais na fatia de dados do banco de dados principal ou mesclar todas as fatias de dados incrementais em uma única fatia de dados sem alterar a fatia do banco de dados principal. Como opção, você pode remover células com valor igual a zero.

Para obter informações detalhadas sobre valores e parâmetros de tipo de job que podem ser passados, consulte Mesclar Fatias de Dados em API REST do Enterprise Performance Management Cloud.

Otimizar Agregação

Melhora o desempenho dos cubos ASO. Este job tem duas ações: Habilitar rastreamento de consulta e Executar processo de agregação. Ele executa uma agregação, especificando opcionalmente o espaço máximo em disco para os arquivos resultantes e opcionalmente baseando a seleção da exibição nos padrões de consulta do usuário. Esse tipo de job só é aplicável a bancos de dados de armazenamento agregados.

Antes de usar esse tipo de tarefa, primeiro você deve ativar o rastreamento de consulta para capturar estatísticas de rastreamento no cubo de armazenamento agregado. Então, depois de habilitar o rastreamento de consulta, você deverá permitir tempo suficiente para coletar padrões de recuperação de dados do usuário antes de executar o processo de agregação com base nos dados de consulta. O processo de agregação de execução exclui exibições agregadas existentes e gera exibições otimizadas com base nos dados de rastreamento de consulta coletados.

Para obter informações detalhadas sobre valores e parâmetros de tipo de job que podem ser passados, consulte Otimizar Agregação em API REST do Enterprise Performance Management Cloud.

Mapeamento de Tipos de Plano

Copia dados de um cubo de armazenamento em blocos para um cubo de armazenamento agregado ou de um para outro com base nas configurações especificadas em um job do Planning do tipo plan type map.

Para obter informações detalhadas sobre valores e parâmetros de tipo de job que podem ser passados, consulte Mapeamento de Tipos de Plano em API REST do Enterprise Performance Management Cloud.

Reestruturar Cubo

Executa uma reestruturação total de um cubo BSO para eliminar ou reduzir a fragmentação.

Para obter informações detalhadas sobre valores e parâmetros de tipo de job que podem ser passados, consulte Reestruturar Cubo em API REST do Enterprise Performance Management Cloud.

Regras

Inicia uma regra de negócios.

Para obter informações detalhadas sobre valores e parâmetros de tipo de job que podem ser passados, consulte Regras em API REST do Enterprise Performance Management Cloud.

Conjunto de Regras

Inicia um conjunto de regras de negócios.

Oferece suporte a conjuntos de regras sem solicitações de tempo de execução ou com solicitações de tempo de execução com valores padrão. Para maior flexibilidade, você pode adicionar parâmetros aos conjuntos de regras. Para obter detalhes sobre conjuntos de regras, consulte Criação de Conjuntos de Regras de Negócios.

Para obter informações detalhadas sobre valores e parâmetros de tipo de job que podem ser passados, consulte Conjunto de Regras em API REST do Enterprise Performance Management Cloud.

Veja a seguir exemplos de parâmetros de Exportar Dados para um tipo de Job do EPM Platform:

A imagem mostra parâmetros do job Exportar Dados de um job do EPM Platform.

Veja a seguir exemplos de parâmetros de Atualização de Cubo para um tipo de Job do EPM Platform:

A imagem mostra parâmetros de Atualização de Cubo para um tipo de Job do EPM Platform.

Veja a seguir exemplos de parâmetros de Importar Taxa de Câmbio para um tipo de Job do EPM Platform:

A imagem mostra parâmetros do job Importar Taxa de Câmbio.

Veja a seguir exemplos de parâmetros de Mapeamento de Tipos de Plano para um tipo de Job do EPM Platform:

A imagem mostra parâmetros do job Mapeamento de Tipos de Plano para um tipo de job do EPM Platform: