自定义小部件的调度

Prev Next

To download the app, visit: [widget](https://library.tulip.co/apps/scheduling-custom-<span translate=)">Library

用途

该日程安排自定义小部件是任务管理的一种创新解决方案。此日程安排小部件设计用于在 Tulip 应用内使用,可从数据库中提取任务或工作,每个任务或工作都有其独特的持续时间。

任务显示在小部件左侧,以垂直排列的列表形式呈现。通过将任务拖放至“排程”小部件右侧的资源之一,即可将任务或工作安排到时间轴上。这种分配将任务或工作与特定资源关联起来,表明该资源将在何时处理该任务或工作。

本质上,该自定义小部件通过直观的拖放功能,促进任务与资源之间的可视化关联,从而简化了任务分配流程,确保在 Tulip 界面内实现高效的管理和调度。

scheduling-printscreen.png

设置

配置小部件时,某些参数为必填项,而其他参数为可选项并带有默认值。

为与客户系统建立连接,该小部件需要以下信息:

  • 客户端实例的 URL
  • 用于访问的认证令牌(而非登录凭据)
  • 如果客户端未使用默认工作区,还应提供工作区 ID。

身份验证成功后,调度小部件需要访问资源,这些资源将从列表中获取。资源可以来自变量或表查询。

调度小部件的任务基于表 ID 及其字段从 Tulip 表中获取。由于这些内容可自定义,因此若使用其他表,调度小部件将提供更大的灵活性。

“调度”小部件需设置以下参数:

必填参数

**资源:**这是一个文本列表,可来自表,但在本例中作为应用程序变量进行管理。**列名:**字段 ID 可在任务表级别找到,请逐一添加。

可通过以下方式找到“任务”表:scheduling-table.png

字段 ID 可通过以下方式查找:tablefield-unique-name.png

  • 任务 ID
  • 任务名称
  • 状态列名称
  • “开始”列名称
  • 结束列名称
  • 持续时间列名称
  • 资源列名称

**基本身份验证令牌:**点击右上角的个人资料,选择“账户设置”,在左侧面板中点击“Tulip API”,然后按照说明创建一个服务账户。**账户 URL:**例如:your-account.tulip.**co 任务表 ID:**可在表级别找到该表 IDtableID.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

**突出显示当前时间段:**显示一条垂直线以指示实时进度,标明我们在时间轴上的当前位置。默认值为 false。

触发器

“日程安排”小部件支持以下事件:

任务已排程:任务被拖放到时间轴上;任务已取消排程:任务从时间轴上移除;任务已移动:任务刚被重新排程;任务状态更新:在使用自定义状态时**;任务已选中:**点击了已排程的任务

image.png

除“任务被选中”和“任务状态更新”外,每个触发器都会产生以下结果:

scheduling-widget-results.png

“任务已选中”的返回结果是该任务的 ID。例如,可用于加载记录。

工作原理

它通过 API 调用从数据库中的任务表中检索任务,而资源则从小部件的参数中获取。任务显示在“排程”小部件的左侧,资源则在右侧垂直列出。每个资源都有一个每日时间轴,任务可以放置在该时间轴上。 重新加载小部件时,先前已分配的任务会自动重新出现在时间轴上。当任务与资源关联后,该任务将获得计划日期的开始和结束时间,并且仅在该特定日期的排程小部件时间轴上可见。“调度”小部件与数据库中的 CDM 任务表交互,用于记录新的日程安排、任务在时间轴上的移动或在不同资源之间的转移,以及通过双击将任务从资源的时间轴中移除(使其处于未安排状态)。这些后台进程使用内置的 fireEvent 函数运行。 有关 fireEvent 函数的更多信息,请参见此处{target=_blank}。其他功能:

  • 通过将“Overlap”参数设置为true来支持任务重叠,这对于处理同一资源上的并发任务非常有用。
  • 通过将“Infobox”参数设置为true来激活信息框,点击时会显示一个包含完整任务名称的小窗口,因为有时任务名称可能无法完全显示在时间轴上。

如何创建服务账户

Feature rename

Prior to r383, Service Accounts were called "API Tokens".

点击此处{target=_blank}可查看有关创建服务账户的详细信息。

进一步阅读

如果您想进一步了解custom widgets ,请访问以下网站:Custom Widgets 概述{target=_blank}