Ejecuta una consulta definida en una aplicación y exporta los resultados a un archivo de texto.
El archivo de resultados de la consulta se almacena en profitoutbox; puede descargarlo mediante el comando downloadFile
o mediante el explorador de archivos de Profitability and Cost Management.
Se aplica a
Rentabilidad y gestión de costesRoles necesarios
Administrador del servicio, Usuario avanzado, Usuario, VisorSintaxis
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]
, donde:
APPLICATION_NAME
es el nombre de la aplicación de Profitability and Cost Management para la que desea ejecutar la consulta.fileName
es el nombre del archivo que almacenará los resultados de la consulta. Se necesita este valor de parámetro si no se está especificado el valor del parámetro queryName
. Es opcional si se especifica el valor de parámetro queryName
, en cuyo caso, se usa el nombre de consulta como nombre del archivo de resultados de la consulta.
El formato de datos que especifique determina el formato del archivo de salida. Si usa dataFormat=NATIVE
(valor predeterminado), el proceso de exportación crea un archivo de texto. Si usa dataFormat=COLUMNAR
, el proceso de exportación crea varios archivos de texto con numeración secuencial y los comprime en un archivo Zip.
fileOutputOptions
, opcionalmente, identifica el formato de salida del archivo de resultado de la consulta. El valor predeterminado es ZIP_ONLY
, que crea fileName
.ZIP o queryName
.ZIP, en función de si se ha especificado un valor para el parámetro fileName
. Otras opciones son TEXT_ONLY
para crear el archivo de salida como un archivo de texto y ZIP_AND_TEXT
para generar un archivo de texto y un archivo zip.queryName
es un parámetro opcional que identifica una consulta que se define en la aplicación. Los nombres de las consultas que contienen los caracteres de espacio deben ir entre comillas dobles.
No especifique un nombre de consulta si desea exportar todos los datos de Oracle Essbase que pertenecen a la aplicación.
Las siguientes condiciones pueden provocar que este comando cree un archivo de datos vacío:
Consulte Gestión de consultas de Oracle Profitability and Cost Management Cloud en Administración de Profitability and Cost Management.
exportOnlyLevel0Flg
, opcionalmente, se especifica si la consulta solo debe recuperar datos de Level0. Especifique este valor de parámetro en minúscula.
Este parámetro se ignora si va a exportar todos los datos de la aplicación omitiendo el nombre de la consulta.
roundingPrecision
, de forma opcional, especifica el número de posiciones decimales (con precisión de redondeo) que se va a utilizar al exportar los resultados de la consulta. Solo es aplicable si se ha especificado queryName
. El valor predeterminado es 2.dataFormat
, opcionalmente, se identifica el formato de salida. Los valores válidos son:
NATIVE
, que mantiene el resultado de la consulta como datos con formato nativo de Essbase. Este es el valor predeterminado.COLUMNAR
, que convierte los datos con formato nativo de Essbase y los ordena en columnas para que sea más fácil su interpretación e importación en otras aplicaciones.
Con esta opción se exportan todos los datos de Essbase y se ignora el valor del parámetro queryName
. Puede filtrar los datos estableciendo el valor del parámetro memberFilters
.
Nota:
El comando tiene en cuenta los siguientes parámetros opcionales solo si se especificadataFormat
como COLUMNAR
.memberFilters
, opcionalmente, acepta una cadena con formato JSON para filtrar por dimensión y miembros de Level0. Ejemplo, "{\"Dim1\":[\"Mem1\"],\"Dim2\":[\"Mem21\",\"Mem22\"]}"
includeHeader
, opcionalmente, agregar nombres de dimensión como cabeceras de columna. Establezca este valor en false
para excluir la cabecera de la columna. El valor predeterminado es true
.delimiter
, opcionalmente, se identifica el delimitador que se va a usar para separar los miembros de dimensión en el archivo de resultado de la consulta. El delimitador debe ir entre comillas dobles. El valor predeterminado es un espacio (" ").keepDuplicateMemberFormat
, opcionalmente, se especifica si se va a imprimir el formato de miembro en formato de miembro duplicado de Essbase, por ejemplo, [Account]@[Accoun1]
. Establezca este valor en false
para imprimir solo el nombre del miembro. El valor predeterminado es true
.Ejemplos
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"