统计、列表与任务交互示例

指标卡

指标卡控件可展示数据源中的数字类型字段的值。

需求：

• UX中的【指标卡】控件可以展示【我的任务】和【待认领的任务】的数量

• 无需区分工作流元素，统计所有工作流的数量

  

.task_status 等于 InProgress
且	(
.assignee.system_user.user_id 等于 global spacenbjoip::current_user_id
或
.assignee.system_group.user.user_id 等于 global spacenbjoip::current_user_id
)

.task_status 等于 InProgress
且	
.assignee 为空
(
.candidate.system_user.user_id 等于 global spacenbjoip::current_user_id
或
.candidate.system_group.user.user_id 等于 global spacenbjoip::current_user_id
)

from deepfos.lib.deepux import Struct, Integer, as_datasource
from deepfos.element.workflow import WorkFlow
import pandas as pd

class Data(Struct):
    my_task_num: Integer
    claim_task_num: Integer

@as_datasource(struct=Data)

def main(p1, p2):
    # 指定任意一个存在的工作流元素编码
    flow = WorkFlow('budget_Status_MultiSubprocess')

    # 我的任务（不分工作流元素，返回所有我的任务）
    my_task = flow.list_my_task(status=None, as_dataframe=False)
    my_task_num = len(my_task)

    # 待认领的任务（不分工作流元素，返回所有待认领的任务）
    claim_task = flow.list_claim_task(as_dataframe=False)
    claim_task_num = len(claim_task)

    df = pd.DataFrame({
        'my_task_num': [my_task_num],
        'claim_task_num': [claim_task_num],
    })
    return df

清单表：超时任务催办

需求：

指标卡提示已超时的任务，点击可查看所有超时的任务列表，可对单条任务的负责人发送催办提醒。

前提：

1. 注册DeepModel组件

2. 工作流组件部署的环境变量 EXPORT_DATASOURCE_MODE=MODEL

3. 工作流的任务节点，配置了【到期策略】，需要用这里的【到期时间】判断任务是否超时，详见工作流对应节点的使用手册

历史 Demo 地址（位于独立测试应用，需相应权限）：

配置步骤：

1. 配置工作流，用于发送通知，举例：

   

2. 配置指标卡，用于统计超时任务数量，关联的数据源可用【对象分析查询】，详见本文中【指标卡】章节，配置参考：

   

3. 配置清单表，用于展示超时任务的列表

   1. 清单表可以配置在弹窗中

   2. 关联的数据源可直接用【对象-DFTask】，过滤条件（过滤出超时的）：

      

   3. 操作列添加行按钮【催办】，配置事件：【点击】时【发起流程】，用于发送通知

      

4. 指标卡配置事件：【点击】时【打开弹窗】

效果展示：

思路拓展

其他类似的指标卡结合清单表的场景，都同理，只是数据源需要重新配置。

清单表：流程实例清单

需求：

自定义流程实例列表，可点击行以查看流程详情，详情包含流程记录和流程图。

前提：

1. 注册DeepModel组件

2. 工作流组件部署的环境变量 EXPORT_DATASOURCE_MODE=MODEL

配置步骤：

1. 进入deep_model_console，添加工作流对象组

   

2. 新建UX页面，用来展示【流程实例详情】：

   1. 选择空白模板

   2. 在【页面变量】中添加外部变量 proc_id，来源选择【外部】，数据类型为 string，保存 UX。

   3. 添加【流程记录】、【流程图】控件，控件中的【流程实例 ID】选择【UX变量 → proc_id】。

      

3. 新建UX页面，用来展示【流程实例列表】：

   1. 可选择模板【基于业务模型/对象】-【清单表（上下）】

   2. 数据源选择对象DFProcess

      

   3. 按需配置查询区域

      

   4. 按需优化过滤条件

      

   5. 添加操作列按钮，用来跳转【流程实例详情】页面

      

   6. 按钮事件配置【跳转内部页面】，选择已保存的【流程实例详情】页面，为外部变量 proc_id 对应的跳转参数赋当前行的 proc_inst_id。变量编码须与详情页一致，不能把任务 ID 传给流程实例 ID。

      

效果展示：

思路拓展

结合清单表控件其他功能、UX中其他控件（例如边栏布局、对象数据选择器等），丰富并优化流程实例列表。

任务处理：完成任务前二次确认

业务场景：

填报表单后，提交，在提交前二次确认，防止用户未保存/计算表单。

核心配置：

在任务处理控件的完成任务前节点添加动作【二次确认弹窗】

效果：

此处为语雀卡片，点击链接查看

任务处理：用户连续处理同一流程的多个任务

业务场景：

流程中的前后两个节点都是同一个用户进行处理，需要在处理完上一个任务后，刷新到下一个任务的处理页面。

核心配置：

1. UX 的【任务处理】控件中，启用任务实例为空时的后备查询，按场景选择【基于流程实例查询】或【基于业务键查询】。详见 办理任务与回传。

2. 如果【基于流程实例查询】，先声明字符串类型的外部变量 proc_id，工作流任务节点的待办跳转参数配置 proc_id = wfp$proc_id，UX 中选择该变量（$var.proc_id）。

3. 如果【基于业务键查询】，先声明外部变量 businessKey 并传入实际业务键，UX 的业务键配置项选择 $var.businessKey，同时选择对应工作流。

4. 基于这两种方式查询，可能查出多个任务实例（例如同一个流程，此用户处理了多次），会优先展示时间最近、且进行中的任务，并支持切换任务实例

Demo 配置入口：

效果：

DEMO中，两种查询方式的主要配置截图见下文。

任务处理：驳回时指定提交后的审批路径

业务场景：

例如审批流程为A->B->C->D，D驳回至A时，可以指定A重新提交后是否直接到D，无需B、C再重新审批。

核心配置：

1. D处理时，对应UX的任务处理控件中，使用完成任务所需参数传参至工作流，告知A提交后的审批路线，这个参数存在节点D的acr$extra_res变量中

2. A提交后需用排他网关判断后续是到B还是直接到D，判断条件需要用到节点D的acr$extra_res变量，因此节点D完成时，需要把acr$extra_res变量映射到全局变量中，以供排他网关使用

   

   

效果：