飞书项目 icon

飞书项目

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

Actions75

工作项实例搜索 → 获取指定的工作项列表（单空间-复杂传参）

AI-generated

Overview

This node operation allows users to search and retrieve a list of work item instances within a specified single space in Feishu Project. It supports complex parameter passing for filtering work items based on various criteria, including simple and custom composite filters. This is useful for project management scenarios where detailed and specific work item data retrieval is required, such as filtering tasks by type, status, or custom fields within a project space.

Use Case Examples

  1. Retrieve all work items of a specific type within a project space using simple filters.
  2. Use custom JSON-based composite filters to perform advanced searches on work items in a project space.
  3. Limit the number of returned work items or return all matching items with detailed field information.

Properties

Name Meaning
空间 The project space to search within, selectable from a list or manually entered project_key.
工作项类型 Name or ID The type of work item within the selected space to filter by, selectable from a list or specified by ID.
筛选类型 The type of filter to apply: simple or custom composite parameter filtering.
筛选条件逻辑关系 Logical relationship (AND/OR) between simple filter conditions.
筛选条件 A collection of simple filter conditions specifying field, operator, and value for filtering work items.
自定义筛选参数 Custom JSON filter group parameter following the SearchGroup structure for complex filtering.
需要返回的字段 Defines which fields to return in the results; can specify fields to include or exclude.
Return All Whether to return all matching results or limit the number of results.
Limit Maximum number of results to return if not returning all.
选项 Additional options such as returning workflow info, rich text details, relation field details, and request timeout.

Output

JSON

  • work_items - Array of work item instances matching the search criteria with requested fields and details.

Dependencies

  • Feishu Project API with appropriate credentials

Troubleshooting

  • Ensure the project space (project_key) is correctly selected or entered; missing or incorrect project_key will cause errors.
  • Make sure the work item type is selected and enabled; disabled or invalid types will result in no data.
  • Validate the filter parameters and JSON structure for custom filters to avoid malformed requests.
  • Check API request timeout settings if requests fail or take too long; increase timeout if necessary.
  • If errors occur, review error messages for details and enable 'continue on fail' to handle partial failures gracefully.

Links

Discussion