exportQueryResults

Aplica-se a

Funções Necessárias

Uso

• APPLICATION_NAME é o nome do aplicativo do Profitability and Cost Management para o qual você deseja executar a consulta.
• fileName é o nome do arquivo que armazenará os resultados da consulta. O valor desse parâmetro será obrigatório se o valor do parâmetro queryName não for especificado. Será opcional se o valor do parâmetro queryName for especificado. Nesse caso, o nome da consulta será usado como o nome do arquivo dos resultados da consulta.

  O formato de data que você especifica determina o formato do arquivo de saída. Se você usar dataFormat=NATIVE (padrão), o processo de exportação criará um arquivo de texto. Se você usar dataFormat=COLUMNAR, o processo de exportação criará vários arquivos de texto com numeração sequencial e os compactará em um arquivo Zip.

• fileOutputOptions, opcionalmente, identifica o formato de saída do arquivo de resultados de consulta. O padrão é ZIP_ONLY, que cria um arquivo fileName.ZIP ou queryName.ZIP, dependendo de ser especificado um valor para o parâmetro fileName ou não. Outras opções são TEXT_ONLY para criar o arquivo de saída como um arquivo de texto e ZIP_AND_TEXT para gerar um arquivo de texto e um arquivo zip.
• queryName é um parâmetro opcional que identifica uma consulta definida no aplicativo. Os nomes de consulta que contêm o caractere de espaço devem estar entre aspas duplas.

  Não especifique um nome de consulta se você quiser exportar todos os dados do Oracle Essbase pertencentes ao aplicativo.

  As seguintes condições podem fazer com que esse comando crie um arquivo de dados vazio:

  • Uma consulta com formato incorreto que não recupera dados
  • Uma consulta que gera um volume excessivo de dados. Nesse cenário, considere limitar o escopo da consulta para que ela recupere um volume menor de dados ou dividi-la em consultas menores

    Consulte Gerenciamento de Consultas do Oracle Profitability and Cost Management Cloud em Administração do Profitability and Cost Management.

• exportOnlyLevel0Flg, opcionalmente, especifica se a consulta deve recuperar somente dados de nível 0. Especifique esse valor de parâmetro totalmente em minúsculas.

  Esse parâmetro será ignorado se você estiver exportando todos os dados do aplicativo omitindo o nome da consulta.

• roundingPrecision, opcionalmente, especifica o número de casas decimais (precisão de arredondamento) a serem usadas ao exportar os resultados da consulta. Aplicável somente quando queryName for especificado. O padrão é 2.
• dataFormat, opcionalmente, especifica o formato de saída. Os valores válidos são:
  • NATIVE, que mantém o resultado da consulta como dados no formato nativo do Essbase. Esse é o valor padrão.
  • COLUMNAR, que converte os dados do formato nativo do Essbase e ordena-os em colunas para facilitar a interpretação e importá-los para outros aplicativos.

    Essa opção exporta todos os dados do Essbase e ignora o valor do parâmetro queryName. Você pode filtrar os dados definindo o valor do parâmetro memberFilters.

  Nota:

  O comando só considerará os parâmetros opcionais a seguir se dataFormat for especificado como COLUMNAR.
• memberFilters, opcionalmente, aceita uma string formatada pelo JSON para filtrar por membros de nível 0 (Level0) e dimensão. Exemplo: "{\"Dim1\":[\"Mem1\"],\"Dim2\":[\"Mem21\",\"Mem22\"]}"
• includeHeader, opcionalmente, adiciona nomes de dimensão como cabeçalhos de coluna. Defina esse valor como false para excluir o cabeçalho da coluna. O padrão é true.
• delimiter, opcionalmente, identifica o delimitador a ser usado para separar membros de dimensão no arquivo de resultados da consulta. O delimitador deve estar entre aspas duplas. O padrão é espaço (" ").
• keepDuplicateMemberFormat, opcionalmente, especifica se é para imprimir o formato do membro no formato de membro duplicado do Essbase; por exemplo, [Account]@[Accoun1]. Defina esse valor como false para imprimir somente o nome do membro. O padrão é true.

Exemplos

• Exportar todos os dados do aplicativo:

  epmautomate exportQueryResults BksML12 fileName="BksML12_MyQuery1.txt" fileOutputOptions=TEXT_ONLY

• Exportar os resultados de uma consulta específica:

  epmautomate exportQueryResults BksML12 queryName="My Product Query" roundingPrecision=3

• Exportar dados de nível 0 (Level0) no formato de dados NATIVE:

  epmautomate exportQueryResults BksML30 fileName="BksML30_ExportLevel0-Data" fileOutputOptions=ZIP_AND_TEXT exportOnlyLevel0Flg=true

• Exportar dados de Level0 no formato de dados COLUMNAR com um filtro de um membro e uma dimensão:

  epmautomate exportQueryResults BksML30 fileName="BksML30_Level0-Data" dataFormat="COLUMNAR" memberFilters="{\"Period\":[\"December\"]}" includeHeader="true" delimiter="," roundingPrecision="3"

• Exportar dados de Level0 no formato de dados COLUMNAR com filtros de vários membros e de uma dimensão:

  epmautomate exportQueryResults BksML30 fileName="BksML30_Level0-Data" dataFormat="COLUMNAR" memberFilters="{\"Period\":[\"November\",\"December\"]}" includeHeader="true" delimiter="," roundingPrecision="3"

• Exportar dados de Level0 no formato de dados COLUMNAR com filtros de várias dimensões e vários membros:

  epmautomate exportQueryResults BksML30 fileName="BksML30_Level0-Data" dataFormat="COLUMNAR" memberFilters="{\"Year\":[\"2016\"],\"Period\":[\"November\",\"December\"]}" includeHeader="true" delimiter="," roundingPrecision="3"