exportQueryResults

Se aplica a

Roles necesarios

Sintaxis

• 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:

  • Una consulta con un formato incorrecto que no recupera ningún dato.
  • Una consulta que genera demasiados datos. En este caso, puede reducir el ámbito de la consulta de forma que recupere menos datos o divida la consulta en varias consultas más pequeñas.

    Consulte Gestión de consultas de Oracle Profitability and Cost Management Cloud en Administración de Profitability and Cost Management.

• Con 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.
• Con 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 especifica dataFormat 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.
• Con 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 (" ").
• Con 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

• Exportar todos los datos de la aplicación:

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

• Exportar resultados de una consulta específica:

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

• Exporte datos de Level0 en formato de datos NATIVO:

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

• Exporte los datos de Level0 con el formato de datos COLUMNAR con un filtro de una dimensión y un miembro:

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

• Exporte los datos de Level0 con el formato de datos COLUMNAR con filtros de una dimensión y varios miembros:

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

• Exporte los datos de Level0 con el formato de datos COLUMNAR con filtros de varias dimensiones y varios miembros:

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