將資料檔上傳至環境並執行資料載入規則

使用這些指令碼將檔案上傳至環境，然後執行資料規則，以將資料從檔案匯入至應用程式。

必備條件

  • 資料管理中的下列定義：
    • 名稱為 VisionActual 的資料載入規則定義。假設資料規則未指定輸入檔案的檔案路徑。
    • 期間定義 Mar-15 到 Jun-15
  • 包含資料且格式正確的資料檔案 (GLActual.dat)。

若要匯入資料並執行資料載入規則，請執行完成以下步驟的命令：

  • 登入環境。
  • 將包含期間 Mar-15 到 Jun-15 之資料的檔案 GLActual.dat 上傳到資料管理 資料夾 inbox/Vision 中。
  • 使用資料載入規則 VisionActual、開始期間 Mar-15、結束期間 Jun-15 及匯入模式 REPLACE，將資料從 GLActual.dat 匯入資料管理。
  • 使用 STORE_DATA 選項匯出資料，以將資料管理臨時資料表中的資料與現有應用程式資料合併。
  • 登出。

Windows 範例指令碼

透過複製下列指令碼以建立 runDataLoadRule.ps1。將它儲存至本機目錄。 
$inputproperties = ConvertFrom-StringData(Get-Content ./input.properties -raw)
$username="$($inputproperties.username)"
$passwordfile="$($inputproperties.passwordfile)"
$serviceURL="$($inputproperties.serviceURL)"
$dataFile="$($inputproperties.dataFile)"
$dataRuleName="$($inputproperties.dataRuleName)"
$startPeriod="$($inputproperties.startPeriod)"
$endPeriod="$($inputproperties.endPeriod)"
$importMode="$($inputproperties.importMode)"
$exportMode="$($inputproperties.exportMode)"

epmautomate login ${username} ${passwordfile} ${serviceURL}
epmautomate uploadfile ${datafile} ${dataFileUploadLocation}
epmautomate rundatarule ${dataRuleName} ${startPeriod} ${endPeriod} ${importMode} ${exportMode} ${dataFileUploadLocation}/${dataFile}
epmautomate logout

Linux/UNIX 範例指令碼

透過複製下列指令碼以建立 runDataLoadRule.sh。將它儲存至本機目錄。 
#!/bin/bash
. ./input.properties
export JAVA_HOME=${javahome}
${epmautomatescript} login "${username}" "${passwordfile}" "${serviceURL}"
${epmautomatescript} uploadfile "${datafile}" "${dataFileUploadLocation}"
${epmautomatescript} rundatarule "${dataRuleName}" "${startPeriod}" "${endPeriod}" "${importMode}" "${exportMode}" "${dataFileUploadLocation}/${dataFile}"
${epmautomatescript} logout

建立 input.properties 檔案

透過複製下列其中之一並根據您的環境資訊予以更新，以建立 input.properties 檔案。將檔案儲存至儲存 runDataLoadRule.ps1 或 runDataLoadRule.sh 的目錄。

Windows 
username=serviceAdmin
passwordfile=./password.epw
serviceURL=https://example.oraclecloud.com
dataFile=GLActual.dat
dataFileUploadLocation=UPLOAD_LOCATION
dataRuleName=RULE_NAME
startPeriod=START_PERIOD
endPeriod=END_PERIOD
importMode=IMPORT_MODE
exportMode=EXPORT_MODE
Linux/UNIX 
javahome=JAVA_HOME
epmautomatescript=EPM_AUTOMATE_LOCATION
username=exampleAdmin
passwordfile=examplePassword.epw
serviceURL=exampleURLdataFile=GLActual.dat
dataFileUploadLocation=UPLOAD_LOCATION
dataRuleName=RULE_NAME
startPeriod=START_PERIOD
endPeriod=END_PERIOD
importMode=IMPORT_MODE
exportMode=EXPORT_MODE

表格 3-21 input.properties 參數

參數 描述
javahome JAVA_HOME 位置。僅適用於 Linux/UNIX。
epmautomatescript EPM Automate 執行檔 (epmautomate.sh) 的絕對路徑。僅適用於 Linux/UNIX。
username 服務管理員的使用者名稱，該管理員也具備身分識別網域管理員角色。
password 服務管理員的密碼，或加密密碼檔案所在的名稱和位置。
serviceURL 環境的 URL，您會從這個環境產生快照。
dataFile 包含要使用資料規則匯入之資料的檔案。
dataFileUploadLocation 資料檔案的目標上傳位置。
dataRuleName 資料整合中定義之資料載入規則的名稱。
startPeriod 要載入資料的第一個期間。這個期間名稱必須定義在資料整合期間對映中。
endPeriod 針對多期間資料載入，資料的最後一個載入期間。針對單一期間載入，請使用和開始期間相同的期間。這個期間名稱必須定義在資料整合期間對映中。
importMode 用於將資料匯入至資料整合的模式。使用 APPEND、REPLACE 或 RECALCULATE。使用 NONE 以略過將資料匯入至臨時資料表。
exportMode 用於將資料匯出至應用程式的模式。使用資料整合。使用 STORE_DATA、ADD_DATA、SUBTRACT_DATA 或 REPLACE_DATA。使用 NONE 以略過將資料整合中的資料匯出至應用程式。

註：

Financial Consolidation and Close 僅支援 MERGE 和 NONE 模式。

執行指令碼

  1. 透過複製上一節的指令碼以建立 runDataLoadRule.ps1 或 runDataLoadRule.sh。
  2. 建立 input.properties 檔案並將它儲存至 runDataLoadRule 指令碼所在的目錄。此檔案的內容因作業系統而異。請參閱建立 input.properties 檔案。

    確保您在此目錄中具有寫入權限。至於 Windows，您可能需要使用以管理員身分執行選項來啟動 PowerShell，才能執行指令碼。

  3. 啟動指令碼。
    • Windows PowerShell：執行 runDataLoadRule.ps1。
    • Linux/UNIX：執行 ./runDataLoadRule.sh。