NC31审批流程开发文档_v1.2(7)

NC31审批流程开发文档_v1.2

语法宏与实际代码的对照表：

NC31审批流程开发文档_v1.2

注意：单据批动作处理必须与批量的动作脚本相对应！

4.2.2返回值

NC31审批流程开发文档_v1.2

4.3状态回写与查询

4.3.1单据审批状态

一旦单据送审到审批流中，单据便处于某个审批状态。在审批流内部，单据的内部审批状态有

5

自由态

即单据尚在编写中（已保存或尚未保存）并未提交到审批流的状态。

提交态

通过执行单据动作SAVE或EDIT，将单据送审后的状态。提交态是审批流内部的一个状态，它的回写并不通过审批流检查类进行。只能由业务组通过SAVE动作脚本自己对单据状态进行设置。所以有的业务组的单据并没有提交态的概念。

审批进行中

流程实例正处于运行中的状态。

审批完成

如果流程实例正常运行完成，该单据的审批过程即完成。审批流程结束后具有最终审批结果：通过或不通过，这也是单据的最终审批结果。

状态转换图如下所示：

NC31审批流程开发文档_v1.2

业务单据根据自己的业务需求也可定义自己的审批状态，但不可与上述5种状态相冲突。比如UI

在各个状态下对单据的业务处理（比如是否可删除、是否可编辑等）由业务组自己控制。参见节和节。

4.3.2状态回写

分为两种，一种是对单据聚合VO的回写，一种是对单据数据库表的回写。都是在动作执行脚本中完成。参见4.8.1节。

NC31审批流程开发文档_v1.2

4.3.3状态查询

后台API：

int nc.bs.pub.pf.PfUtilBO.queryWorkFlowStatus( String busiType, //业务类型PK String billType, //单据类型PK String billId) //单据Id

4.4送审

送审也称为提交，就是单据产生后进入到流程平台并启动审批流的步骤，通过调用单据动作处理来完成。审批流的触发支持两种单据动作，分别为“SAVE”和“EDIT”，即动作编码以两者结尾即可。送审后，流程平台会根据单据类型和制单人ID查找符合条件的流程定义并实例化然后启动它。如果找不到流程定义，则不启动审批流。

送审分为两种情形，一种是前台送审，即业务UI新增单据后保存并提交；另一种是后台送审，即某张单据在后台推式生成另一张单据时。

4.4.1动作处理

前台送审调用示例：

Object retObj = nc.ui.pub.pf.PfUtilClient.processAction(parentUI, “SAVE”, “D1”, “2005-05-30 12:23:44”, billVo, userObj, null, null )

如果单据数据billVo中没有保存制单人的信息，则可通过动作编码来传递。但要求原动作编码不能长于20个字符。

Object retObj = nc.ui.pub.pf.PfUtilClient.processAction(parentUI,

“SAVE”+billMakerUserId, “D1”, “2005-05-30 12:23:44”, billVo, userObj, null, null )

后台送审调用示例：