exportQueryResults

Si applica a

Ruoli necessari

Utilizzo

• APPLICATION_NAME indica il nome dell'applicazione Profitability and Cost Management per cui si desidera eseguire la query.
• fileName indica il nome del file in cui verranno memorizzati i risultati della query. Il valore di questo parametro è obbligatorio se non viene specificato il valore del parametro queryName. È facoltativo se viene specificato il valore del parametro queryName. In questo caso, verrà utilizzato il nome della query come nome del file dei risultati della query.

  Il formato dei dati specificato determina il formato del file di output. Se si utilizza dataFormat=NATIVE (valore predefinito), il processo di esportazione crea un file di testo. Se si utilizza dataFormat=COLUMNAR, il processo di esportazione crea più file di testo numerati in sequenza e li comprime in un file ZIP.

• fileOutputOptions (facoltativo) identifica il formato di output del file dei risultati della query. Il valore predefinito è ZIP_ONLY, che crea fileName.ZIP o queryName.ZIP a seconda che sia specificato un valore per il parametro fileName. Altre opzioni sono TEXT_ONLY per creare il file di output come file di testo e ZIP_AND_TEXT per generare sia un file di testo che un file ZIP.
• queryName è un parametro facoltativo che identifica una query definita nell'applicazione. I nomi di query contenenti spazi devono essere racchiusi tra virgolette.

  Non specificare un nome di query se si desidera esportare tutti i dati Oracle Essbase appartenenti all'applicazione.

  Le condizioni seguenti possono far sì che questo comando crei un file di dati vuoto:

  • una query con formato errato che non recupera alcun dato;
  • una query che genera una quantità eccessiva di dati. In questo scenario valutare l'opportunità di restringere l'ambito della query in modo che recuperi una quantità minore di dati oppure di suddividere la query in query più piccole.

    Fare riferimento alla sezione Gestione delle query di Managing Oracle Profitability and Cost Management Cloud nella Guida Amministrazione di Profitability and Cost Management.

• exportOnlyLevel0Flg (facoltativo) specifica se la query deve recuperare solo dati level0. Specificare questo valore di parametro in minuscolo.

  Questo parametro viene ignorato se si esportano tutti i dati dell'applicazione mediante l'omissione del nome della query.

• roundingPrecision, facoltativamente, specifica il numero di posizioni decimali (precisione di arrotondamento) da utilizzare quando i risultati delle query vengono esportati. Applicabile solo quando si specifica queryName. Il valore predefinito è 2.
• dataFormat (facoltativo) identifica il formato di output. I valori validi sono:
  • NATIVE, che mantiene il risultato della query come dati nel formato nativo Essbase. Questo è il valore predefinito.
  • COLUMNAR, che converte i dati con formato nativo Essbase e li ordina in colonne per semplificarne l'interpretazione e l'importazione in altre applicazioni.

    Questa opzione esporta tutti i dati Essbase e ignora il valore del parametro queryName. È possibile filtrare i dati impostando il valore del parametro memberFilters.

  Nota:

  Il comando tiene conto dei parametri facoltativi riportati di seguito solo se dataFormat è specificato come COLUMNAR.
• memberFilters (facoltativo) accetta una stringa con formattazione JSON per applicare un filtro in base ai membri dimensione e level0. Esempio, "{\"Dim1\":[\"Mem1\"],\"Dim2\":[\"Mem21\",\"Mem22\"]}"
• includeHeader (facoltativo) aggiunge nomi di dimensione come intestazioni di colonna. Impostare questo valore su false per escludere l'intestazione di colonna. Il valore predefinito è true.
• delimiter (facoltativo) identifica il delimitatore da utilizzare per separare i membri dimensione nel file dei risultati della query. Il delimitatore deve essere racchiuso tra virgolette. Il valore predefinito è lo spazio (" ").
• keepDuplicateMemberFormat (facoltativo) specifica se stampare il formato del membro nel formato del membro duplicato Essbase, ad esempio [Account]@[Accoun1]. Impostare questo valore su false per stampare solo il nome del membro. Il valore predefinito è true.

Esempi

• Esportare tutti i dati dell'applicazione:

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

• Esportare i risultati di una query specifica:

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

• Esportare i dati Level0 nel formato dati NATIVE:

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

• Esportare i dati Level0 nel formato dati COLUMNAR con filtro per dimensione singola e membro singolo:

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

• Esportare i dati Level0 nel formato dati COLUMNAR con filtri per dimensione singola e più membri:

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

• Esportare i dati Level0 nel formato dati COLUMNAR con filtri per più dimensioni e più membri:

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