Actions75
- 空间 Actions
- 工作项实例读写 Actions
- 工作项实例搜索 Actions
- 工作项配置 Actions
- 流程模板配置 Actions
- 流程与节点 Actions
- 视图 Actions
- 子任务 Actions
- 空间关联 Actions
- 评论 Actions
- 附件 Actions
- 用户 Actions
- 群组 Actions
- 度量 Actions
- 角色与人员配置 Actions
流程与节点 → 状态流转
AI-generatedOverview
This node operation "状态流转" (State Transition) under the resource "流程与节点" (Workflow and Node) is designed to manage state transitions of work items within a specified project space in Feishu Project. It allows users to specify the project space, work item type, and the specific work item ID to perform state changes by sending a JSON request body with the necessary parameters. This operation is useful for automating workflow state changes in project management scenarios, such as moving tasks through different stages or updating their statuses programmatically.
Use Case Examples
- Automatically transition a task to the next state when a certain condition is met in an automation workflow.
- Batch update the status of multiple work items in a project space to reflect progress changes.
Properties
| Name | Meaning |
|---|---|
| 空间 | 选择空间。可以从列表选择或手动输入 project_key。用于指定操作的项目空间。 |
| 工作项类型 Name or ID | 指定空间下的工作项类型，支持从列表选择或通过表达式指定。用于确定要操作的工作项类别。 |
| 工作项ID | 工作项实例的唯一ID，用于指定具体的工作项实例进行状态流转。 |
| 请求体参数 | 完整的请求体参数，JSON格式，包含状态流转所需的字段和角色拥有者信息。 |
| Options | 额外选项，包括批处理设置（并发请求数量和批次间隔）和请求超时时间。 |
Output
JSON
error- 错误信息，如果请求失败或发生异常时返回。details- 错误的详细信息，包含API返回的错误内容（如果有）。
Dependencies
- Feishu Project API credentials required for authentication.
Troubleshooting
- 常见问题包括未选择空间或工作项类型导致请求失败，确保必填参数正确填写。
- 请求体参数格式错误或缺少必要字段会导致接口调用失败，需参考官方文档正确构造JSON请求体。
- 启用批处理时，注意批次大小和间隔设置，避免请求过载或超时。
- 错误信息中包含的NodeApiError提示可能指示API调用失败，检查网络连接和API权限。
Links
- 状态流转请求体参数说明 - 官方文档中关于状态流转请求体参数的详细说明。
- 获取空间下工作项类型 - 官方文档说明如何获取指定空间下的工作项类型。