跳到主要内容

构造器函数

模型说明

  • 标准人员模型对象
{
"corpId":"cropId",
"label":"姓名(工号)",
"avatar":"头像图片地址",
"key":"userid",
"businessWorkNo":"工作账号"
}
  • 标准部门模型对象
{ 
"label":"当前部门名称",
"key":"部门id"
}

UserBuilder

表达式

UserBuilder(["userid","userid"]  |  ${成员组件[{},{}]} )

公式描述:成员构造函数:用于生成指定userId列表或指定成员组件,对应的人员模型集合

入参

(["userid","userid"]  或 ${成员组件[{},{}]} )

返回值

[{人员对象},{人员对象}] 

示例

UserBuilder(["some_userid_123"])

// 返回
[{user1}]

DirectorBuilder

表达式

DirectorBuilder( "" | "userid",level )

公式描述:主管构造函数:用于生成当前登录人或指定某1个人的第 level 级主管,参数 level>=1;返回对应主管的人员模型集合,多部门时返回多个对应主管。

入参

  • 参数1:指定的userid,用于指定对应人员,传""则代表当前登录人
  • 参数2:level,返回第 level 级主管,level>=1 才有效

返回值

  • 主管的标准人员模型对象,[{人员对象},{人员对象}]

示例:

DirectorBuilder("",2)

// 返回
[{user1},{user2}]

DeptBuilder

表达式

DeptBuilder(无参数 | userid |单选的成员组件)

公式描述:部门构造函数:根据条件获取指定部门对象模型函数,公式不支持子表

入参

参数1(3种模式):

  • 无参数, 代表当前登录人的所在直接部门
  • 或 userid ,指定成员id的所在直接部门
  • 或 单选的成员组件,成员组件对应成员所在直接部门

返回值

  • 标准部门模型对象,[部门对象,部门对象],可以同时属于多个部门


示例

DeptBuilder("")
// 返回
[{dept},{user2}]

GetObjectField

表达式

GetObjectField(标准Json对象模型,“fieldKey”) 

公式描述:GetObjectField 一种工具函数,JsonObject是一种通用的标准对象存储格式,内部采用key:value模式结构组织数据。GetObjField用于对指定的标准json对象中获取指定key对应的value属性值'。

注:不支持在子表单中使用。

入参

  • 参数1:指定的标准JsonObject对象
  • 参数2:fieldKey,指定参数1对象的1级属性key

返回值

  • 对象属性key对应value值,默认为文本类型

示例

GetObjectField( GetArrayItem(UserBuilder(成员组件), 1) ,"label")

// 成员组件数据示例:
[{"label":"小王(工号11)","key":"userid123"},{"label":"小红(工号22)","key":"userid124"}]

// 返回

"小王(工号11)"

GetArrayItem

表达式

GetArrayItem(标准JsonArray类型,n) 

公式描述:GetArrayItem 一种工具函数,JsonArray是一种通用的标准数组集合存储格式,内部的每个单元为标准JsonObject或JsonArray。GetArrayItem用于对指定的标准JsonArray中获取第n个数据单元(可能是JsonObject或JsonArray),n>=1 , n=1时代表第1个数据单元'

入参

  • 参数1:标准JsonArray类型
  • 参数2:n,获取数组中的第n个数据单元对象

返回值

  • 参数1中的第n个数据单元,类型可能是JsonObject或JsonArray

示例

GetArrayItem(成员组件, 1)   

成员组件数据示例:

[{"label":"小王(工号11)","key":"userid123"},{"label":"小红(工号22)","key":"userid124"}]

返回

“”
{"label":"小王(工号11)","key":"userid123"}


示例:

Copyright © 2024钉钉(中国)信息技术有限公司和/或其关联公司浙ICP备18037475号-4