User

​

1. Use Cases

The user component retrieves users from DingTalk Contacts and is used whenever you need to select people, such as when setting business trip applicants, asset owners, or maintenance staff. It can also be combined with Formula, and is used on workflow forms to designate approvers—for example, when the initiator selects approvers manually.

​

2. Basic Features

​

2.1 Multiselect Mode

Select multiple users at once. Turn off this toggle when only one user should be selected. Multiselect mode

​

2.2 Default Users

Set specific users as the Default value so they appear automatically on the submission page. Set the Default value When a user’s status is standard, the default user can be cleared, and another user can be searched for and selected. When a user’s status is set to Read-only, the component does not allow selecting users; it is view-only.

​

2.3 Show Employee ID

Choose whether to display the employee ID after each user’s name. The employee ID shown here is the employee’s UserID by default. Show employee ID

​

2.4 Advanced Search Mode (New User Component)

When you use the YiDA user component on the DingTalk desktop client or in a web browser, the new advanced search feature lets you select users based on the tree structure of Contacts and drill down through the organization. The advanced user selection entry is enabled by default on the desktop client. Click it to open a dialog that provides a full user selection page.

​

2.4.1 Use Cases

• Search and select target users by drilling down through the tree hierarchy of the organizational Contacts.

​

3. Formula Combinations

There are many ways to use the component, such as automatically retrieving the initiator’s name, employee ID, or department. See the Advanced functions documentation for details.

​

3.1 Get the Current Signed-In User’s Name

See the GETUSERNAME formula.

​

3.2 Get the Current Signed-In User or Their Manager

See the USER formula.

​

4. Notes

1. The user component can select users from across the entire company, but only users from the current department are displayed by default. Use Search to select users from other departments.
2. Due to container limitations, when this component is used inside an iframe on the DingTalk mobile client, users cannot be selected because the container does not inject JSAPI into the iframe. Avoid using this component in such scenarios.

​

5. FAQ