1前言

1.1背景

目前我家云已提供多种工作流程审批方式，包括业务确认流和云之家自由流，具有使用方便，灵活的特点，但流程节点，条件路由无法按指定规则流转。为了规范流程审批，以及适应更多条件路由的自定义审批流程，现加入云之家智能审批应用，用户可以事先定制好工作流模板，在业务中根据需要选择调用。

1.2说明

此文档主要说明我家云智能审批的配置与使用，角色分别对应管理员及员工。

2模板定义

2.1我家云登陆

管理员登陆我家云

在“企业管理”--“系统管理”中，单击“工作流模板”，打开云之家流程设置页面

注意：如果在打开的“工作流模板”菜单中，找不到审批模板管理，请确认当前用户是否为当前云之家团队的创建者或管理员。

特别说明：此处工作流模板设置与从云之家进入设置的模板为同一个内容

2.2模板管理

选择右上角的“新建模板”，后在弹出层上选择“自定义模板”

如果没有创建过分类，先创建一个分类，有利于模板管理，分类名称请按本文后附“5 模板分类说明”定义，以保证每个业务模块可以正确选择到模板。

创建模板后，选择“编辑表单”，进行流程模板创建

流程模板设置分为两个内容“表单设计”“过程设计”

2.3表单设计

表单设计目前支持基础控件模板和互联控件模式，基础控件要求严格对应表单数据，互联控件只要求绑定关系，比较灵活。

推荐使用互联控件模式工作流。

2.3.1 基础控件模式

表单设计中，可以拖拉“基础控件”到表单上，请严格按照本文后附“ 6模板表单说明”设置，以保证流程发起后，能正确获取到业务数据，进行表单展示。

2.3.2 互联控件模式

使用数据互联控件与使用普通基础控件的区别是，可以事先关联好表单控件与数据字段的对应的关系，不需要在发起时判断表单控件名称的正确性；表单控件名称不再受强控制，可以自由定义。表单控件的选择范围一目了然，可以自由选择搭配设计流程。

第一步，在表单上增加一个“数据互联控件”，可以修改名称，不做限制清晰易懂就好，数据互联控件最重要的是配置“外部数据源接口地址”，各业务地址请查看“7 外部数据源接口地址”。

地址配置完成要进行“接口校验”，验证通过才能进行下一步：数据关联。

第二步，在互联控件下方，拖选工作流表单内容控件，目前支持（单行文本框，数字输入框，金额输入框）三类控件

注意，控件类型影响到与业务数据的绑定关系，相同类型的控件和业务数据才可以绑定。

第三步，点“设置”按钮，进入表单字段与接口数据源的关系绑定页面

如果接口正确调用，可以在“第三方接口字段”中选择到业务数据字段名称。

如果表单上增加了相同类型的控件，可以在右边“审批模板表单字段”中选择到对应的控件，与第三方接口字段绑定。

注意：如果下拉框为空，要去表单页面检查，增加的表单控件是否类型不符。

2.4业务详情

在工作流审批过程中，审批人要查看业务单据，需要设置单据详情

步骤

1，在表单设计的业务表单数据的最下方，拖拉一个“说明文字”控件进来

2，修改右侧“说明文字”的内容为“单据详情”

3，“链接跳转地址”选中，并加入所有单据通用查看地址

https://wy.wojiacloud.com/workFlow/flowDetail

（     注意，链接跳转地址是指回我家云的业务单据查看地址，必须设置，且不能做任何修改，所有接口通用）

4，“开发者选项设置”选中“携带云之家身份信息及表单相关ID信息”

5，完成上述设置，就可以在审批过程中查看单据详情数据了

特别说明：新版的工作流是默认看不到说明文字的业务详情的，需要在每个需要显示的流程节点上设置可见业务详情。

步骤如下：

1，在节点上打开节点字段权限设置

2，在节点权限设置中找到“说明文字”，选择后，可以在当前节点显示业务详情链接。如果在每个环节都可见，需要在每个节点重复设置

2.5过程设计

在过程设计中，可以拖拉左上角的“审批”到面板中，进行流程的节点设计。

在节点连接线上单击，可以进行条件设置

双击任一流程节点，可以进行流程节点设置

单击审批人位置，可以打开“审批人设置”标签，也会出现在“审批节点设置”TAB标签旁边

特别说明：工作流默认不可终止，如果需要打回或终止操作，需要按如下操作。

1，  在每个流程节点中，右侧的“操作开关”区域，选择“允许退回”，在流程实际进行中的时候，当前节点可以退回到任一节点。

2，  选择“不同意”，在流程实际进行中时，可以选择不同意，随时在任一节点，终止当前流程。

2.6回调设置

流程设置完成表单和过程设计后，最重要的一步就是设置回调接口。正确设置回调接口，才能回写单据，保证业务数据的完整性。

第一步，鼠标移动到流程最后一个节点“完成审批”，右上角浮现两个按钮，选择设置按钮，打开设置页面

第二步，在开发者选项后面，“点击设置”

第三步，选择“添加外部接口”

第四步，在弹出层中设置回调信息

接口名称：接口回调

外部接口地址：https://wy.wojiacloud.com/workFlow/flowNotify

（注意，外部接口地址是指回我家云的回调地址，必须设置，且不能做任何修改，所有接口通用）

第五步，单击右上角的“发布”按钮，保存所做修改。

特别说明：新版的工作流设置回调接口，需要根据业务进行分别设置。

正常流程结束的设置如下：在上面第四步，添加外部接口时，要选择接口执行时机为“节点到达后”。

如果流程节点有设置有“不同意”的操作开关，需要额外增加一个回调接口，地址如第四步相同，但是接口操作时机选择为“节点不同意后”。

最终结果页面如下

如果没有根据业务设置对应接口，将会导致对应操作不会有正确回调。

3模板设置

3.1云之家开发者信息获取

第一步，鼠标移动到流程开始节点“开始审批”，右上角浮现出设置按钮，打开设置页面

第二步，开发者选项，“点击设置”

第三步，拷贝开发者内容，填入我家云（审批appID,开发者secret,开发者key）

3.2我家云模板应用管理

打开我家云系统

新增“云之家审批”类型的应用，把上图的appId,appSecret,appKey正确填入即可在业务中使用云之家智能审批。

4 业务使用

当管理员严格按照“模板分类说明”和“模板表单说明”，配置好模板后，业务人员可以进行工作流的调用

4.1选择模板

业务人员要业务中发起工作流审批时，首先会根据业务对应的模板分类，筛选出当前分类下的工作流模板，供业务人员选择。

如当前分类只有一个模板，则跳过此步，直接展示内容。

4.1发起流程

业务人员选择模板后，系统会自动进行表单数据充填，展示工作流表单数据，并根据表单数据进行后续工作流路由的选择跳转

发起流程后，后续节点的审批人，可以在我家云“消息中心”--“待办通知”中查看并处理工作流。

5 模板分类说明

说明：模板分类请严格按照下表，在工作流模板中定义，业务代码根据这些分类进行模板过滤。如定义不正确，会导致模板列表获取失败。

6 模板表单说明

说明：表单字段与模板分类是紧密联系的，每个模板分类只会在业务中显示表单字段范围内的值。

在基础控件模式下，表单字段必须下与下表相同，不能修改。

在互联控件模式下，下表表单字段就是外部接口提供的选择范围。

颜色标注：单行文本框，数字输入框，金额输入框

7 模板接口说明

互联控件的所有外部数据源定义