Feishu Node icon

Feishu Node

Feishu Node

Actions106

Overview

This node provides integration with the "多维表格" (a multi-dimensional table service) to perform batch updates on records within a specified table. It is useful when you need to update multiple records in one request, improving efficiency and consistency compared to updating records individually.

Common scenarios include:

  • Synchronizing data from other systems into 多维表格 tables.
  • Bulk editing or correcting multiple entries at once.
  • Automating updates triggered by workflows or external events.

For example, you might use this node to update the status of many project tasks stored in a 多维表格 table after a milestone is reached.

Properties

Name Meaning
多维表格 Token The unique identifier token for the 多维表格 App. This authenticates the request to access the app's data.
多维表格 ID The unique identifier of the 多维表格 data table where records will be updated.
用户 ID 类型 The type of user ID used in the operation. Options are: Open ID, Union ID, or User ID. This specifies how users are identified in the context of the update.
操作的唯一标识 A unique client token for the operation, used for idempotency. If empty, a new request is initiated; if provided, it ensures the update is performed idempotently (no duplicate effects).
是否忽略一致性读写检查 Boolean flag indicating whether to ignore consistency read-write checks. Defaults to true. When true, the system may skip some consistency validations to improve performance.
请求体JSON The JSON body of the request containing the batch update details. Must follow the structure defined in the official 多维表格 API documentation, typically including an array of records to update.

Output

The node outputs JSON data representing the response from the 多维表格 batch update API call. This typically includes information about the success or failure of each record update, any returned tokens for idempotency, and metadata related to the operation.

If the API supports binary data output, it would be summarized here, but based on the code and properties, the output is purely JSON structured data reflecting the batch update results.

Dependencies

  • Requires an API key credential for 多维表格 App authentication.
  • Needs network access to the 多维表格 API endpoint.
  • The node depends on the n8n workflow environment and its helper methods for execution and error handling.
  • Proper configuration of the 多维表格 Token and Table ID is necessary for successful operation.

Troubleshooting

  • Common issues:

    • Invalid or expired 多维表格 Token causing authentication failures.
    • Incorrect Table ID leading to "table not found" errors.
    • Malformed JSON in the 请求体JSON property causing request validation errors.
    • Idempotency token misuse resulting in unexpected behavior or no updates applied.

  • Error messages:

    • Errors thrown by the node include detailed messages from the API or internal exceptions.
    • If the node encounters an API error, it surfaces the error message and stack trace.
    • To resolve, verify credentials, ensure correct JSON formatting, and confirm that IDs match existing resources.
    • Use the "continue on fail" option cautiously to handle partial failures gracefully.

Links and References

Discussion