自动获取流程状态插件

1. 简介

1.1 功能简介

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

1.2 应用场景

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

1.3 预期效果

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

1.4 使用说明

开启了 API 功能的付费版用户，可以免费使用该插件。

2. 插件安装及配置

2.1 安装插件

1）直接安装

您可点击右方链接直接安装插件：自动获取流程状态插件安装。
安装成功后，可参考本文【2.2 配置插件】和【2.3 启用插件】，前往「开放平台 >> 插件管理」处配置并启用插件。

2）插件市场处安装

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

2.2 配置插件

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

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

2.3 启用插件

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

3. 基础表单配置

插件使用体验可先安装：自动获取流程状态插件模板表单。本文将按照示例表单进行讲解。

3.1 创建表单

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

字段说明	字段名称	字段类型
流程内容	签署申请人	成员单选
	合同编号	单行文本
	合同名称
	合同类型
流程状态信息返回	流程状态	单行文本
	当前节点	单行文本
	当前审批	成员多选
	审批人姓名	单行文本
	审批人编号
	耗时
	完成时间	日期时间在「字段属性 >> 类型」处，设置类型为：年-月-日时:分:秒
其他参数返回	应用ID	单行文本
	表单ID
	数据ID
	来源表单
	创建动作
	完成动作

注：

1）耗时为流程完成所耗费的时间，以小时为单位进行计算。

2）完成时间为流程结束时间，非表单数据更新时间。

3.2 辅助字段设置

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

3.3 流程设定

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

3.3.1 配置流程发起节点

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

3.3.2 配置审批节点

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

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

3.3.3 启用流程

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

4. 智能助手配置

4.1 设置字段别名

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

「流程状态」字段为固定字段填写字段别名为 flow_state；
「当前节点」填写字段别名为 flow_name；
「当前审批」填写字段别名为 assignee；
「审批人姓名」填写字段别名为 assignee_name；
「审批人编号」填写字段别名为 assignee_username；
「耗时」填写字段别名为 time_consume；
「完成日期」填写字段别名为 finish_time；
「应用ID」填写字段别名为 app_id；
「表单ID」填写字段别名为 form_id；
「数据ID」填写字段别名为 instance_id；
「表单来源」填写字段别名为 form_title；
「创建动作」填写字段别名为 create_action；
「完成动作」填写字段别名为 finish_action。

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

注：

1）「流程状态」为固定必填字段，字段别名必配，且字段别名可根据业务自定义命名；

2）「耗时」填写字段别名为 time_consume，字段别名为固定值，不可自定义；

3）其他流程信息相关字段根据业务需求进行搭建和配置即可，字段别名为固定值，参考【5.注意事项】进行别名配置。

4.2 添加智能助手

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

4.3 设置触发动作

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

4.4 设置执行动作

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

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

应用ID：设置为「字段值」，下拉框内选择「应用ID」；
表单ID：设置为「字段值」，下拉框内选择「表单ID」；
数据ID：设置为「字段值」，下拉框内选择「数据ID」；
状态别名：设置为「自定义」，填入上述【4.1 设置字段别名】中自定义的「流程状态」字段别名值，此项只能填写一个字段别名；
流程别名：设置为「自定义」，填入上述【4.1 设置字段别名】中的除「流程状态」外其他字段的别名值，可填写多个字段别名值用英文输入法中的逗号隔开。

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

注：应用 ID、表单 ID、数据 ID 配置选择字段时，因有重名字段，请选择最下方三个简道云自带的应用 ID、表单 ID、数据 ID 字段进行配置。

4.5 效果演示

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

5. 注意事项

5.1 其他字段别名参考

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

5.2 关于「否决」按钮的说明

业务流程 2024.12.27 节点操作新增了「否决」按钮，「自动获取流程状态」插件也同步进行了兼容，流程状态新增了「否决」状态的返回值，用户无需另行配置。

注：若用户将取出来的流程状态用在了聚合表作为过滤条件，或者用在数据工厂公式计算时作为了判断条件，请在开启「否决」按钮后，注意相应的考虑这个新的流程状态。

5.3 关于获取内链的配置说明

若需要获取内链，则需配置智能助手Pro 才能自动返回内链地址，配置参考如下：

5.3.1 新增表单字段

表单设计中，新增「内链地址」字段，字段设置如下所示：

字段名称	字段类型	字段设置
内链地址	单行文本	在「字段属性 >> 默认值」处选择「公式编辑」，设置公式如下所示： CONCATENATE('https://www.jiandaoyun.com/dashboard/app/',应用ID,'/form/',表单ID,'/data/',数据ID,'/qr_link')