跳转至

Widget configuration（小组件配置）

The Program Scheduling widget includes several required and optional configuration settings. This section presents an overview, and the required settings are specifically marked as such.

Timeline

  • Start timestamp [REQUIRED]: Set a timestamp variable to control the beginning of the timeline axis.
  • End timestamp [REQUIRED]: Set a timestamp variable to control the end of the timeline axis.

Input data (layers)

You can use multiple layers to represent different workstreams or object types on a single timeline. For example, one layer could display project tasks while another overlays key milestones. Each layer is independently configurable.

  • Data
  • Object set [REQUIRED]: The object set that provides the tasks or events for this layer.
  • Puck type [REQUIRED]: Select the visual type for items in this layer. Options are Standard, Background, or Event. See the puck types section for a description of each type.
  • Start time property [REQUIRED]: Select a date or timestamp property to use as the start time.
  • End time property: Select a date or timestamp property to use as the end time. Event pucks do not require this property.

  • Dependency property: For standard pucks, select an array property that defines dependency relationships between tasks. Dependencies are displayed as arrows connecting related pucks on the timeline. See the dependencies section for more information.

  • Display and formatting

  • Grouping properties: Select one or more properties to organize and nest the table rows by, such as project name, team, or phase. You can configure the sort direction for each grouping property as ascending or descending.
  • Detail properties: Select properties to display in the detail card that appears when a user selects a puck.

  • Color: Select the colors to use when displaying pucks in the timeline.

    • Static: Select a single color for all pucks in this layer.
    • Dynamic: Configure conditional formatting rules to apply different colors based on property values — for example, coloring tasks by status or priority.

  • Interactions

  • Save handler action: For standard and event pucks, select an action to trigger when a user drags or resizes a puck. The action receives the updated start and end times, allowing you to write scheduling changes back to the Ontology. This action must accept as parameters:

    • Schedule object
    • Start time
    • End time

    If you would like to edit dependency arrows, you will need to add a parameter for the dependency array property.

  • Right-click menu: Configure custom context menu items that appear when a user right-clicks a puck. Each menu item can trigger an action or a Workshop event.

Interface

  • Expand groups by default: When enabled, all table groups are expanded when the widget loads. When disabled, groups start collapsed.
  • Hide arrows by default: When enabled, dependency arrows between pucks are hidden initially. Users can toggle arrow visibility at runtime.
  • Show current time indicator: Display a vertical line on the timeline representing the current date and time.

Output

  • Selected object set: A mutable output variable that captures the currently selected objects. This object set can be used by other Workshop widgets within the current module.

中文翻译

小组件配置

计划排程(Program Scheduling)小组件包含多个必需和可选的配置设置。本节提供概述，其中必需设置已特别标注。

时间轴

  • 开始时间戳 [必需]: 设置一个时间戳变量来控制时间轴起点的开始位置。
  • 结束时间戳 [必需]: 设置一个时间戳变量来控制时间轴终点的结束位置。

输入数据（图层）

您可以使用多个图层在单个时间轴上表示不同的工作流或对象类型。例如，一个图层可以显示项目任务，而另一个图层则叠加关键里程碑。每个图层均可独立配置。

  • 数据
  • 对象集(Object set) [必需]: 为该图层提供任务或事件的对象集。
  • 图钉类型(Puck type) [必需]: 选择该图层中项目的视觉类型。选项包括标准(Standard)、背景(Background)或事件(Event)。有关每种类型的说明，请参见图钉类型部分。
  • 开始时间属性(Start time property) [必需]: 选择一个日期或时间戳属性作为开始时间。
  • 结束时间属性(End time property): 选择一个日期或时间戳属性作为结束时间。事件图钉(Event puck)不需要此属性。

  • 依赖属性(Dependency property): 对于标准图钉，选择一个数组属性来定义任务之间的依赖关系。依赖关系在时间轴上显示为连接相关图钉的箭头。更多信息请参见依赖关系部分。

  • 显示与格式

  • 分组属性(Grouping properties): 选择一个或多个属性来组织和嵌套表格行，例如项目名称、团队或阶段。您可以为每个分组属性配置排序方向为升序或降序。
  • 详情属性(Detail properties): 选择在用户选择图钉时显示的详情卡片中要展示的属性。

  • 颜色: 选择在时间轴上显示图钉时使用的颜色。

    • 静态(Static): 为该图层中的所有图钉选择单一颜色。
    • 动态(Dynamic): 配置条件格式规则，根据属性值应用不同颜色——例如，按状态或优先级为任务着色。

  • 交互

  • 保存处理程序操作(Save handler action): 对于标准和事件图钉，选择在用户拖拽或调整图钉大小时触发的操作。该操作会接收更新后的开始和结束时间，使您能够将排程更改写回本体论(Ontology)。此操作必须接受以下参数：

    • 排程对象(Schedule object)
    • 开始时间(Start time)
    • 结束时间(End time)

    如果您希望编辑依赖箭头，则需要为依赖数组属性添加一个参数。

  • 右键菜单(Right-click menu): 配置当用户右键单击图钉时显示的自定义上下文菜单项。每个菜单项可以触发一个操作或一个 Workshop 事件。

界面

  • 默认展开分组(Expand groups by default): 启用后，小组件加载时所有表格分组将展开。禁用时，分组默认处于折叠状态。
  • 默认隐藏箭头(Hide arrows by default): 启用后，图钉之间的依赖箭头初始时隐藏。用户可以在运行时切换箭头的可见性。
  • 显示当前时间指示器(Show current time indicator): 在时间轴上显示一条垂直线，代表当前日期和时间。

输出

  • 选中对象集(Selected object set): 一个可变的输出变量，用于捕获当前选中的对象。该对象集可被当前模块中的其他 Workshop 小组件使用。