业务实体服务指南

10.4

上一个下一个

向记录附加文件

在向记录附加文件之前，请创建文件的元数据，然后再将文件上载到临时存储。

要创建文件的元数据，请使用创建文件元数据 REST API，将存储类型设置为 TEMP。

例如，以下请求可创建

Document_3.pdf

文件的元数据：

POST http://localhost:8080/cmx/file/localhost-orcl-MDM_SAMPLE/TEMP
Content-Type: application/json
{
    "fileName": "Document_3.pdf",
    "fileType": "pdf",
    "fileContentType": "application/pdf"
}

始终在 TEMP 存储中创建文件元数据。

创建文件元数据 REST API 返回文件 ID。文件 ID 格式如下：

<存储类型>_<RowID>

。其中，RowID 指的是您向存储上载的文件的行 ID。

在示例中，API 调用为

Document_3.pdf

文件返回以下 ID：

TEMP_SVR1.OJU3

可以使用文件 ID 来上载、附加、更新、下载和删除文件。

要上载文件，请使用上载文件内容 REST API，将存储类型设置为 TEMP。

例如，以下请求可将文件上载到 TEMP 存储：

PUT http://localhost:8080/cmx/file/localhost-orcl-MDM_SAMPLE/TEMP/TEMP_SVR1.OJU3/content
Content-Type: application/octet-stream
<file object (upload using REST client)>

上载文件后，TEMP 存储会将文件存储预配置的 60 分钟时间。您必须在预配置的时间到期之前将文件附加到记录。

要创建记录并将文件附加到新记录，请使用创建记录 REST API。

例如，以下请求可创建记录并附加文件 ID 为

TEMP_SVR1.OJU3

的文件：

POST http://localhost:8080/cmx/cs/localhost-orcl-MDM_SAMPLE/Person?systemName=Admin
Content-Type: application/json
{  
   "frstNm":"John",
   "lstNm":"Smith",
   "addrLn1":"2100 Breverly Road",
   "addrTyp":{  
      "addrTyp":"Billing",
      "addrTypDesc":"Billing"
   },
   "cntryCd":{  
      "cntryCd":"AX",
      "cntryDesc":"Aland"
   },
   "attachments":{  
      "item":[  
         {  
            "fileId":"TEMP_SVR1.OJU3"
         }
      ]
   }
}

向记录附加文件时，进程会将该文件存储到数据库。文件 ID 会更改为

DB_<RowID>

，其中 DB 指示文件存储在数据库中。

要替换向记录附加的文件，请使用上载文件内容 REST API，将存储类型设置为 DB。

例如，以下请求会替换数据库中向记录附加的文件 ID 为

DB_SVR1.OJU3

的文件：

PUT http://localhost:8080/cmx/file/localhost-orcl-MDM_SAMPLE/DB/DB_SVR1.OJU3/content
Content-Type: application/octet-stream
<file object (upload using REST client)>

请求 URL 中的存储类型为 DB。

要在向记录附加文件后编辑文件元数据，请使用上载文件元数据 REST API，将存储类型设置为 DB。

例如，以下请求会更新 DB 存储中与文件 ID

DB_SVR1.OJU3

关联的文件的文件元数据：

PUT http://localhost:8080/cmx/file/localhost-orcl-MDM_SAMPLE/DB/DB_SVR1.OJU3
Content-Type: application/json
{
    "fileName": "Document_4.pdf",
    "fileType": "pdf",
    "fileContentType": "application/pdf"
}

要下载向记录附加的文件，请使用获取文件内容 REST API，将存储类型设置为 DB。

例如，以下请求会从 DB 存储中下载与文件 ID

DB_SVR1.OJU3

关联的文件：

GET http://localhost:8080/cmx/file/localhost-orcl-MDM_SAMPLE/DB/DB_SVR1.OJU3/content

要删除向记录附加的文件，请使用删除文件内容 REST API，将存储类型设置为 DB。

例如，以下请求会从 DB 存储中删除与文件 ID

DB_SVR1.OJU3

关联的文件：

DELETE http://localhost:8080/cmx/file/localhost-orcl-MDM_SAMPLE/DB/DB_SVR1.OJU3

使用 REST API 上载文件

下载指南

发送反馈

社区

Knowledge Base

成功门户

Rename Saved Search

目录

业务实体服务指南

业务实体服务指南

向记录附加文件

向记录附加文件