将数据文件上传到环境并运行数据加载规则

使用这些脚本可将文件上传到环境，然后运行数据规则将数据从文件导入到应用程序中。

先决条件

  • 数据管理中存在以下定义：
    • 名为 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。