自动获取流程状态插件

1. 简介

1.1 功能简介

自动获取流程状态插件支持获取流程节点信息，包括流程状态、当前节点、当前审批、审批人姓名、流程结束时间、流程耗时等等。

1.2 应用场景

在进销存类场景的额度控制中，聚合表需要过滤表单的流程状态，此时通过自动获取流程状态插件，就可以将流程状态和流程节点信息回填至对应字段中，以备使用。

1.3 预期效果

以获取合同签署申请流程的流程状态为例，效果如下：

1.4 使用说明

1）若要使用该插件，需简道云账号开启 API 功能。

2）该插件为免费插件，付费版用户可免费使用。

2. 插件安装及配置

2.1 安装插件

1）直接安装

2）插件市场处安装

在简道云「插件市场」处，安装「自动获取流程状态」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。

2.2 配置插件

安装后，在「插件管理」处，点击插件右侧的「设置」按钮，将「简道云 API Key 」配置进去。

在「开放平台>>密钥管理」处，可以创建「API KEY」，查看并复制「API KEY」。

2.3 启用插件

打开插件右侧开关，启用插件。

3. 基础表单配置

3.1 创建表单

创建合同签署申请流程表单，用于填写合同签署申请信息。字段设置如下：

3.2 辅助字段设置

在「表单属性 >> 不可见字段赋值」处，设置其为「始终重新计算」。

3.3 流程设定

流程表单配置完成后，切换至「流程设定」中，进行流程配置。

3.3.1 配置流程发起节点

点击流程发起节点，在「节点属性 >> 字段权限」处，勾选如下所示字段的「可见」、「可编辑」权限：

3.3.2 配置审批节点

1）点击部门审批节点，在「节点属性 >> 基础属性」处，选择「节点负责人」；在「字段权限」处，勾选如下所示字段的「可见」权限：

2）点击上级部门审批节点，在「节点属性 >> 基础属性」处，选择「节点负责人」；在「字段权限」处，勾选如下所示字段的「可见」权限：

3.3.3 启用流程

流程设定完成后，点击「保存」，再点击「启用流程」，即可启用当前合同签署申请流程。

4. 智能助手配置

4.1 设置字段别名

进入「扩展功能 >> 数据推送」中，点击「设置字段别名」，设置如下字段别名：

字段别名设置完成后点击下方保存按钮。

4.2 添加智能助手

在「扩展功能 >> 智能助手」处点击「新建智能助手」，下方点击「新建老版智能助手」并点击确定。

4.3 设置触发动作

提交流程后，需要审批人对流程进行审批，即对原来的流程表单进行了修改。故在智能助手中，「触发动作」选择「修改数据」，「触发表单」选择「合同签署申请流程」，设置完成后点击「完成」。

4.4 设置执行动作

由于合同签署申请流程表单被修改后，触发「自动获取流程状态」插件，故执行动作在「插件」中选择「自动获取流程状态」。

进一步设置执行动作，如下图所示：

设置完成后，点击「完成」按钮，保存智能助手设置。

4.5 效果演示

自动获取流程状态的效果参见文本【1.3】节。

5. 注意事项

若企业需要配置其他字段别名，可参考 查询流程实例信息 。在「接口调用 >> 响应参数」表格中查找 tasks 相关字段，选择需要的字段并配置对应的字段别名即可。

6. 联系方式

该插件为官方合作的服务商开发，若您在使用过程中有任何疑问，可通过以下方式联系：