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

# Update Data Node

> Learn the two modes of the update data node in Integration & Automation—updating form data directly and updating form data by node—including steps, supported scenarios, and configuration limits.

Data nodes are a core feature of Integration & Automation. They perform different actions on the data generated by your app. This article explains how to use the update data node.

## Feature Overview

The update data node supports two update modes: **Update form data directly** and **Update form data by node**.

* Update form data directly: updates the main table or subform of a regular form based on the configured matching rules. The source table can be a regular form or a workflow form. This mode focuses on direct updates.
* Update form data by node: updates the data retrieved by a Get single record or Get multiple records node. This mode focuses on retrieving data first, then updating it.

This node is supported in both integration & automation flows and simple workflows.

## Use Scenarios

Updating form data directly has a per-update limit, but you can follow the same configuration approach as business rules to update one subform from another. Updating form data by node works the same as the original update node and can update a batch of filtered records.

The following is an example of updating form data directly:

<Tip>
  **Scenario: manage receivables and actual receipts**
</Tip>

## Steps

### Update Form Data Directly

1. Sign in to the YiDA workbench and click My Apps.

2. Select the app you need and go to the App Settings page.

3. Click Integration & Automation, select the integration & automation flow you created, and click Edit.

4. Move the cursor over the connector line of the approval node. A **+** button appears. Click **+** and select the Update Data node.

5. In the configuration panel on the right, select Update form data directly, then click to select the target table type.

6. Configure the matching rules for the data update.

<Note>
  1) Components that support matching: Single-line text, Multi-line text, Select, Dropdown select, Date, and Serial number. For the detailed mapping, see Component rule details. Other components are not supported yet.
  2) For data that meets the primary condition, up to 100 records can be matched. Records beyond 100 are not updated.
</Note>

| Update main table | Update subform |
| ----------------- | -------------- |

<Steps>
  <Step title="Configure the update rules for the data update">
    <Note>
      * Only components of the same type can assign values to each other. Supported components include Single-line text, Multi-line text, Numerical, Select, Dropdown select, Checkbox, Dropdown multi-select, Cascade select, Date, Date range, Image upload, Attachment, User, and Address. For the detailed mapping, see Update rule details. Other components are not supported yet.
      * Direct updates support up to 100 records for the main form and 50 records for the subform. Exceeding the limit causes an error and the submission fails. Sorting is not supported; records are updated in the order they are matched.
    </Note>
  </Step>

  <Step title="Configure the rule for when no data is matched. You can select Skip current node or Add a record" />

  <Step title="Click Save to complete the configuration" />
</Steps>

### Update Form Data by Node

If you select Update form data by node, you must retrieve data before this node. For details, see [Get single record](/yida/integration/svfx3gygmo5yyu6n) or Get multiple records.

1. Sign in to the YiDA workbench and click My Apps.
2. Select the app you need and go to the App Settings page.
3. Click Integration & Automation, select the integration & automation flow you created, and click Edit.
4. Move the cursor over the connector line of the approval node. A **+** button appears. Click **+** and select the Update Data node.
5. In the configuration panel on the right, select Update form data by node, then select the data to update.

<Steps>
  <Step title="Select the update rules. Select the target table fields on the left and configure the matching update rules on the right">
    <Note>
      Note: the number of records that can be updated depends on the number of records retrieved.
    </Note>
  </Step>

  <Step title="Configure the rule for when no data is matched. You can select Skip current node or Add a record" />

  <Step title="Click Save to complete the configuration" />
</Steps>

## Configuration Boundaries

### Matching Rule Details

| **Components supported for matching** | **Type**  | **Operator**                                                                                                         | **Field types that can be evaluated**                                                                    |
| ------------------------------------- | --------- | -------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| Single-line text                      | Text      | Equal to<br />Not equal to                                                                                           | Single-line text<br />Multi-line text<br />Numerical<br />Serial number                                  |
| Multi-line text                       | Text      | Equal to<br />Not equal to                                                                                           | Single-line text<br />Multi-line text<br />Numerical<br />Serial number                                  |
| Select                                | Text      | Equal to<br />Not equal to                                                                                           | Single-line text<br />Multi-line text<br />Numerical<br />Serial number<br />Select<br />Dropdown select |
| Dropdown select                       | Text      | Equal to<br />Not equal to                                                                                           | Single-line text<br />Multi-line text<br />Numerical<br />Serial number<br />Select<br />Dropdown select |
| Date                                  | Timestamp | Equal to<br />Not equal to<br />Earlier than<br />Later than<br />Not earlier than<br />Not later than               | Date                                                                                                     |
| Numerical                             | Number    | Equal to<br />Not equal to<br />Greater than<br />Greater than or equal to<br />Less than<br />Less than or equal to | Single-line text<br />Multi-line text<br />Numerical<br />Serial number                                  |
| Serial number                         | Text      | Equal to<br />Not equal to                                                                                           | Single-line text<br />Multi-line text<br />Numerical<br />Serial number                                  |

### Update Rule Details

| **Target component (assigned value)** | **Source component/formula**                         |
| ------------------------------------- | ---------------------------------------------------- |
| Single-line text                      | Single-line text                                     |
| Multi-line text                       | Multi-line text                                      |
| Numerical                             | Single-line text<br />Multi-line text<br />Numerical |
| Select                                | Select<br />Dropdown select                          |
| Dropdown select                       | Select<br />Dropdown select                          |
| Checkbox                              | Checkbox                                             |
| Dropdown multi-select                 | Dropdown multi-select                                |
| Cascade select                        | Cascade select                                       |
| Date                                  | Date                                                 |
| Date range                            | Date range                                           |
| Image upload                          | Image upload                                         |
| Attachment                            | Attachment                                           |
| User                                  | User                                                 |
| Address                               | Address                                              |

> ⚠️Note: The three fields Last approver, Last approval time, and Last approval comment are generated only during manual approval. They are not generated when the system executes automatically.

## FAQ

**Q: How do I interpret the parameters on the left and right sides of the update rules?**

A: The left side is the target table field to update. The right side is the matched source field.
