8.通讯录公式

829 上次更新时间:2024-10-26 11:25:17

Document

TEXTDEPT_NAM-部门名称

函数含义:取出部门字段的第一个部门名称。

函数用法:TEXTDEPT_NAME(部门字段)

函数示例:

获取表单字段「部门选择」中的部门数据,填写至文本字段中,

则可设置公式为TEXTDEPT_NAME(部门选择)。

函数返回值类型: 文本

TEXTUSER_NAME-成员名称

函数含义:取出成员字段的名称。

函数用法:TEXTUSER_NAME(成员字段)

函数示例:

获取表单字段「人员选择」中的成员数据,填写至文本字段中,

则可设置公式为TEXTUSER_NAME(成员字段)。

函数返回值类型: 文本

TEXTUSER_EMAIL-成员邮箱

函数含义:取出成员字段的邮箱。

函数用法:TEXTUSER_EMAIL(成员字段)

函数示例:

获取表单字段「人员选择」中的成员邮箱数据,返回值为成员有幸,

则可设置公式为TEXTUSER_EMAIL(成员字段)。

函数返回值类型: 文本

USERDEPT_NAME-人员所在部门名

函数含义:获取人员部所属的部门所有部门。

函数用法:USERDEPT_NAME(成员字段)

补充说明:

返回的是成员的部门而非主部门(直属部门)。

查不到返回 空字符串。

如果有多个则为多个部门名称用,链接起来 ‘技术部,运营部’。

函数示例:

获取表单字段「人员选择」中的成员所在的部门,

则可设置公式为USERDEPT_NAME(成员字段)。

函数返回值类型:文本

USER_IN_DEP-部门包含成员

函数含义:判断多个用户是否在部门中,子部门也返回true, user不限制。

函数用法:USER_IN_DEP(user1,部门控件1,部门控件2,部门控件3)

函数示例:

判断表单字段「人员选择」该成员是否销售部、市场部、研发部,

则可设置公式为USER_IN_DEP(人员选择,销售部,市场部,研发部)。

函数返回值类型:bool

USER_DIRECT_DEP-用户直属部门(主部门)

函数含义:用户的直属部门,返回用户直属部门的名称,只取成员字段的第一个成员。

函数用法:USER_DIRECT_DEP(成员字段)

注意:当成员控件中包含多个值时,只取第一个成员数据。

函数示例:

获取表单人员控件「成员」数据所在的部门数据,

则可设置公式为USER_DIRECT_DEP(成员字段)。

函数返回值类型:文本

USER_DIRECT_LEVEL_DEP-用户直属部门和上级部门

函数含义:返回用户直属部门的上级部门,1 为直属部门(主部门),2 为上一级部门。

函数用法:USER_DIRECT_LEVEL_DEP(user,1)

函数示例:

获取表单人员控件中该成员数据所在的直属部门和上级部门,

则分别设置公式为USER_DIRECT_LEVEL_DEP(成员控件,1),USER_DIRECT_LEVEL_DEP(成员控件,2)。

函数返回值类型:文本

CURRENT_USER_DEP-当前用户主部门

函数含义:获取当前用户的主部门。

函数用法:CURRENT_USER_DEP()

补充说明

获取成员空间所在主部门,若部门控件接收返回值则为部门值。

具体文本类控件接受返回值,则为具体的部门 ID。

函数示例:

获取表单人员控件中该成员数据所在的主部门(直属部门),

则可设置公式为CURRENT_USER_DEP(成员)。

函数返回值类型:文本

USER_BELONG_DEP-用户的部门

函数含义:获取成员所在的部门。

函数用法:USER_BELONG_DEP(人员控件,序号)

补充说明

获取当前实例 id,与 导出 excel 的 id 一致。注意:开始节点进行填写的时候,无法获取值。可以在流程中刷新下默认值公式即可。

序号的作用。

函数示例:

获取表单人员控件中成员数据所在的部门,

则可设置公式为USER_BELONG_DEP(人员控件,序号)。

函数返回值类型:文本

PHONE_TO_USER-手机号转成员

函数含义:获取手机号对应的成员或外部联系人。

函数用法:PHONE_TO_USER(文本控件)

函数示例:

根据表单手机号数据,获取到相应的成员,

则可设置公式为PHONE_TO_USER(文本控件)。

函数返回值类型:文本

DEP_SUBDEP_USER_COUNT-获取部门下的总人数(包含下级部门)

函数含义:获取部门下的总人数(包含下级部门)。

函数用法:DEP_SUBDEP_USER_COUNT(部门控件)

补充说明

部门控件所有成员数,包含所有子部门(带有递归)。

返回值类型 数字,如果部门控件多个部门则为多个部门所有人数相加。

函数示例:

计算表单部门选择字段中该部门包含该部门所有子部门下的总人数,

则可设置公式为DEP_SUBDEP_USER_COUNT(部门控件)。

函数返回值类型:数字

DEP_USER_COUNT-指定部门的人数(不含所有子部门)

函数含义:指定部门的人数(不含所有子部门)。

函数用法:DEP_USER_COUNT(部门控件)

函数示例:

计算表单部门选择字段中该部门的总人数,

则可设置公式为DEP_USER_COUNT(部门控件)。

函数返回值类型:数字

TEXTUSER_PHONE-成员手机号

函数含义:取出成员字段的手机号。

函数用法:TEXTUSER_PHONE(成员字段)

函数示例:获取表单字段「人员选择」中的成员手机号数据,返回值为成员手机号,则可设置公式为TEXTUSER_PHONE(成员字段)。

函数返回值类型: 文本

TEXTDPET_ID-部门的id

函数含义:取出部门字段的第一个部门ID。

函数用法:TEXTDEPT_ID(部门字段)

函数示例:设置公式TEXTDEPT_ID(部门字段),返回第一个部门ID。

函数返回值类型: 文本

USER_IN_USER-成员包含成员

函数含义:判断前一个用户控件是否在第二个控件里面。

函数用法:USER_IN_USER(用户控件,用户控件)

函数示例:设置公式USER_IN_USER(user1,user2),返回判断前一个用户控件是否在第二个控件里面。

函数返回值类型: bool

DEP_CONTAIN_USER-部门是否包含多个用户

函数含义:部门是否包含多个用户,用户在子部门也返回 true。

函数用法:DEP_CONTAIN_USER(部门控件,成员字段1,成员字段2,成员字段3)

函数示例:设置公式DEP_CONTAIN_USER(部门控件,成员字段1,成员字段2,成员字段3),返回部门是否包含多个用户。

函数返回值类型: bool

IS_EXTERNAL-是否外部联系人

函数含义:是否外部联系人,如果人员多选,或者是多个人,一个不是外部联系人就是 false。

函数用法:IS_EXTERNAL(成员字段1,成员字段2,成员字段3)

函数示例:设置公式IS_EXTERNAL(成员字段1,成员字段2,成员字段3),返回是否为外部联系人。

函数返回值类型: bool

TEXTUSER_ID-成员的userId

函数含义:获取成员控件的 userId。

函数用法:TEXTUSER_ID(人员控件)

函数示例:设置公式TEXTUSER_ID(人员控件),返回成员控件的 userId。

函数返回值类型: 文本

USER_DEP-某一用户的主部门

函数含义:获取成员控件成员的主部门。

函数用法:USER_DEP(人员控件)

注意:获取某一用户的主部门,如果是部门控件设置了该公式就为公式字段;如果是具体文本类控件,则为具体的部门 ID。

函数示例:设置公式USER_DEP(人员控件),返回成员控件成员的主部门。

函数返回值类型: 文本

CURRENT_USER_ID-当前用户id

函数含义:获取当前用户的USERID。

函数用法:CURRENT_USER_ID(人员控件)

注意:获取用户的 ID,针对于平台的。与团队无关。

函数示例:设置公式CURRENT_USER_ID(人员控件),返回当前用户的USERID。

函数返回值类型: 文本

EXTERNAL_USER_CHARGE-外部联系人的负责人

函数含义:返回外部联系人负责人。

函数用法:EXTERNAL_USER_CHARGE(人员控件)

注意:如果是内部人直接返回空字符串;如果目标字段是人员控件就转化为人员控件;如果是目标字段 文本字段就是userId。

函数示例:设置公式EXTERNAL_USER_CHARGE(人员控件),返回外部联系人负责人。

函数返回值类型: 文本

DEP_CHARGE_USER-部门负责人

函数含义:获取部门控件的负责人。

函数用法:DEP_CHARGE_USER(部门控件)

注意:如果部门负责人有多个,则会取第一个负责人。如果开启了正副职负责人,则优先选取正职负责人。用户 id 成员字段就是成员。

函数示例:设置公式DEP_CHARGE_USER(部门控件),返回负责人。

函数返回值类型: 文本

DEP_SUPERVISOR-获取部门主管

函数含义:获取部门主管。

函数用法:DEP_SUPERVISOR(部门控件,层级)

部门等级需要固定传值。当前部门:0,上级部门:1,上级的上级:2 依次类推,超过层级取团队最高级。

函数示例:设置公式DEP_SUPERVISOR(部门控件,层级),返回部门主管。

函数返回值类型: 文本

USER_EXTERNAL_PHONE-第三方字段反解析外部联系人

函数含义:根据第三方字段进行反解析外部联系人。

函数用法:USER_EXTERNAL_PHONE(手机号)

注意:根据第三方字段进行反解析,如果目标字段是人员字段直接显示人员。如果目标字段是文本则直接显示 userid。

函数示例:设置公式USER_EXTERNAL_PHONE(手机号),返回外部联系人。

函数返回值类型: 文本

USER_CHOOSE_COUNT-返回成员控件选中人数数量

函数含义:返回成员控件选中人员数量。

函数用法:USER_CHOOSE_COUNT(成员控件)

函数示例:设置公式USER_CHOOSE_COUNT(成员控件),返回选中人员数量。

函数返回值类型: 数字

DEP_CHOOSE_COUNT-返回部门控件选中人员数量

函数含义:返回部门控件选中人员数量。

函数用法:DEP_CHOOSE_COUNT(部门控件)

函数示例:设置公式DEP_CHOOSE_COUNT(部门控件),返回部门选中人员数量。

函数返回值类型: 数字

USER_IN_MEMBER_ROLE-获取部门中指定角色的人数

函数含义:获取部门中指定角色的人数。

函数用法:USER_IN_MEMBER_ROLE(部门控件,角色名称)

函数示例:设置公式USER_IN_MEMBER_ROLE(部门控件,角色名称),返回部门指定角色的人数。

函数返回值类型: 数字

USER_ROLES-返回指定用户的角色列表

函数含义:返回指定用户的角色列表。如果有多个角色则以英文逗号进行拼接。 如果控件为复选框,则可以成为选择的值。

函数用法:USER_ROLES(人员控件)

注意:入参:人员控件、手机号、userId,返回为文本 。

函数示例:设置公式USER_ROLES(人员控件),返回角色列表。

函数返回值类型: 文本

DEP_ADD_DEP-多个部门控件进行相加

函数含义:多个部门控件进行相加

函数用法:DEP_ADD_DEP(部门1,部门2,…)

注意:入参:支持部门控件,返回部门Id

函数示例:设置公式DEP_ADD_DEP(部门1,部门2,…),返回部门相加文本

函数返回值类型: 文本

DEP_REMOVE_DEP-第一个部门间去第二个部门

函数含义:第一个部门减去第二个部门。

函数用法:DEP_REMOVE_DEP(部门1,部门2)

注意:入参:支持部门控件,返回部门Id。

函数示例:设置公式DEP_REMOVE_DEP(部门1,部门2),返回部门相减文本。

函数返回值类型: 文本

EXTERNAL_TAG-获取外部联系人标签名称

函数含义:获取外部联系人标签名称。

函数用法:EXTERNAL_TAG(成员字段)

注意:入参:人员控件、手机号、userId,返回文本。

函数示例:设置公式EXTERNAL_TAG(成员字段),返回外部联系人标签名称。

函数返回值类型: 文本

DEP_DIRECT_USER-部门下所有人员(不包含子部门)

函数含义:部门下所有人员(不包含子部门)。

函数用法:DEP_DIRECT_USER(部门字段,部门字段2)

注意:获取部门底下所有的人,不包含子部门, 多个部门的人是要合并。如果是文本控件,返回数据为昵称的拼接, 张三,李四;如果为人员控件,则为具体的用户。

函数示例:设置公式DEP_DIRECT_USER(部门字段,部门字段2),返回部门下所有人员。

函数返回值类型: 文本

DEP_ALL_USER-部门下所有人员(包含子部门)

函数含义:部门下所有人员(包含子部门)。

函数用法:DEP_ALL_USER(部门字段,部门字段2)

注意:获取部门底下所有的人,不包含子部门, 多个部门的人是要合并。

如果是文本控件,返回数据为昵称的拼接, 张三,李四;如果为人员控件,则为具体的用户。

函数示例:设置公式DEP_ALL_USER(部门字段,部门字段2),返回部门下所有人员。

函数返回值类型: 文本

MEMBER_ADD_MEMBER-多个成员控件相加

函数含义:多个成员控件相加。

函数用法:MEMBER_ADD_MEMBER(成员1,成员2,…)

注意:入参:支持人员控件,返回人员Id。

函数示例:设置公式MEMBER_ADD_MEMBER(成员1,成员2,…),返回成员相加文本。

函数返回值类型: 文本

MEMBER_REMOVE_MEMBER-第一个成员控件减去第二个成员控件

函数含义:第一个成员控件减去第二个成员控件。

函数用法:MEMBER_REMOVE_MEMBER(成员1,成员2)

注意:入参:支持人员控件,返回人员Id。

函数示例:设置公式MEMBER_REMOVE_MEMBER(成员1,成员2),返回成员相减文本。

函数返回值类型: 文本