Actions4
- 多维表格 Actions
- 授权 Actions
Overview
This node, named "Feishu Publish Node," is designed to interact with a multi-dimensional table service (referred to as 多维表格). Specifically, the "保存记录" (Save Record) operation allows users to create or update records in a specified multi-dimensional table. If a record ID is provided, the node updates that existing record; if not, it creates a new one.
Common scenarios for this node include:
- Automating data entry into multi-dimensional tables from other systems.
- Synchronizing external data sources with a multi-dimensional table.
- Updating specific records based on dynamic inputs during workflow execution.
For example, a user might use this node to save customer information collected from a form directly into a multi-dimensional table, either adding new customers or updating existing ones based on their unique record IDs.
Properties
Name | Meaning |
---|---|
AccessToken | A string token used for authentication (optional depending on resource). |
多维表格 Token | The unique identifier token of the multi-dimensional table app. |
多维表格 ID | The unique identifier of the multi-dimensional table within the app. |
记录 ID | The unique identifier of a record in the table. If empty, a new record will be created; otherwise, the existing record will be updated. |
用户 ID 类型 | The type of user ID used; options are: Open ID, Union ID, User ID. |
是否忽略一致性读写检查 | Boolean flag indicating whether to ignore consistency read-write checks. Defaults to true. |
请求体JSON | JSON object representing the request body. It contains fields to be saved or updated in the record. Special handling for images by converting them to file URLs and uploading automatically. |
Output
The node outputs an array of JSON objects representing the results of the save record operations. Each output item corresponds to an input item processed and contains the response data from the multi-dimensional table API after saving or updating the record.
If any errors occur during processing, they are included in the output JSON under an error
field when "continue on fail" is enabled.
No binary data output is indicated in the source code or properties.
Dependencies
- Requires access to the multi-dimensional table service via its API.
- Needs a valid multi-dimensional table App token (
多维表格 Token
) and table ID. - May require an API authentication token (
AccessToken
) depending on the resource configuration. - The node uses an internal resource factory to resolve the correct API call function based on resource and operation parameters.
- The request body must follow the multi-dimensional table API specification, especially for special fields like images.
Troubleshooting
- Error: 未实现方法 (Unimplemented method) — This error occurs if the requested resource-operation combination is not implemented in the node. Ensure you select a supported resource and operation.
- API Authentication Errors — If the provided tokens are invalid or missing, the API calls will fail. Verify that the
多维表格 Token
,多维表格 ID
, and optionallyAccessToken
are correctly set. - Invalid JSON in 请求体JSON — The request body must be valid JSON and conform to the expected schema. Invalid JSON or incorrect field formats may cause API errors.
- Record ID Issues — Providing an incorrect or non-existent record ID when attempting to update will result in failure. To add new records, leave the record ID empty.
- Consistency Check Failures — If the consistency check is not ignored and there are conflicts, the operation may fail. Adjust the "是否忽略一致性读写检查" property accordingly.
Links and References
- Multi-dimensional Table API Documentation (Chinese):
https://open.feishu.cn/document/server-docs/docs/bitable-v1/app-table-record/update#requestBody