> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Smart HR

> Learn how to integrate a YiDA form with the Smart HR system to sync incoming employee information. This page walks you through creating and configuring the form, adding and configuring the connector, and submitting the form.

<Warning>
  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.
</Warning>

## 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

<Note>
  For an overview of connectors, see [Integration & Automation - Connector](/yida/integration/gqmveiswrxkgxu9s).
</Note>

3. Add a Date component, name it "Expected onboarding date", and mark it as required.

4. Add a Single-line text component, name it "Incoming employee mobile number", mark it as required, and set the component format to Mobile.

5. Add a member component, name it "Operator", and set the default value to Formula editing with the USER() formula.

6. 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.