--- title: "自定义小部件的调度" slug: "job-planningscheduling-board" updated: 2026-10-22T17:16:30Z published: 2026-10-22T17:16:30Z canonical: "support.tulip.co/job-planningscheduling-board" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # 自定义小部件的调度 To download the app, visit: [widget](https://library.tulip.co/apps/scheduling-custom-Library ## 用途 该日程安排自定义小部件是任务管理的一种创新解决方案。此日程安排小部件设计用于在 Tulip 应用内使用,可从数据库中提取任务或工作,每个任务或工作都有其独特的持续时间。 任务显示在小部件左侧,以垂直排列的列表形式呈现。通过将任务拖放至“排程”小部件右侧的资源之一,即可将任务或工作安排到时间轴上。这种分配将任务或工作与特定资源关联起来,表明该资源将在何时处理该任务或工作。 本质上,该自定义小部件通过直观的拖放功能,促进任务与资源之间的可视化关联,从而简化了任务分配流程,确保在 Tulip 界面内实现高效的管理和调度。 ![scheduling-printscreen.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/scheduling-printscreen.png) ## 设置 配置小部件时,某些参数为必填项,而其他参数为可选项并带有默认值。 为与客户系统建立连接,该小部件需要以下信息: - 客户端实例的 URL - 用于访问的认证令牌(而非登录凭据) - 如果客户端未使用默认工作区,还应提供工作区 ID。 身份验证成功后,调度小部件需要访问资源,这些资源将从列表中获取。资源可以来自变量或表查询。 调度小部件的任务基于表 ID 及其字段从 Tulip 表中获取。由于这些内容可自定义,因此若使用其他表,调度小部件将提供更大的灵活性。 “调度”小部件需设置以下参数: ### 必填参数 **资源:**这是一个文本列表,可来自表,但在本例中作为应用程序变量进行管理。**列名:**字段 ID 可在任务表级别找到,请逐一添加。 可通过以下方式找到“任务”表:![scheduling-table.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/scheduling-table%281%29.png) 字段 ID 可通过以下方式查找:![tablefield-unique-name.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/tablefield-unique-name.png) - *任务 ID* - *任务名称* - *状态列名称* - *“开始”列名称* - *结束列名称* - *持续时间列名称* - *资源列名称* **基本身份验证令牌:**点击右上角的个人资料,选择“账户设置”,在左侧面板中点击“Tulip API”,然后按照说明创建一个服务账户。**账户 URL:**例如:your-account.tulip.**co 任务表 ID:**可在表级别找到该表 ID![tableID.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/tableID.png) **计划日期:**您希望安排哪一天?这是一个日期时间字段。 ### 可选参数 **当天开始时间:**时间轴的起始时间。默认值为 06:**00当天结束时间:**时间轴的结束时间。 默认值为 21:**00 小时内的时间单位:**默认值为 10(以分钟为单位),这意味着当您在时间轴上移动任务时,可以选择例如 07:10 或 07:20……,每一步为 10 分钟。 若将其改为 30,则可选择 07:00、07:30……,每步间隔为 30**分钟。单位宽度:**单步宽度(单位为 px),通过此参数可设置小部件的宽度。 默认值为 13。资源名称宽度:资源列的宽度(单位为像素)。默认值为**220。重叠:**该小部件支持任务重叠。默认值为 false。**信息框:**这是一个弹出窗口,用于显示被裁剪的任务名称。 默认值为**false状态(仅当信息框启用时可用):**日程安排小部件支持两种固定状态:“已安排”和“未安排”。此外,它还允许定义其他状态,例如“已完成”或“已取消”。 对于自定义状态,可以指定颜色,并可设置默认行为(ShowByDefault)。根据 ShowByDefault 参数,如果该参数为“no”,小部件会自动隐藏任务;如果为“yes”,则显示任务。 自定义状态可在信息框中找到。![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28871%29.png) **突出显示当前时间段:**显示一条垂直线以指示实时进度,标明我们在时间轴上的当前位置。默认值为 false。 ## 触发器 “日程安排”小部件支持以下事件: **任务已排程:**任务被拖放到**时间轴上;任务已取消排程:**任务从时间轴上移除**;任务已移动:**任务刚**被重新排程;任务状态更新:**在使用自定义**状态**时**;任务已选中:**点击了已排程的任务 ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%28870%29.png) 除“任务被选中”和“任务状态更新”外,每个触发器都会产生以下结果: ![scheduling-widget-results.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/scheduling-widget-results.png) “任务已选中”的返回结果是该任务的 ID。例如,可用于加载记录。 ## 工作原理 它通过 API 调用从数据库中的任务表中检索任务,而资源则从小部件的参数中获取。任务显示在“排程”小部件的左侧,资源则在右侧垂直列出。每个资源都有一个每日时间轴,任务可以放置在该时间轴上。 重新加载小部件时,先前已分配的任务会自动重新出现在时间轴上。当任务与资源关联后,该任务将获得计划日期的开始和结束时间,并且仅在该特定日期的排程小部件时间轴上可见。“调度”小部件与数据库中的 CDM 任务表交互,用于记录新的日程安排、任务在时间轴上的移动或在不同资源之间的转移,以及通过双击将任务从资源的时间轴中移除(使其处于未安排状态)。这些后台进程使用内置的 fireEvent 函数运行。 有关 fireEvent 函数的更多信息,请参见[此处](https://support.tulip.co/docs/custom-widgets-overview#fire-an-event){`target=_blank`}。其他功能: - 通过将“Overlap”参数设置为true来支持任务重叠,这对于处理同一资源上的并发任务非常有用。 - 通过将“Infobox”参数设置为true来激活信息框,点击时会显示一个包含完整任务名称的小窗口,因为有时任务名称可能无法完全显示在时间轴上。 ## 如何创建服务账户 Feature rename Prior to r383, Service Accounts were called "API Tokens". [点击此处](https://support.tulip.co/r230/docs/setting-up-a-tulip-api#adding-an-api){`target=_blank`}可查看有关创建服务账户的详细信息。 ## 进一步阅读 如果您想进一步了解custom widgets ,请访问以下网站:[Custom Widgets 概述](https://support.tulip.co/docs/custom-widgets-overview){`target=_blank`}