Builder Functions

​

Model Overview

• Standard User model object

{
"corpId":"organization ID",
"label":"Name (Employee ID)",
"avatar":"Profile Photo URL",
"key":"userid",
"businessWorkNo":"Work account"
}

• Standard Department model object

{
	"label":"Current department name",
	"key":"Department ID"
}

​

UserBuilder

​

Expression

UserBuilder(["userid","userid"]  |  ${memberComponent[{},{}]} )

​

Input Parameters

(["userid","userid"]  or  ${memberComponent[{},{}]} )

​

Return Value

[{User object},{User object}]

​

Example

UserBuilder(["some_userid_123"])

// Returns
[{user1}]

​

DirectorBuilder

​

Expression

DirectorBuilder( "" | "userid", level )

​

Input Parameters

• Parameter 1: The userid that identifies the target user. Pass "" to use the current signed-in user.
• Parameter 2: level. Returns the level-th manager. Only valid when level >= 1.

​

Return Value

• Standard User model object of the manager: [{User object},{User object}]

​

Example

DirectorBuilder("",2)

// Returns
[{user1},{user2}]

​

DeptBuilder

​

Expression

DeptBuilder(no parameter | userid | single-select member component)

​

Input Parameters

• No parameter: the direct department of the current signed-in user.
• userid: the direct department of the specified user ID.
• Single-select member component: the direct department of the user referenced by that member component.

​

Return Value

• Standard Department model object: [Department object, Department object]. A user can belong to multiple departments at the same time.

​

Example

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

​

GetObjectField

​

Expression

GetObjectField(standard JSON object model, "fieldKey")

​

Input Parameters

• Parameter 1: The standard JsonObject to read from.
• Parameter 2: fieldKey. The first-level attribute key of the object in parameter 1.

​

Return Value

• The value that corresponds to the object’s attribute key. Defaults to Text type.

​

Example

GetObjectField( GetArrayItem(UserBuilder(memberComponent), 1) ,"label")

// Example member component data:
[{"label":"John (Employee ID 11)","key":"userid123"},{"label":"Mary (Employee ID 22)","key":"userid124"}]

// Returns

"John (Employee ID 11)"

​

GetArrayItem

​

Expression

GetArrayItem(standard JsonArray type, n)

​

Input Parameters

• Parameter 1: Standard JsonArray type.
• Parameter 2: n. Returns the n-th data unit object in the array.

​

Return Value

• The n-th data unit in parameter 1. The type may be JsonObject or JsonArray.

​

Example

GetArrayItem(memberComponent, 1)

​

Returns

""
{"label":"John (Employee ID 11)","key":"userid123"}