飞书项目 icon

飞书项目

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

Actions75

工作项实例读写 → 新增工时登记记录

AI-generated

Overview

This node operation allows users to create new work hour records for work item instances within a specified project space. It is useful for tracking and logging the time spent on specific work items, including details such as start and end dates, whether holidays are included, and detailed work descriptions. Practical applications include project management, time tracking, and resource allocation in collaborative environments.

Use Case Examples

  1. A project manager logs the hours spent by team members on a particular task within a project space.
  2. An employee records their work hours for a specific work item to maintain accurate time tracking for billing or reporting purposes.

Properties

Name Meaning
空间 选择空间。可以从列表选择或手动输入 project_key。
工作项类型 Name or ID 空间下工作项类型，需要先选择空间。可以从列表选择或通过表达式指定ID。
工作项ID 工作项实例 ID，在工作项实例详情中获取。
工作开始日期 工作开始日期，支持日期选择器或表达式传入毫秒时间戳。
工作结束日期 工作结束日期，支持日期选择器或表达式传入毫秒时间戳。
包含节假日 是否在工时记录中包含节假日。
请求体参数 完整的请求体参数，JSON格式。
Options 附加选项，如批处理和超时设置。

Output

JSON

  • working_hour_records - 包含新增的工时登记记录的数组，记录了资源类型、资源ID、工作时间和工作描述等信息。

Dependencies

  • Requires an API key credential for authentication with the Feishu Project API.

Troubleshooting

  • Ensure the 'project_key' is correctly selected or entered; otherwise, the node will throw an error indicating the space must be selected first.
  • If the work item type or work item ID is incorrect or missing, the API call will fail, so verify these inputs carefully.
  • Timeout errors may occur if the server response is delayed beyond the specified timeout; adjust the timeout option accordingly.
  • Batching options must be configured properly to avoid overwhelming the API with too many concurrent requests.

Links

Discussion