Skip to main content
Note:
  • This connector does not sync detailed employee profile information.
  • This connector can only add employees who do not belong to your current organization (identified by mobile number). Otherwise, a system busy error is returned.

​
1. Use Case

Fill in the details of an incoming employee on a YiDA form, including name, mobile number, and expected onboarding date. Once the form is submitted, the connector integrates with the Smart HR system and syncs the submitted information to Smart HR.

​
2. Procedure

​
2.1 Step 1: Create and Configure the Form

Steps:
  1. Create a regular form and name it “Incoming Employee Registration Form”.
  2. Add a Single-line text component, name it “Incoming employee name”, and mark it as required.

​
2.2 Step 2: Add and Configure the Connector

For an overview of connectors, see Integration & Automation - Connector.
  1. Add a Date component, name it “Expected onboarding date”, and mark it as required.
  2. Add a Single-line text component, name it “Incoming employee mobile number”, mark it as required, and set the component format to Mobile.
  3. Add a member component, name it “Operator”, and set the default value to Formula editing with the USER() formula.
  4. Click the Save button in the upper-right corner of the page.
Steps:
  1. On the admin backend, select the “Incoming Employee Registration Form”, click Integration & Automation in the top navigation bar, and then click Create Integration & Automation.
  2. Name the connector “Add incoming employee”, set Trigger type to “Form event trigger”, and click Confirm.
  3. Configure the form event trigger: set the trigger event to “Create success”, set data filtering to “All data”, and click Save.
  4. Select a connector app: under DingTalk official apps, select “Smart HR” and click Next.
  5. Select the action: choose the “Add incoming employee” action and click Next.
  6. Configure the action: set each value in param to “Field” and select the corresponding component in the “Incoming Employee Registration Form”, then click Save.
  7. Click the Save button in the upper-right corner of the page, then click Publish.

​
2.3 Step 3: Submit the “Incoming Employee Registration Form”

After completing the previous two steps, you have designed the “Incoming Employee Registration Form” and configured the connector. Now, simply submit the form to trigger the connector and add the incoming employee to Smart HR.

​
3. Results

Desktop: Navigation path: DingTalk desktop client >> Workbench >> Smart HR >> HR >> Employee Relations >> Onboarding Management. Mobile: The incoming employee receives a message notification from the DingTalk Assistant prompting them to fill out the onboarding registration form. Tapping the message opens the onboarding application form.