飞书项目 icon

飞书项目

飞书项目管理 API 集成，支持工作项、空间、用户、工作流等完整功能

Actions75

工作项配置 → 获取字段信息

AI-generated

Overview

This node operation fetches field information for a specified work item type within a selected project space in Feishu. It is useful for users who need to retrieve metadata about the fields available in a work item type, such as field names, types, and whether they are required. This can help in dynamically building forms, validating input data, or integrating with other systems that require knowledge of the work item structure.

Use Case Examples

  1. A project manager wants to automate the creation of work items and needs to know which fields are mandatory and their types.
  2. A developer is building a custom integration and needs to fetch field metadata to map data correctly between systems.

Properties

Name Meaning
空间 The project space to select, either from a list or by manually entering the project_key. This determines the scope of the work item types and fields to query.
工作项类型 Name or ID The specific work item type within the selected project space for which to retrieve field information. This is selected from a dynamically loaded list of work item types.
Options Additional options to control batching and timeout behavior for the API requests.

Output

JSON

  • id - The unique identifier of the field.
  • displayName - The display name of the field, including indication if the field is required.
  • defaultMatch - Indicates if the field is a default match (boolean).
  • required - Indicates if the field is required (boolean).
  • display - Indicates if the field should be displayed (boolean).
  • type - The data type of the field mapped to n8n types (e.g., string, options).
  • options - If the field is of type options, this contains the selectable options.
  • defaultValue - The default value of the field, if any.

Dependencies

  • Feishu API with appropriate credentials

Troubleshooting

  • Ensure the project_key and work_item_type_key are correctly selected or input; missing or incorrect values will cause errors.
  • If the API request times out, consider increasing the timeout option or checking network connectivity.
  • If batching is enabled, ensure batch size and interval are set appropriately to avoid rate limiting or server errors.

Links

Discussion