執行應用程式中定義的查詢,並將結果匯出到文字檔案。
查詢結果檔案會儲存在 profitoutbox 中;您可以使用downloadFile
命令或 Profitability and Cost Management 檔案瀏覽器下載該檔案。
適用於
Profitability and Cost Management必要角色
服務管理員、超級使用者、使用者及檢視者用法
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]
,其中:
APPLICATION_NAME
是 Profitability and Cost Management 您要執行查詢之應用程式的名稱。fileName
是指儲存查詢結果的檔案,其名稱為何。如果未指定 queryName
參數值,則此參數值是必要的。是否指定 queryName
參數值可自行決定,但不管如何,查詢名稱都會當作查詢結果檔案的名稱。
您指定的資料格式會決定輸出檔案的格式。如果您使用 dataFormat=NATIVE
(預設),則匯出程序會建立一個文字檔。如果您使用 dataFormat=COLUMNAR
,則匯出程序會建立多個按順序編號的文字檔並將它們壓縮成一個 Zip 檔案。
fileOutputOptions
(選擇性) 會識別查詢結果檔案的輸出格式。預設值為 ZIP_ONLY
,它會根據是否指定了 fileName
參數的值,然後建立 fileName
.ZIP 或 queryName
.ZIP。其他選項有 TEXT_ONLY
,它會建立文字檔形式的輸出檔案;或者是 ZIP_AND_TEXT
,它會產生文字檔和 zip 檔案。queryName
是識別應用程式中定義的查詢的選擇性參數。包含空格字元的查詢名稱必須以雙引號括住。
若您想匯出屬於應用程式的所有 Oracle Essbase 資料,請勿指定查詢名稱。
下列條件可能導致此命令建立空白的資料檔案:
請參閱管理 Profitability and Cost Management 中的管理 Oracle Profitability and Cost Management Cloud 查詢。
exportOnlyLevel0Flg
(選擇性) 指定本次查詢是否應僅擷取層級 0 資料。以全部小寫的形式指定此參數值。
若您省略查詢名稱以匯出所有應用程式資料,則會忽略此參數。
roundingPrecision
(選擇性) 可指定匯出查詢結果時要使用的小數位數 (捨入精確度)。只有在已指定 queryName
的情況下才適用。預設值為 2。dataFormat
(選擇性) 會識別輸出格式。有效值為:
NATIVE
,它會將查詢結果以 Essbase 原生格式資料的形式加以維護。此為預設值。COLUMNAR
,用於轉換 Essbase 原生格式資料並將其按欄排序,以便於解譯和匯入其他應用程式。
此選項會匯出所有 Essbase 資料並忽略 queryName
參數值。您可以設定 memberFilters
參數值來篩選資料。
註:
只有當dataFormat
指定為 COLUMNAR
時,該命令才會考慮以下選擇性參數。memberFilters
(選擇性) 接受 JSON 格式的字串,方便按照維度和層級 0 成員進行篩選。範例:"{\"Dim1\":[\"Mem1\"],\"Dim2\":[\"Mem21\",\"Mem22\"]}"
includeHeader
(選擇性) 將維度名稱新增為欄標題。將此值設定為 false
以排除欄標題。預設值為 true
。delimiter
(選擇性) 會識別應使用什麼分隔符號來分隔查詢結果檔案中的維度成員。分隔符號必須以雙引號括住。預設值為空格 (" ")。keepDuplicateMemberFormat
(選擇性) 會指定是否以 Essbase 複製成員格式列印成員格式,例如 [Account]@[Accoun1]
。將此值設定為 false
,只列印成員名稱。預設值為 true
。範例
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"