流程实例 - Object: workContext
你可以通过workContext获取和流程相关的流程实例对象数据。

获取workContext对象

您可以在表单或流程的各个嵌入脚本中,通过this来获取当前流程实例数据,如下:

Syntax:

1
var context = this.workContext;
Copied!

流程实例相关操作

getTask

获取当前流程与当前用户相关的待办对象:task对象。
当前流程实例正在流转中,并且当前用户有待办,则返回当前用户的待办对象,否则返回null。

Syntax:

1
var task = this.workContext.getTask();
Copied!

Return:

1
> task : (Object)当前用户的待办任务对象:task。
2
> null : (null)当前用户没有对此流程实例的待办时,或流程实例已经流转结束,返回null。
Copied!
task对象为JSON格式数据,其格式和主要数据如下:
task对象
1
{
2
"id": "dd476045-7c79-44f7-9dba-f51d322de40f", //待办ID
3
"title": "XX7月北京出差报销审批", //流程实例标题
4
"startTime": "2018-09-27 22:49:22", //待办到达时间
5
"startTimeMonth": "2018-09", //待办到达的月份
6
"work": "854e2c22-718e-48bb-98db-96f4b43e7ee8", //流程实例ID
7
"application": "1dc23336-6be6-402b-bed6-36e707a1dd17", //流程应用ID
8
"applicationName": "财务管理", //流程应用名称
9
"applicationAlias": "finance", //流程应用别名
10
"process": "2207db11-dddf-4ebd-864d-3819f3e173c6", //流程ID
11
"processName": "报销审批流程", //流程名称
12
"processAlias": "", //流程别名
13
"serial": "", //流程编号
14
"person": "[email protected]@P", //待办人名称
15
"identity": "[email protected]@I", //待办人身份
16
"unit": "[email protected]@U", //待办人所在组织
17
"activity": "13d15daf-2ac5-4c1b-a669-1607a0e5ed15", //当前活动的ID
18
"activityName": "部门领导审核", //当前活动的名称
19
"activityAlias": "", //当前活动的别名
20
"activityDescription": "", //当前活动描述
21
"activityType": "manual", //当前活动类型
22
"creatorPerson": "[email protected]@P", //流程实例创建人
23
"creatorIdentity": "[email protected]@I", //流程实例创建人的身份
24
"creatorUnit": "[email protected]@U", //流程实例创建人所在组织
25
"expired": false, //是否已超时
26
"urged": false, //是否进行催办
27
"routeList": [ //可选的路由ID
28
"89b58fe0-6dcb-4fe7-8c2e-3f77204df6d4",
29
"f3105b7a-2929-4682-aab8-15fef5ea0f23"
30
],
31
"routeNameList": [ //可选的路由名称
32
"退回申请人",
33
"送财务部门复审"
34
],
35
"routeOpinionList": [ //可选路由的默认意见
36
"",
37
""
38
]
39
}
Copied!

getWork

获取当前流程实例对象:work对象或workCompleted对象。

Syntax:

1
var work = this.workContext.getWork();
Copied!

Return:

1
> work : (Object)流程实例对象。
2
> workCompleted : (Object)如果流程已结束,返回已结束的流程实例对象:workCompleted。
Copied!
work对象或workCompleted对象为JSON格式数据,其格式和主要数据如下:
work对象
1
var work = {
2
"id": "854e2c22-718e-48bb-98db-96f4b43e7ee8", //流程实例ID
3
"splitValue": "xxxxxxxxxxxxxx", //流程拆分后的拆分依据
4
"title": "xx7月北京出差报销审批", //流程实例名称
5
"startTime": "2018-09-07 14:03:22", //流程启动时间
6
"startTimeMonth": "2018-09", //流程启动的月份
7
"creatorPerson": "[email protected]@P", //流程实例创建人
8
"creatorIdentity": "[email protected]@I", //流程实例创建人身份
9
"creatorUnit": "[email protected]@U", //流程实例创建人所在组织
10
"creatorUnitLevelName": "浙江兰德纵横/开发部", //流程实例创建人所在组织层次
11
"application": "1dc23336-6be6-402b-bed6-36e707a1dd17", //流程应用ID
12
"applicationName": "财务管理", //流程应用名称
13
"applicationAlias": "finance", //流程应用别名
14
"process": "2207db11-dddf-4ebd-864d-3819f3e173c6", //流程ID
15
"processName": "报销审批流程", //流程名称
16
"processAlias": "", //流程别名
17
"activity": "13d15daf-2ac5-4c1b-a669-1607a0e5ed15", //当前活动ID
18
"activityType": "manual", //当前活动类型
19
"activityName": "部门领导审核", //当前活动名称
20
"activityAlias": "", //当前活动别名
21
"activityDescription": "", //当前活动描述
22
"activityArrivedTime": "2018-09-27 22:49:21", //当前活动到达时间
23
"serial": "", //编号
24
"workStatus": "processing", //流程实例状态
25
"errorRetry": 0, //流转失败重试次数
26
"splitting": false, //流程是否拆分
27
"form": "db3b2766-93a1-4058-b522-0edb922bd84f" //流程展现所使用的表单
28
}
Copied!
workCompleted对象
1
var workCompleted = {
2
"id": "be0195f1-f2e2-4eac-911c-99897a43ff8f", //流程实例ID
3
"title": "xx7月北京出差报销审批", //流程实例名称
4
"startTime": "2018-09-19 16:14:16", //流程启动时间
5
"startTimeMonth": "2018-09", //流程启动的月份
6
"completedTime": "2018-09-19 16:15:28", //流程完成时间
7
"completedTimeMonth": "2018-09", //流程完成的月份
8
"creatorPerson": "[email protected]@P", //流程实例创建人
9
"creatorIdentity": "[email protected]@I", //流程实例创建人身份
10
"creatorUnit": "[email protected]@U", //流程实例创建人所在组织
11
"creatorUnitLevelName": "浙江兰德纵横/开发部", //流程实例创建人所在组织层次
12
"application": "1dc23336-6be6-402b-bed6-36e707a1dd17", //流程应用ID
13
"applicationName": "财务管理", //流程应用名称
14
"applicationAlias": "finance", //流程应用别名
15
"process": "2207db11-dddf-4ebd-864d-3819f3e173c6", //流程ID
16
"processName": "报销审批流程", //流程名称
17
"processAlias": "", //流程别名
18
"serial": "", //编号
19
"form": "320be1ca-ee49-478f-a751-f65ab67cf818", //流程展现所使用的表单
20
}
Copied!

getActivity

获取当前流程实例所在的活动节点对象:activity对象。

Syntax:

1
var activity = this.workContext.getActivity();
Copied!

Return:

1
> activity : (Object)当前流程实例所在的活动节点对象:activity。
2
> null : (null)如果当前流程实例已流转完成,则返回null
Copied!

getTaskList

获取当前流程实例的所有待办对象。如果流程实例已流转完成,则返回一个空数组。

Syntax:

1
var taskList = this.workContext.getTaskList();
Copied!

Return:

1
> array of task : (array)当前流程实例的所有待办。
Copied!

getReadList

获取当前流程实例的所有待阅对象。如果流程实例无待阅,则返回一个空数组。

Syntax:

1
var taskList = this.workContext.getReadList();
Copied!

Return:

1
> array of read : (array)当前流程实例的所有待阅。
Copied!
每个read对象为JSON格式数据,其格式和主要数据如下:
read对象
1
{
2
"id": "dd476045-7c79-44f7-9dba-f51d322de40f", //待阅ID
3
"title": "XX7月北京出差报销审批", //流程实例标题
4
"startTime": "2018-09-27 22:49:22", //待阅产生时间
5
"startTimeMonth": "2018-09", //待阅产生的月份
6
"work": "854e2c22-718e-48bb-98db-96f4b43e7ee8", //流程实例ID
7
"application": "1dc23336-6be6-402b-bed6-36e707a1dd17", //流程应用ID
8
"applicationName": "财务管理", //流程应用名称
9
"applicationAlias": "finance", //流程应用别名
10
"process": "2207db11-dddf-4ebd-864d-3819f3e173c6", //流程ID
11
"processName": "报销审批流程", //流程名称
12
"processAlias": "", //流程别名
13
"completed": false, //流程是否已完成
14
"serial": "", //流程编号
15
"person": "[email protected]@P", //待阅人名称
16
"identity": "[email protected]@I", //待阅人身份
17
"unit": "[email protected]@U", //待阅人所在组织
18
"activity": "13d15daf-2ac5-4c1b-a669-1607a0e5ed15", //当前活动的ID
19
"activityName": "部门领导审核", //当前活动的名称
20
"activityAlias": "", //当前活动的别名
21
"activityDescription": "", //当前活动描述
22
"activityType": "manual", //当前活动类型
23
"creatorPerson": "[email protected]@P", //流程实例创建人
24
"creatorIdentity": "[email protected]@I", //流程实例创建人的身份
25
"creatorUnit": "[email protected]@U" //流程实例创建人所在组织
26
}
Copied!

getTaskCompletedList

获取当前流程实例的所有已办对象。如果流程实例没有任何人处理过,则返回一个空数组。

Syntax:

1
var taskCompletedList = this.workContext.getTaskCompletedList();
Copied!

Return:

1
> array of workCompleted : (array)当前流程实例的所有已办。
Copied!
每个workCompleted对象为JSON格式数据,其格式和主要数据如下:
workCompleted对象
1
{
2
"id": "2aef274c-ec3b-4cb3-882b-6f6c4a2fb6f6", //已办ID
3
"title": "xx7月北京出差报销审批", //流程实例标题
4
"startTime": "2018-09-27 22:49:22", //待办产生时间
5
"startTimeMonth": "2018-09", //待办产生的月份
6
"completedTime": "2018-10-08 22:04:35", //已办处理时间
7
"completedTimeMonth": "2018-10", //已办处理的月份
8
"work": "854e2c22-718e-48bb-98db-96f4b43e7ee8", //流程实例ID
9
"completed": false, //流程是否已完成
10
"application": "1dc23336-6be6-402b-bed6-36e707a1dd17", //流程应用ID
11
"applicationName": "财务管理", //流程应用名称
12
"applicationAlias": "finance", //流程应用别名
13
"process": "2207db11-dddf-4ebd-864d-3819f3e173c6", //流程ID
14
"processName": "报销审批流程", //流程名称
15
"processAlias": "", //流程别名
16
"serial": "", //流程编号
17
"person": "[email protected]@P", //已办人名称
18
"identity": "[email protected]@I", //已办人身份
19
"unit": "[email protected]@U", //已办人所在组织
20
"activity": "13d15daf-2ac5-4c1b-a669-1607a0e5ed15", //当前活动的ID
21
"activityName": "部门领导审核", //当前活动的名称
22
"activityAlias": "", //当前活动的别名
23
"activityDescription": "", //当前活动描述
24
"activityType": "manual", //当前活动类型
25
"creatorPerson": "[email protected]@P", //流程实例创建人
26
"creatorIdentity": "[email protected]@I", //流程实例创建人的身份
27
"creatorUnit": "[email protected]@U" //流程实例创建人所在组织
28
"routeName": "退回申请人", //已办选择的路由名称
29
"opinion": "退回申请人" //办理意见
30
}
Copied!

getControl

获取当前人对流程实例的权限。

Syntax:

1
var control = this.workContext.getControl();
Copied!

Return:

1
> Object : (Object)当前人对流程实例的所拥有的权限。
Copied!
返回内容如下:
流程实例的权限对象
1
{
2
"allowVisit": true, //是否允许访问
3
"allowProcessing": true, //是否允许流转
4
"allowReadProcessing": false, //是否有待阅
5
"allowSave": true, //是否允许保存业务数据
6
"allowReset": false, //是否允许重置处理人
7
"allowRetract": false, //是否允许撤回
8
"allowReroute": false, //是否允许调度
9
"allowDelete": true //是否允许删除流程实例
10
}
Copied!

getWorkLogList

获取当前流程实例的所有流程记录。

Syntax:

1
var workLogList = this.workContext.getWorkLogList();
Copied!

Return:

1
> Array of Object : (array)当前流程实例的所有流程记录。
Copied!
流程记录是一个JSON数组。每个对象的格式和主要数据如下:
1
{
2
"taskList": [...], //此记录的待办(task)对象数组,见getTaskList
3
"taskCompletedList": [...],//此记录的已办(taskCompleted)对象数组,见getTaskCompletedList
4
"readList": [...], //此记录的待阅(read)对象数组,见getReadList
5
"readCompletedList": [...],//此记录的已阅(readCompleted)对象数组
6
"id": "7e30462b-93f1-4e4d-a38b-bea41ed7fc02", //此纪录的ID
7
"work": "854e2c22-718e-48bb-98db-96f4b43e7ee8", //流程实例ID
8
"completed": false, //是否已完成
9
"fromActivity": "e31ad938-c495-45a6-8d77-b8a9b61a165b", //起始活动ID
10
"fromActivityType": "manual", //起始活动类型
11
"fromActivityName": "申请人", //起始活动名称
12
"fromActivityAlias": "", //起始活动别名
13
"fromActivityToken": "51209d08-d634-4f15-9b8d-7a6cf131b89f",//起始活动流程记录token(对应上一条流程记录的arrivedActivityToken)
14
"fromTime": "2018-09-07 14:03:22", //起始活动的到达时间
15
"arrivedActivity": "13d15daf-2ac5-4c1b-a669-1607a0e5ed15", //到达活动的ID
16
"arrivedActivityType": "manual", //到达活动类型
17
"arrivedActivityName": "部门领导审核", //到达活动名称
18
"arrivedActivityToken": "0a4cfc83-9757-4000-a669-8a45c3ab069e", //到达活动的token
19
"arrivedTime": "2018-09-27 15:50:34", //到达此活动的时间
20
"application": "1dc23336-6be6-402b-bed6-36e707a1dd17", //流程应用ID
21
"applicationName": "财务管理", //流程应用名称
22
"process": "2207db11-dddf-4ebd-864d-3819f3e173c6", //流程ID
23
"processName": "报销审批流程", //流程名称
24
"route": "85272e6d-4fda-4cba-aa93-84f964138981", //经过的路由ID
25
"routeName": "送部门领导审核", //经过的路由名称
26
"connected": true //是否有下一条流程记录
27
},
Copied!

getAttachmentList

获取当前流程实例的附件对象列表。

Syntax:

1
var attachmentList = this.workContext.getAttachmentList();
Copied!

Return:

1
> Array of Object : (array)当前流程实例的所有附件对象。
Copied!
附件对象是一个JSON数组。每个对象的格式和主要数据如下:
1
{
2
"id": "56c4e86f-a4c8-4cc2-a150-1a0d2c5febcb", //附件ID
3
"name": "133203a2-92e6-4653-9954-161b72ddb7f9.png", //附件名称
4
"extension": "png", //附件扩展名
5
"length": 43864, //附件大小
6
"person": "[email protected]@P", //附件上传人
7
"lastUpdateTime": "2018-09-27 15:50:34", //最后的修改时间
8
"lastUpdatePerson": "[email protected]@P", //最后的修改人
9
"activity": "e31ad938-c495-45a6-8d77-b8a9b61a165b", //附件上传的活动ID
10
"activityName": "申请人", //附件上传的活动名称
11
"activityType": "manual", //附件上传的活动类型
12
"site": "$mediaOpinion", //附件存储位置(一般用于区分附件在哪个表单元素中显示)
13
"type": "image/png" //附件类型(contentType)
14
}
Copied!

getRouteList

获取当前待办的可选路由。与task对象中的routeNameList取值相同。

Syntax:

1
var routeList = this.workContext.getRouteList();
Copied!

Return:

1
> Array of String : (array)当前待办的可选路由。
Copied!

setTitle

重新设置流程实例标题。
注意:如果表单中有名为“subject”或“title”的可输入元素,或给业务数据(data)的 “subject” 或 “title” 节点赋了值,那么每次流转后,流程实例的标题会自动设置为 “subject” 或 “title” 的值。

Syntax:

1
this.workContext.setTitle("这是一个标题");
Copied!

Return:

1
无返回值
Copied!