导入数据映射

成员映射用来基于源值派生各个维的目标成员。在数据加载过程中将引用成员映射，使 Oracle Hyperion Financial Data Quality Management, Enterprise Edition 可以确定如何对加载到目标应用程序中的数据进行维化。成员映射定义在单个维中源成员和目标维成员之间的关系。必须为每个目标维创建一个成员映射。

您可以从选定的 Excel、.CSV 或 .TXT 文件中导入成员映射。也可以在文本文件中创建新映射并导入它们。导入成员映射支持合并或替换模式，可以验证也可以不验证目标成员的选项。

REST 资源

POST /aif/rest/{api_version}/jobs

请求

支持的介质类型：application/json

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

表 A-5 参数

名称	说明	类型	必需	默认
`api_version`	您使用的 API 版本，例如 V1	路径	是	无
`jobType`	作业类型 `MAPPINGIMPORT`	路径	是	无
`jobName`	要导入的特定维的维名称，例如 `ACCOUNT`，或用于导入所有维的 `ALL`	路径	是	无
`fileName`	从中导入映射的文件和路径。文件格式可能为 .CSV、.TXT、.XLS 或 .XLSX。文件必须在导入之前上传到收件箱或收件箱的子目录。在文件路径中包含收件箱，例如，`inbox/BESSAPPJan-06.csv`	路径	是	无
`importMode`	导入模式：`MERGE` 用于添加新规则或替换现有规则，或者 `REPLACE` 用于在导入之前清除以前的映射规则	路径	否	`MERGE`
`validationMode`	是否使用验证模式，`true` 或 `false` `true` 条目对照目标应用程序验证目标成员；`false` 加载无任何验证的映射文件。请注意，此验证流程是资源密集型流程，比 `false` 验证模式需要更长的时间；大多数客户选择的选项是 `false`	路径	否	`false`
`locationName`	应当加载映射规则的 FDMEE 位置；映射规则专用于 FDMEE 中的位置	路径	否	无

请求主体示例

下面显示了 JSON 格式的请求主体的示例。

{
"jobType":"MAPPINGIMPORT",
"jobName":"ACCOUNT",
"fileName":"inbox/BESSAPPJan-06.csv",
"importMode":"MERGE",
"validationMode":"false",
"locationName":"BESSAPP"
}

有关示例代码，请参阅“运行数据规则”中包含的代码示例。

响应

下表对响应参数进行了总结。

表 A-6 参数

名称	说明
`jobId`	在 FDMEE 中为作业生成的进程 ID，例如 1880
`jobStatus`	作业状态，例如 `RUNNING`
`logFileName`	包含此执行条目的日志文件，例如 `outbox/logs/BESSAPP-DB_1880.log`
`outputFileName`	已生成输出文件（若有）的名称，否则为 `null`
`processType`	已执行进程的类型，`IMPORT_MAPPING`
`executedBy`	用于执行规则的用户的登录名，例如 `admin`
`details`	发生应用程序错误时将返回异常堆积踪迹，否则为 `null`

支持的介质类型：application/json

参数

响应实体示例

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

{
"links": 
[
0]
"status":"-1"
"details":"null"
"jobId":"1880"
"jobStatus":"RUNNING",
"logFileName":"outbox/logs/BESSAPP-DB_1880.log",
"outputFileName":"null",
"processType":"IMPORT_MAPPING",
"executedBy":"admin"
}

有关示例代码，请参阅“运行数据规则”中包含的代码示例。