跳到主要内容

工作流节点--获取单条人员(部门/组织角色)数据


节点功能: 可以从记录中的字段中或组织后台获取一条人员数据(或部门、组织角色数据),数据结构上相当于一行记录,获取后可以使用其属性值。

在一个工作表中,成员、部门、组织角色是表的一个属性字段,而组织中的人员、部门、角色也都是一种独立的数据对象,他们本身也包含很多属性信息,可以看做是系统表。

  • 一个组织人员的属性信息有:

    姓名、手机号、邮箱、部门、主部门、职位、工号、工作地点、组织角色、人员ID、直属上司、直接下属、所有下属、创建时间等 。

  • 一个组织部门的属性信息有:

    部门名称、部门负责人、上级部门、所有上级部门、直接下级部门、所有下级部门、本部门人员、本部门和子部门人员、部门ID、创建时间等。

    • 其中获取的所有上级部门和所有下级部门是部门对象数组,可以直接更新到多选的部门字段中,如果是更新文本字段,则输出为部门名称的数组。
  • 一个组织角色的属性信息有:

    角色名称、备注、角色下人员(人员数组)、组织角色ID、当前角色、创建时间等。

仅组织的超级管理员和组织账户管理员可选择“从所有组织成员、部门、组织角色”中查找人员。

场景举例

创建部门OKR任务时,根据负责人信息,自动将其部门人员加入到任务的【部分人员】的字段中。

任务表设计如下:

工作流配置思路: 根据人员(任务负责人)获取到其部门信息,这样就可以直接使用此部门下的部门成员数据。

流程设计方法

方式1

1、创建新增任务记录时触发的流程

2、通过【获取单条成员/部门/角色信息】节点来获取创建人的人员信息

选择从人员字段获取 的方式获取,即获取新建任务记录中的任务负责人的人员对象信息,这一步就能知道他所在的部门名称。

3、继续通过【获取单条成员/部门信息】获取部门对象数据

选择从组织部门中获取 的方式获取,即部门名称等于上一步获取的人员对象中的部门

4、部门信息获取后,那么部门下的成员就知晓了,然后更新增加到部门人员字段中。

5、上一步中,部门下的人员包含了负责人人,如果您不需要将创建者加入到参与人员字段中,可以将其移出。

方法2

整体思路和方法1一致,但是可以将方法1中的第2、3步进行合并。 即直接从组织部门中获取部门对象数据,条件是:部门成员包含了任务负责人。其他配置一致。如果您一开始就想到了这个方法,恭喜您,这个节点的使用基本没什么问题了。

同时获取汇报关系

获取人员数据时默认不查询其汇报关系的数据信息,如果您需要使用其上司、下属等信息,则可勾选此项。 如果不需要建议不勾选此项以提高查询效率。

TIPS

  1. 此节点获取到信息都是单条结构的一条数据,不能直接传给子流程。在本例中,获取到部门信息后,部门下会有很多成员,这就相当于一个多选字段中选择的很多人,是一个字段级别的信息,只能直接更新到一个成员字段中,而不能传给子流程。

  2. 如果您想将部门下的多个成员,分别新建到多条记录中,需要通过【获取多条人员/部门/角色】节点后,再通过子流程或批量新增节点新增到工作表中。

  3. 和获取记录一样,下面的分支支持查找结果(有无数据)分支。

  4. 从人员字段获取一个人员,如果这个人员是外协人员的话,所有的相关字段(工号、上下级等等)都返回空值。

  5. 个人信息设置成仅个人可见,或通讯录隔离,都不影响该节点返回信息。


文档问题反馈

文档中是否有错别字、内容过期、难以理解等问题? 点此给我们反馈吧