Skip to content

人员检索节点

什么是人员检索节点?

人员检索节点是 Magic Flow 工作流中专门用于查询和筛选组织人员信息的功能节点。它允许您基于多个条件(如姓名、工号、职位、部门等)快速定位和获取人员数据,就像在企业通讯录中进行精确搜索一样。

界面说明:

人员检索节点界面主要由搜索条件设置区和输出数据结构预览区组成。上部显示各种过滤条件配置选项,包括用户名、工号、职位等筛选条件;下部显示查询结果的数据结构,包括用户基本信息和部门信息字段。 人员检索节点

为什么需要人员检索节点?

在企业工作流中,准确获取人员信息是许多自动化流程的基础需求:

  • 数据关联:将业务数据与具体负责人或团队关联
  • 权限控制:根据人员角色或部门划分信息访问权限
  • 流程流转:识别下一步流程的处理人或审批人
  • 消息通知:向特定人员或团队发送自动化通知
  • 团队协作:基于组织架构构建智能协作流程

应用场景

1. 智能审批流程

根据申请内容自动找到对应部门的审批人,精准转发审批请求,提高流程效率。

2. 部门信息汇总

快速检索特定部门的所有成员信息,用于生成部门报表、团队分析或资源分配。

3. 人员数据联动

当用户提交请求时,根据其身份自动关联其所在部门、直属上级等信息,减少人工输入。

4. 智能消息分发

根据业务规则自动找到相关负责人,将系统消息或工作提醒精准送达合适的人。

节点参数说明

搜索条件参数

参数名称说明是否必填默认值
用户名按人员真实姓名匹配
工号按人员工号匹配
职位按人员职位或职称匹配
手机号按人员手机号码匹配
部门名称按部门名称匹配
群聊名称按群聊名称匹配

条件规则说明

每个搜索条件支持以下规则类型:

规则类型说明示例
等于字段值完全等于指定值姓名等于"张三"
不等于字段值不等于指定值职位不等于"实习生"
包含字段值包含指定内容部门名称包含"技术"
不包含字段值不包含指定内容姓名不包含"测试"
为空字段值为空手机号为空
不为空字段值不为空工号不为空

值类型设置

值类型说明示例
固定值直接输入具体查询值"张三"、"研发部"
变量值引用工作流中的变量作为查询值department_name

输出内容

输出字段说明
用户数据(数组)符合条件的用户列表,每个用户包含:唯一用户 ID、真实姓名、职位名称等

使用说明

基本配置步骤

  1. 设置基本搜索条件
    1. 点击需要的搜索条件(如"用户名")
    2. 选择匹配规则(如"等于"、"包含"等)
    3. 选择值类型("固定值"或"变量值")
    4. 输入具体查询值或选择变量
  2. 添加多个搜索条件(可选):
    1. 点击"添加条件"按钮增加更多过滤条件
    2. 多个条件默认为"且"关系,即所有条件都必须满足
  3. 查看输出字段
    1. 展开"输出"部分了解查询结果数据结构
    2. 熟悉字段含义,以便在后续节点中正确引用
  4. 连接后续节点
    1. 将人员检索节点输出连接到需要人员信息的节点
    2. 使用 节点名称.userData 在后续节点中引用搜索结果

重要提示

搜索效率

当组织规模较大时,需注意搜索条件设置对效率的影响:

  • 优先使用精确条件(如工号、手机号)而非模糊条件(如姓名包含)
  • 合理组合多个条件以缩小搜索范围
  • 避免不必要的全量查询,减少系统负载

数据权限

人员检索受当前 Bot 账号权限限制:

  • 只能检索 Bot 有权限访问的部门和人员
  • 部分敏感信息(如手机号)可能需要特定权限
  • 确保 Bot 账号具有足够的组织架构访问权限

数据时效性

人员信息可能发生变化,需要注意:

  • 搜索结果反映当前时刻的组织架构状态
  • 需要有应对人员职位变动、离职等情况的策略
  • 建议在关键流程中添加结果验证逻辑

常见问题

问题 1:设置了搜索条件但未返回预期结果怎么办?

解决方案:可能是条件不匹配或权限问题,建议:

  • 检查条件值是否正确,尤其是变量引用
  • 确认比较运算符使用正确(如"等于"与"包含")
  • 尝试放宽条件或使用更精确的条件(如工号)
  • 检查 Bot 账号是否有权限访问目标人员信息

问题 2:如何处理重名情况?

解决方案:大型组织中重名现象常见:

  • 组合多个条件(如姓名+部门)进行筛选
  • 优先使用唯一标识符(如工号或用户 ID)进行搜索
  • 在结果处理时添加重名判断逻辑(如按部门区分)

问题 3:搜索结果数量是否有限制?

解决方案:是的,通常有返回数量限制:

  • 默认最多返回 50 条匹配记录
  • 对于需要查询大量用户的场景,考虑分批处理或优化搜索条件
  • 对于大范围场景如全部门查询,考虑使用更专业的报表工具

常见配对节点

节点类型配对原因
消息回复节点向用户展示检索到的人员信息
条件分支节点根据是否存在搜索结果决定后续流程
大模型调用节点利用人员信息构建个性化回复或分析
创建群聊节点根据搜索结果自动创建特定群聊
HTTP 请求节点将人员信息发送给外部系统处理

基于 Apache 2.0 许可发布