Feishu Publish Node icon

Feishu Publish Node

Feishu Publish Node

Actions4

Overview

This node, named "Feishu Publish Node," is designed to interact with the Feishu platform's multi-dimensional table (多维表格) service. Specifically, for the resource "多维表格" and operation "保存字段" (Save Fields), it allows users to batch save or update fields in a specified multi-dimensional table within Feishu.

Common scenarios where this node is beneficial include:

  • Automating the creation or updating of table schema fields in Feishu tables.
  • Managing field definitions programmatically as part of data integration workflows.
  • Synchronizing field structures between external systems and Feishu tables.

For example, a user can define multiple fields with their names, types, and extended properties, then use this node to apply those changes in bulk to a Feishu table identified by its unique ID.

Properties

Name Meaning
AccessToken A string token used for authentication; typically an API access token. Hidden when the resource is "auth".
多维表格 Token The unique identifier token of the Feishu multi-dimensional table App. Required for identifying the app context.
多维表格 ID The unique identifier of the specific multi-dimensional table within the Feishu App where fields will be saved.
字段定义方式 Method to define fields: either as individual Field objects ("Field") or as raw JSON ("JSON"). Options: field, json.
字段列表 When "字段定义方式" is set to "Field", this collection allows defining multiple fields. Each field includes:
- 字段名称 The name of the field to create or update.
- 字段类型 The type of the field. Options include: Text (文本), Number (数字), Single Select (单选), Multi Select (多选), Date (日期), Checkbox (复选框), Person (人员), Phone Number (电话号码), Hyperlink (超链接), Attachment (附件), Single Relation (单项关联), Formula (公式), Two-way Relation (双向关联), Location (地理位置), Group (群组), Creation Time (创建时间), Last Update Time (最后更新时间), Creator (创建人), Modifier (修改人), Auto Number (自动编号).
- 字段扩展属性 Extended properties for the field in JSON format. These are merged automatically. Reference: Feishu API docs
请求体JSON When "字段定义方式" is set to "JSON", this property accepts a raw JSON array describing the fields to save. This allows advanced or custom field definitions directly via JSON.

Output

The node outputs an array of JSON objects representing the result of the batch save operation for each input item processed. Each output item corresponds to one input item and contains the response from the Feishu API regarding the saved fields.

If errors occur during processing, error details are included in the output JSON under an error key for that particular item if "Continue On Fail" is enabled.

No binary data output is indicated or expected.

Dependencies

  • Requires valid authentication credentials in the form of an access token or similar API key to authorize requests to Feishu's multi-dimensional table API.
  • The node depends on Feishu's official API endpoints for managing multi-dimensional table fields.
  • Proper configuration of the Feishu App token and Table ID is necessary to target the correct resources.
  • Network connectivity to Feishu's API servers is required.

Troubleshooting

  • Common issues:

    • Invalid or expired access tokens leading to authentication failures.
    • Incorrect or missing App token or Table ID causing resource not found errors.
    • Malformed JSON in the "请求体JSON" or invalid field definitions causing API validation errors.
    • Using unsupported field types or incorrect extended properties may cause the API to reject requests.

  • Error messages:

    • "未实现方法: 多维表格.保存字段" indicates the requested resource-operation combination is not implemented or recognized by the node.
    • API errors returned from Feishu will be surfaced in the node output or as execution errors, often including HTTP status codes and descriptive messages.

  • Resolutions:

    • Verify all tokens and IDs are correct and have sufficient permissions.
    • Validate JSON syntax and field definitions against Feishu API documentation.
    • Enable "Continue On Fail" to allow partial processing and review error details per item.
    • Consult Feishu API documentation for field type constraints and extended property formats.

Links and References

Discussion