报表参数
在应用流程填报时,填报表单的设计需要与流程密切结合。例如:
- 填报表单在流程的不同节点会有不同的填写权限。例如“销售费用预算上报审批流程”这个用例中,只有“销售人员上报”节点才能在填报表中进行数据填写,其它两个节点都只能查看而不能填写修改数据。
- 填报表单需要获取当前任务处理人员以及其所在的机构。例如,“销售人员上报”节点中,需要根据上报数据的销售人员ID和机构ID,查找出其姓名和机构名称并自动填写在填报表单的报送人和部门中。
- 在流程的某个填报任务中,填报表单要抽取展现的数据必须是对应任务的数据。
以上所列举的这些需求,其实都涉及到应用流程填报时填报表单中的参数设置。因为填报表单需要从流程填报中获取一些特定参数来实现这些需求。例如,填报表需要获取节点的模式名来控制填写权限,需要获取任务处理人员的ID来查询其姓名,需要获取填报任务的ID来从数据库表中查询出对应的填报数据。
下面列出的这些参数,是在应用流程填报时系统可自动传递给报表的参数,在设计填报表单时可根据需要选择使用:
- Task_ID:填报任务ID,用户可以使用流程发起填报任务,每个填报任务都具有一个唯一的任务ID,参数Task_ID在填报表单中是必须使用的,需要利用此参数进行填报数据的查询,以及作为填报数据保存的主键或至少是主键之一
- Org_ID:当前处理填报任务用户的机构ID
- User_ID:当前处理填报任务的用户ID
- Mode:当前填报任务处理节点的模式名,即设计流程时在节点基本属性中设置的模式名
- Task_Status:任务状态,该参数的值是一个数字,表示任务是处于处理中还是已完成等不同状态,不同值的具体意义为:1-处理中,3-已关闭(任务在中途被关闭中止),4-已完成
- Task_StartTime:任务启动的时间
- Node_ID:任务当前流转到的节点ID
以上参数用户在使用过程中请注意以下几点:
1、这些参数在流程填报模块中会自动传递给报表,报表需要用到哪些参数,用户在设计报表时定义同名参数即可。需注意参数名的大小写。参数类型使用【普通参数】。
2、Task_ID对于流程填报的填报表单是必须的,因为对于填报表单的数据获取与保存都需要用到。在保存填报数据的数据库表中需要设置一个Task_ID字段。在流程填报模块中,每启动一个任务,系统就会对该任务自动生成一个唯一的Task_ID值。
3、Mode参数常用于填报表单的单元格填写权限控制,可使用该参数获取节点的模式名,从而实现不同节点不同处理人员的填报表单可写权限控制。具体用法可参考“填报表的权限控制”。
下图是用例“销售费用预算上报审批流程”中填报表单使用到的参数定义。其中,TaskID用于数据获取与保存,OrgID和UserID用于获取任务处理人员的机构ID和系统帐号ID从而可以从系统表查询出机构名称和人员姓名,Mode用于获取节点模式名从而实现填报表单的填写权限控制。