1 表单事件

事件类型为事件的触发时机或条件;事件类型有表单加载前、表单查询前、表单查询后、表单加载后、表单提交前、表单提交成功后、流程提交；可以选择相应的事件添加代码触发；

1.1 表单加载前

表单加载前事件常用于初始化表单数据、变量赋值等操作；

注意：此时在编辑、查看表单时formData的值还没查询出来。

1.1.1 初始化表单数据

例如：新增数据时设置审核人（选人组件）为张三（也可以调用后端接口拿到数据为组件绑定的字段赋值）。

//"21"为张三账号的id，选人组件可根据人员id回显
this.formData.pid = "21"

1.2 表单查询前

在查看或编辑状态的表单中，您可以在查询详情数据之前修改查询条件。

1.3 表单查询后

在查看或编辑状态的表单中，您可以在查询详情数据之后修改查询结果。

1.4 表单加载后

表单加载后，此时页面元素已经渲染出来，常用于获取页面元素及元素方法；例如获取页面元素，设置组件隐藏、禁用等；而且此时在编辑、查看表单时formData的值已经查询出来，可以直接获取表单数据formData的值；

1.5 表单提交前

可表单提交前，可以对提交数据formData进行修改；判断数据是否满足需求，不满足可以return false,取消表单提交；

1.5.1 修改提交数据

使用场景：提交人员信息时，人员状态字段不需要再页面上由发起人填写，而是由系统默认设置为待审核状态。

详细步骤如下：

1.创建表单提交前事件，为表单实体formData中状态字段status赋值。

this.formData.status = "applying"

2.切换到试图页，打开视图设置，选择显示字段tab页，添加状态字段显示列，并设置他的格式化为字典类型，绑定对应的状态字典。

3.新增数据表单弹窗信息填写完后，即可在数据列表中看到状态字段默认都为审核中。

1.5.2 取消提交操作

使用场景：提交前校验填写人年龄是否大于25岁，大于25岁提示不可提交并取消提交操作。

详细步骤如下：

1.创建表单提交前事件，根据填写的年龄字段判断，大于25弹出提示并返回false并保存。

if (this.formData.age > 25) {
  this.$message.error('年龄大于25岁，不可填写！');
  return false;
}

2.切换到视图页面，新增数据，填写年龄大于25后点击保存即可看到提示效果，并且没有触发保存操作。

1.6 表单提交后

可以在表单提交后处理一些事件；可以用于添加提示信息等；此时表单信息 formData 的主键数据已经生成；

1.7 流程提交前

在流程提交窗口打开前调用（可用参数 processContext, bfpContext）；

可以根据需要动态修改流程审批页面的提交配置：是否指定活动环节、活动环节是否单选、是否显示审批意见、允许修改分支环节、允许修改参与者。links 为后续环节配置。

可以根据需要动态修改流程审批页面的抄送配置：允许修改抄送等配置项。sendRules 为抄送配置。

流程提交前的配置在所有配置中优先级最高。

1.7.1 动态配置流程参与者与抄送

未添加流程提交前事件配置时，点提交时的弹框按照提交按钮的提交策略和抄送配置显示。

添加流程提交前事件配置后，点提交时的弹框按照添加的配置来显示。在表单高级设置的事件(流程提交前)中添加如下代码：

// 活动定义的id可以在流程设计页面找到
// 根据不同的活动环节返回指定的环节配置

console.log('------------------------------ 流程提交前')
if (processContext.activityDefID == "manualActivity1") {
  return {
    "destActivity": true, // 指定活动环节
    "destActivitySingle": true, // 活动环节是否单选
    "showApprovalComments": true, // 是否显示审批意见
    "allowEditLink": true, // 允许修改分支环节
    "allowEditParticipant": true, // 允许修改参与者
    "allowEditSend": true, // 允许修改抄送
    "links": [ // 后续环节配置
      {
        "id": "manualActivity2", // 后续环节id
        "name": "人工活动2", // 后续环节name
        "useLinkData": false, // 是否使用流程配置的环节设置
        "rule": {
          "destActivityParticipant": true, // 是否指定活动参与者
          "destParticipants": [ // 指定的参与者集合
            {
              "id": "71",
              // "name": "test4",
              "typeCode": "emp"
            }, {
              "id": "27",
              // "name": "ddddd",
              "typeCode": "emp"
            }
          ],
          "participantScope": "dest", // 参与者范围：指定参与者
          "participantSingle": true, // 参与者是否单选
          "defaultGlobal": false // 使用全局配置
        }
      }, {
        "id": "manualActivity3",
        "name": "人工活动3",
        "useLinkData": false,
        "rule": {
          "destActivityParticipant": true,
          "destParticipants": [{
            "id": "25",
            // "name": "test0816",
            "typeCode": "emp"
          }, {
            "id": "44",
            // "name": "wangli姓名",
            "typeCode": "emp"
          }],
          "participantScope": "dest",
          "participantSingle": true,
          "defaultGlobal": false
        },
      },
    ],
    "sendRules": { // 抄送配置
      isSend: true, // 是否显示抄送
      participantScope: 'dest', // 抄送参与者范围类型
      //       defaultParticipants: [], // 默认抄送人
      //       receiverRules: {}, // 指定抄送人
      destParticipants: [ // 抄送参与者范围
        {
          "id": "48",
          "name": "测试调整",
          "typeCode": "org",
          "code": "child"
        }, {
          "id": "1",
          "name": "测试工作组",
          "typeCode": "workGroup",
          "code": "testgroup"
        },
        //         {
        //           "id": "82",
        //           "name": "应用用户",
        //           "typeCode": "role",
        //           "code": "app-role-user"
        //         },
        //         {
        //           "id": "10",
        //           "name": "平台管理员",
        //           "typeCode": "role",
        //           "code": "afc-role-sys-manager"
        //         }, 
        //         {
        //           "id": "84",
        //           "name": "testuser4",
        //           "typeCode": "emp",
        //           "code": "testuser4"
        //         }
      ],
    },
  }
}