运行数据规则

根据起始期间和结束期间执行 Oracle Hyperion Financial Data Quality Management, Enterprise Edition 数据加载规则,然后导入或导出您指定的选项。

先决条件

  • 数据规则:数据加载规则定义集成如何从文件中加载数据。您必须具有预定义的数据加载规则,才能加载数据。

  • 您必须拥有执行特定数据规则所需的权限。

REST 资源

POST /aif/rest/{api_version}/jobs

请求

支持的介质类型:application/json

参数

下表对客户端请求进行了总结。

表 A-1 参数

名称 说明 类型 必需 默认
api_version 您使用的 API 版本,例如 V1 路径
jobType 应设置为 "DATARULE"  
jobName FDMEE 中定义的数据加载规则名称。如果规则名称中包含空格,则应该使用引号将其括起来。  
startPeriod 要加载数据的第一个期间。此期间名称必须在 FDMEE 期间映射中进行定义。  
endPeriod 要加载数据的最后一个期间。此期间名称必须在 FDMEE 期间映射中进行定义。  
importMode 确定如何将数据导入 FDMEE

可接受的值包括:

  • APPEND,用于添加到 FDMEE 中的现有 POV 数据

  • REPLACE,用于删除 POV 数据并将其替换为文件中的数据

  • RECALCULATE,跳过导入数据,但使用更新的映射和逻辑帐户重新处理数据。

  • NONE,用于跳过将数据导入到 FDMEE 临时表的操作

 
exportMode 确定如何将数据导出到 FDMEE

对于 Oracle Hyperion Planning 应用程序,可接受的值包括:

  • STORE_DATA,用于合并 FDMEE 临时表中的数据和现有的 Planning 数据

  • ADD_DATA,用于将 FDMEE 临时表中的数据添加到 Planning

  • SUBTRACT_DATA,用于从现有的 Planning 数据中减去 FDMEE 临时表中的数据

  • REPLACE_DATA,用于清除 POV 数据并将其替换为 FDMEE 临时表中的数据。“场景”、“版本”、“年”、“期间”和“实体”中的数据将被清除

  • NONE,用于跳过将数据从 FDMEE 导出到 Planning 的操作

对于 Financial Consolidation and CloseTax Reporting 应用程序,可接受的值包括:

  • MERGE - 默认情况下,所有数据加载都在合并模式下进行处理。如果应用程序中已存在数据,则系统将使用加载文件中的新数据覆盖现有的数据。如果不存在数据,将创建新数据。

  • REPLACE - 系统首先针对在数据加载文件中引用的数据清除应用程序中的任何现有数据。然后,系统在合并模式下执行数据加载。

  • NONE - 跳过将数据从 FDMEE 导出到 Financial Consolidation and Close 的步骤

 
fileName 可选的文件名。如果未指定文件名,则此 API 会导入加载数据规则指定的文件名中包含的数据。在执行数据规则之前,数据文件必须已在收件箱中。  

URL 示例

https://<SERVICE_NAME>-<TENANT_NAME>.<dcX>.oraclecloud.com/aif/rest/V1/jobs

请求主体示例

{"jobType":"DATARULE",
"jobName":"aso to bso dr",
"startPeriod":"Dec-18",
"endPeriod":"Dec-18",
"importMode":"REPLACE",
"exportMode":"NONE",
"fileName":""
}

响应

支持的介质类型:application/json

表 A-2 参数

名称 说明

status

作业状态:-1 = 正在进行;0 = 成功;1 = 错误;2 = 取消待定;3 = 已取消;4 = 无效参数

jobStatus

作业状态的文本表示,采用以下其中一个值:"RUNNING"、"SUCCESS"、"FAILED"

jobId

FDMEE 中为作业生成的进程 ID

logFileName

包含此执行条目的日志文件。

outputFileName

已生成输出文件(若有)的名称。

processType

已执行进程的类型。将包含所有数据规则执行的 "COMM_LOAD_BALANCES"

executedBy

用于执行规则的用户的登录名。

details

发生应用程序错误时,将返回异常堆积踪迹

响应实体示例

下面显示了 JSON 格式的响应主体的示例。

{
    "jobStatus": "RUNNING"
"jobId": 2019
"logFileName": "\outbox\logs\Account Reconciliation Manager_2019.log"
"outputFileName": null
"processType": "COMM_LOAD_BALANCES"
"executedBy": "admin"
"status": -1
"links": [1]
    0:  {
    "rel": "self"
    "href": "https://<SERVICE_NAME>-<TENANT_NAME>.<dcX>.oraclecloud.com/aif/rest/V1/jobs/2019"
    "action": "GET"
}
"details": null

}