Executa uma consulta definida em um aplicativo e exporta os resultados para um arquivo de texto.
O arquivo de resultados da consulta é armazenado em profitoutbox; é possível fazer download dele usando o comando downloadFile
ou usando o Explorador de Arquivos do Profitability and Cost Management.
Aplica-se a
Gerenciamento de Custo e LucratividadeFunções Necessárias
Administrador de Serviço, Usuário Avançado, Usuário, VisualizadorUso
epmautomate exportQueryResults APPLICATION_NAME fileName=FILE_NAME [fileOutputOptions=ZIP_ONLY|ZIP_AND_TEXT|TEXT_ONLY] [queryName=QUERY_NAME] [exportOnlyLevel0Flg=true|false] [roundingPrecision=2] [dataFormat=NATIVE|COLUMNAR] [memberFilters=JSON_FILTER] [includeHeader=true|false] [delimiter="DELIMITER"] [keepDuplicateMemberFormat=true|false]
, onde:
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:
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 sedataFormat
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
epmautomate exportQueryResults BksML12 fileName="BksML12_MyQuery1.txt" fileOutputOptions=TEXT_ONLY
epmautomate exportQueryResults BksML12 queryName="My Product Query" roundingPrecision=3
epmautomate exportQueryResults BksML30 fileName="BksML30_ExportLevel0-Data" fileOutputOptions=ZIP_AND_TEXT exportOnlyLevel0Flg=true
epmautomate exportQueryResults BksML30 fileName="BksML30_Level0-Data" dataFormat="COLUMNAR" memberFilters="{\"Period\":[\"December\"]}" includeHeader="true" delimiter="," roundingPrecision="3"
epmautomate exportQueryResults BksML30 fileName="BksML30_Level0-Data" dataFormat="COLUMNAR" memberFilters="{\"Period\":[\"November\",\"December\"]}" includeHeader="true" delimiter="," roundingPrecision="3"
epmautomate exportQueryResults BksML30 fileName="BksML30_Level0-Data" dataFormat="COLUMNAR" memberFilters="{\"Year\":[\"2016\"],\"Period\":[\"November\",\"December\"]}" includeHeader="true" delimiter="," roundingPrecision="3"