Schedule layer (puck) styling（调度层（puck）样式）

Schedule layers are rendered by default as "pucks" on the Gantt chart. These pucks can represent different concepts of your workflow and be customized to create a dynamic set of visualizations.

There are three ways to customize the appearance of your schedule layer (or "pucks"):

1. Puck Style
2. Coloring
3. Properties

You can also select a Puck style to change the visual representation of the pucks in your schedule layer.

1. Puck style

Selecting a Puck style allows you to change the visual representation of pucks in your layer. Three puck styles are available for configuration:

• Standard:
• Standard styling renders a rectangular puck on your Gantt chart that can be interacted with via mouse interactions.
• Optionally, you can provide a puck height to determine the thickness of your puck. As this is backed by a Workshop variable, you can also expose this variable to end users and enable them to change the puck height on demand.

• Common uses of puck height include:

  • Using a "thin" puck to represent a status over time.
  • Using a "thin" puck to represent a less important or secondary set of information.
  • Using a "thick" puck to represent a "card" of information about the respective event.

• Background:

• Background styling renders a slightly transparent puck on your Gantt chart that cannot be interacted with via mouse interactions.
• Background pucks do not support Rules.

• Common uses of background pucks include:

  • Using a background puck to represent availability (for example: green and red color-coded).
  • Using a background puck to represent phases or statuses.
  • Using a background puck to represent preferences.

• Event:

• Event styling renders a point-in-time marker on the Gantt chart, representing a single timestamp rather than a time range.
• Event pucks do not support drag-and-drop or Rules.
• The following options are available:
  • Is global: When enabled, the event extends across all rows in the chart.
  • Always open: When enabled, event flags are always expanded.
  • Icon: Select a standard icon or a custom icon backed by a Media Reference property.

2. Coloring

You can define the color definition for each schedule layer. Options include: Static, Segmented by, and Conditional coloring.

3. Properties

For each schedule layer, you can define the properties from the ontology that will appear directly on the puck or on the popover card.

• Popover properties:
• Select properties from your schedule layer's object, its linked objects, or use a function-backed property.
• You can choose to rename or remove the display name. Property formatting is configured alongside the property configuration in Ontology Manager.

• These properties will appear on the popover card. The popover card appears when a puck is hovered-over.

• Puck properties:

• Select properties from your schedule layer's object, its linked objects, or use a function-backed property.
• You can choose to rename or remove the display name. Property formatting is configured alongside the property configuration in Ontology Manager.
• These properties will appear directly on the puck. If all selected properties cannot fit on the puck, you may need to adjust the height of your puck using the Puck styling > Standard > Variable height option described above.

---

中文翻译

---

调度层（puck）样式

默认情况下，调度层在甘特图上以"puck"形式渲染。这些 puck 可以代表工作流中的不同概念，并可通过自定义创建动态的可视化效果。

您可以通过三种方式自定义调度层（或"puck"）的外观：

1. Puck 样式（Puck Style）
2. 着色（Coloring）
3. 属性（Properties）

您还可以选择 Puck 样式 来更改调度层中 puck 的视觉呈现方式。

1. Puck 样式

选择 Puck 样式 可以更改图层中 puck 的视觉呈现方式。共有三种 puck 样式可供配置：

• 标准（Standard）：
• 标准样式在甘特图上渲染一个矩形 puck，可通过鼠标交互进行操作。
• 您可以选择提供 puck 高度来确定 puck 的厚度。由于该高度由 Workshop 变量支持，您也可以将此变量暴露给最终用户，使其能够按需调整 puck 高度。

• puck 高度的常见用途包括：

  • 使用"薄"puck 表示随时间变化的状态。
  • 使用"薄"puck 表示次要或辅助信息集。
  • 使用"厚"puck 表示相关事件的"信息卡片"。

• 背景（Background）：

• 背景样式在甘特图上渲染一个略带透明的 puck，无法通过鼠标交互进行操作。
• 背景 puck 不支持规则（Rules）。

• 背景 puck 的常见用途包括：

  • 使用背景 puck 表示可用性（例如：绿色和红色编码）。
  • 使用背景 puck 表示阶段或状态。
  • 使用背景 puck 表示偏好设置。

• 事件（Event）：

• 事件样式在甘特图上渲染一个时间点标记，表示单个时间戳而非时间范围。
• 事件 puck 不支持拖放或规则（Rules）。
• 提供以下选项：
  • 全局（Is global）： 启用后，事件将延伸至图表中的所有行。
  • 始终展开（Always open）： 启用后，事件标记始终处于展开状态。
  • 图标（Icon）： 选择标准图标或由媒体引用（Media Reference）属性支持的自定义图标。

2. 着色

您可以为每个调度层定义颜色定义。选项包括：静态（Static）、按字段分段（Segmented by） 和 条件（Conditional） 着色。

3. 属性

对于每个调度层，您可以定义本体中直接显示在 puck 上或弹出卡片中的属性。

• 弹出卡片属性（Popover properties）：
• 从调度层对象的属性、其关联对象的属性中选择，或使用函数支持的属性。
• 您可以选择重命名或移除显示名称。属性格式与本体管理器（Ontology Manager）中的属性配置一同设置。

• 这些属性将显示在弹出卡片上。当鼠标悬停在 puck 上时，弹出卡片会出现。

• Puck 属性（Puck properties）：

• 从调度层对象的属性、其关联对象的属性中选择，或使用函数支持的属性。
• 您可以选择重命名或移除显示名称。属性格式与本体管理器（Ontology Manager）中的属性配置一同设置。
• 这些属性将直接显示在 puck 上。如果所有选中的属性无法完全显示在 puck 上，您可能需要使用上述 Puck 样式 > 标准 > 可变高度（Variable height） 选项来调整 puck 的高度。