业务实体服务指南

10.3

上一个下一个

向任务附加文件

创建文件的元数据，然后将文件内容上载到临时存储。上载文件后，将文件附加到触发的任务或现有任务。

要将文件附加到触发的任务或现有任务，请在置备工具中为任务触发器、任务类型和任务操作启用附件。有关详细信息，请参阅

《Multidomain MDM 置备工具指南》

。

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

例如，以下请求可创建

file1.txt

文件的元数据：

POST http://localhost:8080/cmx/file/localhost-orcl-MDM_SAMPLE/TEMP

{
    “fileName”: “file1.txt”,
    “fileType”: “text”,
    “fileContentType”: “text/plain”
}

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

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

<存储类型>_<RowID>

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

在示例中，API 调用为

file1.txt

返回以下 ID：

TEMP_SVR1.1VDVS

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

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

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

PUT http://localhost:8080/cmx/file/localhost-orcl-MDM_SAMPLE/TEMP/TEMP_SVR1.1VDVS/content

Test attachment content: file 1

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

将文件附加到管理记录时触发的任务。

要将文件附加到创建记录时触发的任务，请使用带

taskattachments

参数的创建业务实体 REST API。

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

TEMP_SVR1.1VDVS

的文件：

POST http://localhost:8080/cmx/cs/localhost-orcl-DS_UI1/Person?systemName=Admin&taskAttachments=TEMP_SVR1.1VDVS 
Content-Type: application/json

{ 
     firstName: "John", 
     lastName: "Smith", 
     Phone: { 
          item: [ 
               { 
                    phoneNumber: "111-11-11" 
               } 
          ] 
     } 
}

要将文件附加到更新记录时触发的任务，请使用带

taskattachments

参数的更新业务实体 REST API。

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

TEMP_SVR1.1VDVS

的文件：

PUT http://localhost:8080/cmx/cs/localhost-orcl-DS_UI1/Person/233?systemName=Admin&taskAttachments=TEMP_SVR1.1VDVS
{
    rowidObject: "233",
    firstName: "BOB",
    lastName: "LLOYD",
    Phone: {
        item: [
            {
                rowidObject: "164",
                phoneNumber: "777-77-77",
                $original: {
                    phoneNumber: "(336)366-4936"
                }
            }
        ]
    },
    $original: {
        firstName: "DUNN"
    }
}

要将文件附加到合并记录时触发的任务，请使用带

taskattachments

参数的合并业务实体 REST API。

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

TEMP_SVR1.1VDVS

的文件：

POST http://localhost:8080/cmx/cs/localhost-orcl-DS_UI1/Person/2478245?action=merge&taskAttachments=TEMP_SVR1.1VDVS
Content-Type: application/<json/xml>
{
  keys: [
    {
        rowid: "2478246"
    }
  ],
  overrides: {
    Person: {
       firstName: "Charlie"
    }
  }
}

要将文件附加到取消合并记录时触发的任务，请使用带

taskattachments

参数的取消合并业务实体 REST API。

例如，以下请求可取消合并记录并附加文件 ID 为

TEMP_SVR1.1VDVS

的文件：

POST http://localhost:8080/cmx/cs/localhost-orcl-DS_UI1/Person/2478248?action=unmerge&taskAttachments=TEMP_SVR1.1VDVS
{
        rowid: "4880369" 
}

向现有任务附加文件。

要在更新任务时附加文件，请使用请求主体中含

attachments

的更新任务 REST API。

例如，以下请求可更新任务并附加文件 ID 为

TEMP_SVR1.1VDVS

的文件：

PUT http://localhost:8080/cmx/cs/localhost-orcl-MDM_SAMPLE/task/urn:b4p2:15934
{ 
     taskType: {
          name: "UpdateWithApprovalWorkflow"
     }, 
     taskId: "urn:b4p2:15934", 
     owner: "John", 
     title: "Smoke test task - updated", 
     comments: "Smoke testing - updated", 
     "attachments": [
          {
               "id": "TEMP_SVR1.1VDVS"
          }
     ],
     ...
}

要在执行任务操作时附加文件，请使用请求主体中含

attachments

的执行任务操作 REST API。

例如，以下请求可执行任务操作并附加文件 ID 为

TEMP_SVR1.1VDVS

的文件：

POST http://localhost:8080/cmx/cs/localhost-orcl-MDM_SAMPLE/task/urn:b4p2:15934?taskAction=Cancel
{ 
     taskType: { 
          name:"UpdateWithApprovalWorkflow", 
          taskAction: [{name: "Cancel"}] 
     }, 
     taskId: "urn:b4p2:15934", 
     owner: "manager", 
     title: "Smoke test task 222", 
     comments: "Smoke testing",
     "attachments": [
          {
               "id": "TEMP_SVR1.1VDVS"
          }
     ],
     ...
}

将文件附加到任务后，进程会移动 TEMP 存储中的文件，将该文件与任务数据一起存储在 BPM 存储中。文件 ID 将更改为

taskId::filename

。

使用 REST API 上载文件

下载指南

发送反馈

社区

Knowledge Base

成功门户

Rename Saved Search

目录

业务实体服务指南

业务实体服务指南

向任务附加文件

向任务附加文件