The Scheduling Gantt Chart is a Workshop widget that renders an interactive Gantt chart for scheduling or resource allocation workflows. Before setting up the widget, ensure you have configured your dynamic scheduling Ontology.

Module builders configuring a Scheduling Gantt Chart widget can:

Set title and sub-title properties for resource object rows (including icons and function backed properties).
Select actions, events, and recommendations that appear in right-click menus.
Choose a puck style and customize colors and interactions (allocation behavior, snap behavior) for pucks.

In the example below, the Scheduling Gantt Chart assigns pilots to flights.

Scheduling Gantt chart example: Assigning pilots to flights.

The image below provides an overview of the widget layout.

Schedule objects (pucks): Each schedule object is rendered as a puck on the Scheduling Gantt Chart. Users can drag and drop these pucks to update the object’s start time, end time, and/or linked resource object. Pucks are backed by two additional capabilities:
Schedule object details: Appear as a card when the cursor hovers over a puck. By default the card will show the start/end time, the status of any rules configured on the schedule object type, and a link to the object view. Builders can also add properties they would like displayed.
Right-click menu: Triggered when a user right-clicks on a puck. Builders can configure actions, events, and recommendations.
Resource object or rows: Each resource object is rendered as a row in the Scheduling Gantt Chart.
Resource object details: Appear as a card when the cursor hovers over a row. Cards display the object title, properties selected by the application builder and a link to the object view.
Search bar: The Scheduling Gantt Chart widget includes an in-widget search bar. Results will be highlighted with a yellow border as users enter search terms. Pressing the Enter key will create a new search group with the results.
Violation rules filter: The violation rules filter is used to focus on aspects of the schedule that need attention. You can toggle on/off the rules to be evaluated for their schedule and filter down to objects that are violating selected rules.
User preferences (deprecated): Users can define and save their preferred setup. Customizable options include:
Timezone: By default, all timestamps in Foundry are in UTC. This feature will handle the timezone offset for user selections.
Collapse pucks: The widget will automatically consolidate overlapping pucks into a single puck to preserve screen real-estate. This toggle allows users to turn this feature on and off.
Show time now line: Current time will be represented by a red vertical line.
Expand legend: Determine if the legend is to be expanded or collapsed by default.
Expand unscheduled: Determine if the unscheduled drawer is to expanded or collapsed by default.
Expand all nested pucks: Determine if nested pucks are to be expanded or collapsed by default.
Scroll to pucks on external selection: If enabled, when users select a schedule object outside of the widget, the timeline will scroll to the location of the selected object.
Persist row widths: Users are able to resize the width of resource object rows by dragging the row border. The width preference may be saved so that width does not reset to default when the application is reloaded.
Persist row/grouping order: Users are able to manually reorder resource object rows by dragging and dropping them. The order preference may be saved so that the order does not reset to default when the application is reloaded.
Unscheduled drawer: Schedule objects are considered unscheduled if they do not have both a start/end time and a linked resource object. If any or all of these properties are null, schedule object pucks will appear in the unscheduled drawer.
Change log: The change log keeps track of all edits a user has made to their schedule.
Review changes: This option will be displayed when using scenarios. Selecting it generates a pop-up with a summary of all Ontology edits made in the active scenario and any remaining validation rule violations. Confirm to execute the Ontology edits.

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

Timeline data¶

Start Timestamp [REQUIRED]: The beginning of the timeline.
End Timestamp [REQUIRED]: The end of the timeline.

Timeline configuration¶

Custom Display Range: Configure the time period that is displayed in the timeline when users initially open the Workshop module. Users will be able to scroll the full length of the Scheduling Gantt Chart, unless specified elsewhere.
Custom Timeline Grid Precision: Select a unit of time for Gantt chart grid lines that will override default grid lines.
Disable timeline zoom and scroll: Disable users' ability to use the timeline scroll or zoom features.
Operating Hours: Delineate ranges in the chart as "Operating/non-operating". These regions will be shaded in different colors. You can configure daily schedules, custom time ranges, or weekday-based schedules. Optionally, enable Collapse by default to collapse non-operating hours when the Gantt chart initially renders.
Timeline Date-Time Formatting: Customize the date and time formatting for the timeline at different zoom levels. You can configure format strings for minute, hour, day, week, month, quarter, and year milestones. If no format is provided, a default will be used.

Row data¶

Fixed Resource Object Set [REQUIRED]: Rendered in the interface as the rows of the Scheduling Gantt Chart widget. Each object within the set will correspond to one row.

Row configuration¶

Title Icon: Select an icon that appears alongside the title property of each row.
Row Title: Select a property to override the default row title. You can also toggle whether the row title is displayed when the property value is null.
Sub-Titles: Select one or more properties of the resource object set that will appear underneath the object title. Additionally, select an icon for each sub-title, as demonstrated in the image below.
Group-By Property: Select a property of a fixed resource object set that divides fixed resources (rows) into subgroups. The defined groups can be opened or closed via a toggle in chart. In the below example, the resources have been divided into the groups "Garden City," "Garza," and "Hoople."
Default Sorts: Allow one or more default sorts to be applied to the ordering of rows in the chart.
Right Click Menu: See triggering actions and events on a row for more information.
Action configuration: Configure actions related to resource object type. These actions can be standard Ontology create, modify, or delete actions, or a custom FoO-backed action.
Search function: Configure row-level recommendation function. This function is initiated when the user right-clicks a time in the chart where there is nothing scheduled. The placement of cursor corresponds to a specific time and resource object which can then be used as inputs to the function.
On Row Select Event: Configure Workshop events to trigger when a row is selected in the chart. For example, cause a drawer with a more detailed object view to appear.
Popover Actions: Configure actions to replace the default popover that appears when hovering over a row.

Input data (pucks)¶

Each schedule layer is configured independently within the Input Data (Pucks) section. A schedule layer represents a set of Schedule objects displayed as pucks on the Gantt chart. Each layer has its own sub-sections for data, drag-and-drop behavior, appearance, interactions, and rules.

For each schedule layer, you can select a puck style to change the visual representation. See schedule layer (puck) styling for more information on puck styles, coloring, and properties.

Data¶

Schedule Object Set [REQUIRED]: The Schedule objects to be rendered in the chart.
Linked Resource Property [REQUIRED]: The property from the Schedule object that links to the Resource object.
Start Time Property [REQUIRED]: The property from the Schedule object to use as the start time.
End Time Property [REQUIRED]: The property from the Schedule object to use as the end time.
Object set filter for unallocated pucks: An optional object filter that only applies to unallocated pucks.

Drag & drop¶

The Drag & Drop sub-section configures how pucks can be moved within the chart. See the drag-and-drop documentation for detailed setup instructions.

Allocation Behavior: Determine how the placement of pucks will occur in the Scheduling Gantt Chart. The predefined options include:
Allocate: Drag-and-drop pucks anywhere in the chart. Multiple pucks can be assigned to the same resource at the same time.
Allocate (no overlaps): Similar to Allocate, this option ensures that pucks of the same object type do not overlap. When a puck is dropped on top of another puck, the existing puck, along with everything scheduled at a later time period, will automatically shift to prevent overlaps and maintain the sequence.
Allocate (resource only): This option enables built-in support for when schedule objects can only be moved to different resources.
Allocate (time only): This option enables built-in support for when schedule objects can only be moved in time.
Simple swap: Similar to Allocate (no overlaps) with the exception that when a puck is dropped on top of another puck, the pucks will switch places with one another.
Swap with downstream: Similar to Simple swap, this option allows the selected pucks to switch places. However, in this case, all subsequent pucks assigned after the swapped pucks will also follow their respective predecessors, effectively shifting the entire sequence downstream.
Snap to previous: Pucks will automatically snap to the end of the closest existing puck on a given row.
Snap Behavior: By default, users are able to assign objects to any time on the Scheduling Gantt Chart widget, down to the specific minute. Snap behavior allows builders to set defined intervals of when objects can be assigned. Once a puck is dropped to a new placement in the chart, the puck will snap to the beginning of the closest interval.

For example, a user configuring a schedule to support doctors' appointments may determine that all assignments (appointments) need to begin on the hour (:00) or half past the hour (:30).

The Snap Interval Size should be the integer that determines the duration of each interval. In the example below, the interval is set to 8 hours.
The Start Timestamp option refers to the time at which the snap interval begins. By default, snap intervals begin at the start timestamp for the Scheduling Gantt Chart widget. When configured, this variable will override the default start and snap the puck into place at the configured time.
Save Handler Action: The action that is called when a puck is dragged and dropped or resized.
A save handler must modify the following parameters on the Schedule object. Each parameter must be marked as optional.
- Resource ID (the foreign key to the resource object)
- Start time
- End time
When configuring a save handler action, you should supply widget provided parameters as the defaults. Refer to the scheduling drag-and-drop documentation for more information.

Appearance¶

Color Config: Select the colors that will be used for all pucks in this schedule layer. You can choose from the following color options:
Static: When this is selected, all pucks will be the same color, chosen with a dropdown color picker. Statically colored pucks look like the image below.
Segmented by: The Gantt will rotate through a set of default colors to color pucks on the chart.
Conditional coloring: Configure conditional coloring rules that determine puck colors based on property values.
Puck Title: Select a property to override the default puck title.
Puck Properties: Select properties to appear directly on each puck. Properties will appear on the puck in the same order as in the widget configuration.
Popover Properties: Select properties to display when hovering over each puck. Properties will display in the same order as declared in the configuration.
Puck Sort Order: Apply a sort on pucks when they are overlapping within a layer. This does not apply to background pucks.

Interactions¶

Custom Suggestions: Select the suggestion function for your schedule object. The function results will be rendered as highlighted areas on the chart when users pick up a puck. This can be used to indicate where users can or should place pucks. When Enforce Suggestions is enabled, users can only drop pucks in highlighted regions (hold Shift to override). See suggestion functions for more information.
Drag Cursor to Create Action: Enables a drag action across the interface to create a new object for the schedulable object type. The user initiates action by holding Shift and dragging their cursor within the widget. See the drag to create documentation for more information.
Right Click Menu:
Action configuration: Configure actions related to the schedule object type. These may be standard Ontology create, modify, or delete actions, or a custom Function-on-Objects-backed action.
Search function: Configure puck-level recommendation function. This function is initiated when the user right-clicks a puck. The start/end time of the schedule object and the object itself can then be used as inputs to the function.
Events: Configure combinations of standard Workshop events that can be triggered within the widget.
Popover Actions: Configure actions that appear in tabs on the puck popover, replacing the default popover view.
Enable Cross Widget Drops: Allow users to drag objects from other widgets into this schedule layer. When enabled, configure a drop action that determines how the dropped object is processed.
On Puck Select Event: Configure Workshop events to trigger when a puck is selected in the chart.

Rules¶

Optional validation rules to apply to the schedule layer. See validation rules for more information.

:::callout{theme="note"} Background and Event puck styles do not support Rules. :::

Layout¶

The Layout section is organized into four sub-sections that control the visual presentation of the widget.

Timeline¶

Timeline Location: Places the timeline at either the top or bottom of the chart.
Display Cursor Time Flag: When toggled on, a vertical line with a flag will be rendered on the timeline corresponding to the placement of the cursor. You can configure the time display format for the flag.
Timezone: Configure the timezone used for displaying times throughout the widget. This can be set to a static value or backed by a Workshop variable to allow dynamic timezone selection.
Expand Legend: Determine if the legend is expanded or collapsed by default.

Top bar¶

Hide Header: Hides the header, including the search bar, validation rule filters, and user preferences.
Custom Header Date/Time Formatting: Configure a custom date and time format string for the header date range display.

Bottom bar¶

Hide Footer: Hides the footer, including the unscheduled drawer, change log, and review option.
Hide Unscheduled: When toggled on, the unscheduled toggle button will be hidden.
Expand Unscheduled: When toggled on, the unscheduled pucks drawer will be expanded by default.
Standard Unallocated Puck Size: By default, the size of the puck is proportional to time duration, as in the image below.

When the Standard Unallocated Puck Size is toggled on, the puck size is standardized in the unallocated area, as in the image below.

Puck display¶

Split Rows by Schedule Layer: Each schedule layer contains a sub-row on a given fixed resource. The order of schedule layers and labels are determined in the Input Data (Pucks) setting and will appear when hovering over the object. This setting is toggled off by default and is only applicable when the application is configured with multiple schedule layers.
Expand All Nested Pucks: When enabled, pucks with nested children will be expanded by default.
Collapse overlapping pucks: The widget will consolidate overlapping pucks into a single puck to preserve screen real estate.
Disable Popovers: When toggled on, popovers are disabled.

Metrics¶

The Metrics section allows you to supply custom functions to add metrics to the Gantt chart. You can configure two types of metrics:

Header Metrics: Metrics that are aligned to the time axis of the chart.
Row Metrics: Metrics that are aligned to each row within the chart.

See inline metrics for more information.

Output¶

The Scheduling Gantt Chart widget generates output variables that can be used by other Workshop widgets to enhance your application. These output variables include:

Selected Objects: An object set of objects selected in the widget.
Search Results Output: An object set of the objects returned by the most recent search/recommendation. This output will only populate if the function returns objects.
User Preferences (deprecated): A serialized string that can be used with the module interface or state saving to persist saved user preferences.

Scenarios¶

Enable Scenarios: When toggled on, allows the specification of a scenario variable that can be used in all other scenario-aware workflows. Actions made in the widget will first be written to the scenario. When toggled off, actions made in the widget will be written directly to the Ontology.
Disable Scenario: A boolean variable that controls whether scenarios are disabled. When set to true, actions are written directly to the Ontology.

中文翻译¶

排程甘特圖小工具¶

排程甘特圖(Scheduling Gantt Chart)是一個Workshop小工具，可呈現互動式甘特圖，用於排程或資源分配工作流程。在設定此小工具前，請確保您已配置好動態排程本體論(dynamic scheduling Ontology)。

配置排程甘特圖(Scheduling Gantt Chart)小工具的模組建置者可以：

設定資源物件列的標題和副標題屬性（包括圖示和函數支援的屬性）
選擇右鍵選單中顯示的操作、事件和建議
選擇圓片樣式(puck style)並自訂圓片的顏色和互動方式（分配行為、吸附行為）

在以下範例中，排程甘特圖(Scheduling Gantt Chart)將飛行員分配給航班。

排程甘特圖範例：將飛行員分配給航班。

小工具佈局¶

下圖提供了小工具佈局的概覽。

排程物件（圓片）： 每個排程物件在排程甘特圖(Scheduling Gantt Chart)上呈現為一個圓片。使用者可以拖放這些圓片來更新物件的開始時間、結束時間和/或連結的資源物件。圓片由兩個額外功能支援：
排程物件詳細資訊： 當游標懸停在圓片上時顯示為卡片。預設情況下，卡片會顯示開始/結束時間、在排程物件類型上配置的任何規則的狀態，以及物件檢視的連結。建置者也可以新增他們想要顯示的屬性。
右鍵選單： 當使用者右鍵點擊圓片時觸發。建置者可以配置操作、事件和建議。
資源物件或列： 每個資源物件在排程甘特圖(Scheduling Gantt Chart)中呈現為一行。
資源物件詳細資訊： 當游標懸停在列上時顯示為卡片。卡片顯示物件標題、應用程式建置者選擇的屬性以及物件檢視的連結。
搜尋列： 排程甘特圖(Scheduling Gantt Chart)小工具包含一個小工具內搜尋列。當使用者輸入搜尋詞時，結果會以黃色邊框高亮顯示。按下 Enter 鍵將建立一個包含結果的新搜尋群組。
違規規則篩選器： 違規規則篩選器用於聚焦於排程中需要注意的方面。您可以開啟/關閉要評估的規則，並篩選出違反所選規則的物件。
使用者偏好設定（已棄用）： 使用者可以定義並儲存他們偏好的設定。可自訂的選項包括：
時區： 預設情況下，Foundry中的所有時間戳均為UTC。此功能將處理使用者選擇的時區偏移。
摺疊圓片： 小工具會自動將重疊的圓片合併為單一圓片，以節省螢幕空間。此切換開關允許使用者開啟或關閉此功能。
顯示目前時間線： 目前時間將以紅色垂直線表示。
展開圖例： 決定圖例預設是展開還是摺疊。
展開未排程： 決定未排程抽屜預設是展開還是摺疊。
展開所有巢狀圓片： 決定巢狀圓片預設是展開還是摺疊。
外部選擇時捲動至圓片： 如果啟用，當使用者在小工具外部選擇排程物件時，時間軸將捲動到所選物件的位置。
保留列寬度： 使用者可以透過拖曳列邊框來調整資源物件列的寬度。可以儲存寬度偏好設定，以便在重新載入應用程式時寬度不會重設為預設值。
保留列/分組順序： 使用者可以透過拖放來手動重新排序資源物件列。可以儲存順序偏好設定，以便在重新載入應用程式時順序不會重設為預設值。
未排程抽屜： 如果排程物件沒有同時具備開始/結束時間和連結的資源物件，則被視為未排程。如果這些屬性中的任何一個或全部為空，排程物件圓片將出現在未排程抽屜中。
變更日誌： 變更日誌追蹤使用者對其排程所做的所有編輯。
檢閱變更： 使用情境(scenarios)時會顯示此選項。選擇它會產生一個彈出視窗，其中包含在活動情境中所做的所有本體論(Ontology)編輯的摘要以及任何剩餘的驗證規則違規。確認以執行本體論(Ontology)編輯。

小工具設定¶

排程甘特圖(Scheduling Gantt Chart)小工具包含多個必要和可選的配置設定。本節提供概述，必要設定已特別標示。

時間軸資料¶

開始時間戳 [必要]： 時間軸的開始。
結束時間戳 [必要]： 時間軸的結束。

時間軸配置¶

自訂顯示範圍： 配置使用者首次開啟Workshop模組時時間軸中顯示的時間段。除非另有指定，否則使用者將能夠捲動排程甘特圖(Scheduling Gantt Chart)的完整長度。
自訂時間軸網格精度： 選擇甘特圖網格線的時間單位，這將覆蓋預設的網格線。
停用時間軸縮放和捲動： 停用使用者使用時間軸捲動或縮放功能的能力。
營業時間： 在圖表中將範圍標示為「營業/非營業」。這些區域將以不同顏色陰影顯示。您可以配置每日排程、自訂時間範圍或基於工作日的排程。可選地，啟用預設摺疊以在甘特圖初始呈現時摺疊非營業時間。
時間軸日期時間格式： 自訂不同縮放級別的時間軸日期和時間格式。您可以配置分鐘、小時、日、週、月、季度和年里程碑的格式字串。如果未提供格式，將使用預設格式。

列資料¶

固定資源物件集 [必要]： 在介面中呈現為排程甘特圖(Scheduling Gantt Chart)小工具的列。集合中的每個物件將對應一行。

列配置¶

標題圖示： 選擇與每列標題屬性一起顯示的圖示。
列標題： 選擇一個屬性來覆蓋預設的列標題。您也可以切換當屬性值為空時是否顯示列標題。
副標題： 選擇資源物件集的一個或多個屬性，這些屬性將顯示在物件標題下方。此外，為每個副標題選擇一個圖示，如下圖所示。
分組屬性： 選擇固定資源物件集的一個屬性，該屬性將固定資源（列）劃分為子群組。定義的群組可以透過圖表中的切換開關開啟或關閉。在下面的範例中，資源已被劃分為「Garden City」、「Garza」和「Hoople」群組。
預設排序： 允許對圖表中的列順序應用一個或多個預設排序。
右鍵選單： 有關更多資訊，請參閱在列上觸發操作和事件。
操作配置： 配置與資源物件類型相關的操作。這些操作可以是標準的本體論(Ontology)建立、修改或刪除操作，也可以是自訂的基於FoO的操作。
搜尋函數： 配置列級別的建議函數。當使用者右鍵點擊圖表中沒有任何排程的時間點時，會啟動此函數。游標的位置對應於特定的時間和資源物件，然後可以將其用作函數的輸入。
列選取事件： 配置在圖表中選取列時觸發的Workshop事件。例如，使一個包含更詳細物件檢視的抽屜出現。
彈出視窗操作： 配置操作以取代懸停在列上時顯示的預設彈出視窗。

輸入資料（圓片）¶

每個排程層在輸入資料（圓片） 部分中獨立配置。排程層代表一組在甘特圖上顯示為圓片的Schedule物件。每個層都有自己的資料、拖放行為、外觀、互動和規則子部分。

對於每個排程層，您可以選擇一個圓片樣式(puck style)來更改視覺表示。有關圓片樣式、顏色和屬性的更多資訊，請參閱排程層（圓片）樣式。

資料¶

排程物件集 [必要]： 要在圖表中呈現的Schedule物件。
連結資源屬性 [必要]： Schedule物件中連結到Resource物件的屬性。
開始時間屬性 [必要]： Schedule物件中用作開始時間的屬性。
結束時間屬性 [必要]： Schedule物件中用作結束時間的屬性。
未分配圓片的物件集篩選器： 一個僅適用於未分配圓片的可選物件篩選器。

拖放¶

拖放子部分配置圓片如何在圖表中移動。有關詳細設定說明，請參閱拖放文件。

分配行為： 決定圓片在排程甘特圖(Scheduling Gantt Chart)中的放置方式。預定義選項包括：
分配： 將圓片拖放到圖表中的任何位置。多個圓片可以同時分配給同一資源。
分配（無重疊）： 與分配類似，此選項確保相同物件類型的圓片不會重疊。當一個圓片被放到另一個圓片之上時，現有的圓片以及所有在後續時間段排程的內容將自動移動以防止重疊並保持順序。
分配（僅資源）： 此選項啟用對排程物件只能移動到不同資源的內建支援。
分配（僅時間）： 此選項啟用對排程物件只能在時間上移動的內建支援。
簡單交換： 與分配（無重疊） 類似，但當一個圓片被放到另一個圓片之上時，圓片會互相交換位置。
與後續交換： 與簡單交換類似，此選項允許選取的圓片交換位置。但是，在這種情況下，分配在被交換圓片之後的所有後續圓片也將跟隨各自的前一個圓片，從而有效地將整個順序向後移動。
吸附到前一個： 圓片將自動吸附到給定行上最接近的現有圓片的末端。
吸附行為： 預設情況下，使用者可以將物件分配到排程甘特圖(Scheduling Gantt Chart)小工具上的任何時間，精確到分鐘。吸附行為允許建置者設定可以分配物件的定義間隔。一旦圓片被放到圖表中的新位置，圓片將吸附到最接近間隔的開始處。

例如，配置支援醫生預約排程的使用者可能會確定所有分配（預約）需要在整點（:00）或半點（:30）開始。

吸附間隔大小 應該是決定每個間隔持續時間的整數。在下面的範例中，間隔設定為8小時。
開始時間戳 選項指的是吸附間隔開始的時間。預設情況下，吸附間隔從排程甘特圖(Scheduling Gantt Chart)小工具的開始時間戳開始。配置後，此變數將覆蓋預設值，並將圓片吸附到配置的時間。
儲存處理程式操作： 當圓片被拖放或調整大小時呼叫的操作。
儲存處理程式必須修改Schedule物件上的以下參數。每個參數必須標記為可選。
- 資源ID（資源物件的外鍵）
- 開始時間
- 結束時間
配置儲存處理程式操作時，您應提供小工具提供的參數作為預設值。有關更多資訊，請參閱排程拖放文件。

外觀¶

顏色配置： 選擇將用於此排程層中所有圓片的顏色。您可以從以下顏色選項中選擇：
靜態： 選取此項時，所有圓片將使用相同的顏色，透過下拉顏色選擇器選擇。靜態顏色的圓片如下圖所示。
按...分段： 甘特圖將循環使用一組預設顏色來為圖表上的圓片著色。
條件著色： 配置根據屬性值決定圓片顏色的條件著色規則。
圓片標題： 選擇一個屬性來覆蓋預設的圓片標題。
圓片屬性： 選擇要直接顯示在每個圓片上的屬性。屬性將按照小工具配置中的相同順序顯示在圓片上。
彈出視窗屬性： 選擇懸停在每個圓片上時要顯示的屬性。屬性將按照配置中宣告的順序顯示。
圓片排序順序： 當圓片在層內重疊時對其應用排序。這不適用於背景圓片。

互動¶

自訂建議： 為您的排程物件選擇建議函數。當使用者拿起圓片時，函數結果將在圖表上呈現為高亮區域。這可用於指示使用者可以或應該放置圓片的位置。啟用強制執行建議時，使用者只能將圓片放在高亮區域（按住Shift可覆蓋）。有關更多資訊，請參閱建議函數。
拖曳游標以建立操作： 啟用跨介面的拖曳操作，以為可排程物件類型建立新物件。使用者透過按住Shift並在小工具內拖曳游標來啟動操作。有關更多資訊，請參閱拖曳建立文件。
右鍵選單：
操作配置： 配置與排程物件類型相關的操作。這些可能是標準的本體論(Ontology)建立、修改或刪除操作，或是自訂的基於物件函數(Function-on-Objects)的操作。
搜尋函數： 配置圓片級別的建議函數。當使用者右鍵點擊圓片時啟動此函數。排程物件的開始/結束時間和物件本身可以作為函數的輸入。
事件： 配置可以在小工具內觸發的標準Workshop事件的組合。
彈出視窗操作： 配置顯示在圓片彈出視窗標籤中的操作，取代預設的彈出視窗檢視。
啟用跨小工具拖放： 允許使用者將物件從其他小工具拖到此排程層中。啟用後，配置一個放置操作，決定如何處理拖放的物件。
圓片選取事件： 配置在圖表中選取圓片時觸發的Workshop事件。

規則¶

應用於排程層的可選驗證規則。有關更多資訊，請參閱驗證規則。

:::callout{theme="note"} 背景和事件圓片樣式不支援規則。 :::

佈局¶

佈局部分分為四個子部分，控制小工具的視覺呈現。

時間軸¶

時間軸位置： 將時間軸放置在圖表的頂部或底部。
顯示游標時間標記： 切換開啟時，時間軸上將呈現一條帶有標記的垂直線，對應於游標的位置。您可以配置標記的時間顯示格式。
時區： 配置用於在整個小工具中顯示時間的時區。這可以設定為靜態值，或由Workshop變數支援以允許動態時區選擇。
展開圖例： 決定圖例預設是展開還是摺疊。

頂部欄¶

隱藏標題： 隱藏標題，包括搜尋列、驗證規則篩選器和使用者偏好設定。
自訂標題日期/時間格式： 為標題日期範圍顯示配置自訂的日期和時間格式字串。

底部欄¶

隱藏頁尾： 隱藏頁尾，包括未排程抽屜、變更日誌和檢閱選項。
隱藏未排程： 切換開啟時，未排程切換按鈕將被隱藏。
展開未排程： 切換開啟時，未排程圓片抽屜預設將展開。
標準未分配圓片大小： 預設情況下，圓片的大小與時間持續時間成比例，如下圖所示。

當標準未分配圓片大小切換開啟時，圓片大小在未分配區域中標準化，如下圖所示。

圓片顯示¶

按排程層分割列： 每個排程層在給定的固定資源上包含一個子列。排程層的順序和標籤在輸入資料（圓片） 設定中決定，並將在懸停在物件上時顯示。此設定預設為關閉，僅在應用程式配置了多個排程層時適用。
展開所有巢狀圓片： 啟用時，具有巢狀子項目的圓片預設將展開。
摺疊重疊圓片： 小工具將重疊的圓片合併為單一圓片，以節省螢幕空間。
停用彈出視窗： 切換開啟時，彈出視窗將被停用。

指標¶

指標部分允許您提供自訂函數，以將指標新增到甘特圖中。您可以配置兩種類型的指標：

標題指標： 對齊到圖表時間軸的指標。
列指標： 對齊到圖表中每列的指標。

有關更多資訊，請參閱內聯指標。

輸出¶

排程甘特圖(Scheduling Gantt Chart)小工具會產生輸出變數，可供其他Workshop小工具使用，以增強您的應用程式。這些輸出變數包括：

選取物件： 小工具中選取的物件的物件集。
搜尋結果輸出： 最近一次搜尋/建議傳回的物件的物件集。僅當函數傳回物件時，此輸出才會填入資料。
使用者偏好設定（已棄用）： 一個序列化字串，可與模組介面或狀態儲存一起使用，以持久化儲存的使用者偏好設定。

情境¶

啟用情境： 切換開啟時，允許指定一個情境變數，該變數可用於所有其他情境感知工作流程。在小工具中執行的操作將首先寫入情境。切換關閉時，在小工具中執行的操作將直接寫入本體論(Ontology)。
停用情境： 一個布林變數，控制是否停用情境。設定為true時，操作將直接寫入本體論(Ontology)。

Scheduling Gantt Chart widget（排程甘特圖小工具）¶

Widget layout¶

Widget setup¶