KPI 轉盤小器具 (主題化)
使用多種版面配置 (如轉盤、水平長條圖或垂直柱狀圖) 之一來顯示「關鍵效能指標」(KPI) 值。您可以套用狀態格式來反白一或多個 KPI 值目標。
 |
此小器具也可作為 ThingWorx Web 元件 SDK 程式庫中的 Web 元件使用。
|
解析
1. 小器具標籤
2. 狀態格式滑動條
3. KPI 值
4. 量測單位標籤
5. 值滑動條
小器具版面配置
除了「轉盤」版面配置外，您也可以將小器具配置為使用下列其中一種版面配置顯示 KPI 值：
「水平長條圖」
「垂直柱狀圖」
套用狀態格式
您可以將狀態格式套用至小器具，以顯示目標值圓弧。圓弧分為多個部份，每一部份都表示不同狀態或某一範圍的 KPI 值。您可以套用狀態格式規則來根據目前 KPI 值設定小器具的樣式。欲套用狀態格式，請執行下列步驟：
1. 在 Composer 中，建立根據數值範圍套用樣式定義的「狀態定義」實體。
2. 在 Mashup Builder 中，選取小器具，然後開啟「內容」面板。
3. 按一下「狀態格式」來配置 TargetFormat 內容。
4. 在「狀態格式」對話方塊中，選取「以狀態為基礎的樣式定義」。
5. 在「相依欄位」下，選取 Value。
6. 選取您在步驟 1 建立的狀態定義，然後按一下「完成」。
7. 儲存，然後檢視混搭。
在執行時間，會根據套用的樣式定義與目前值將狀態格式規則套用至小器具。下列範例顯示了狀態格式已套用至小器具的轉盤。狀態格式圓弧分為三個 KPI 值範圍。
或者，您也可以針對在狀態定義中定義的每個狀態顯示狀況圖示。此圖示預設顯示在小器具右側。您可以使用 IconPosition 內容將圖示位置設定在左側。欲設定圖示的最大大小，請使用 MaxIconSize 內容。
如需有關將狀態格式套用至小器具的詳細資訊，請參閱將狀態格式套用至小器具。
設定轉盤開始角度與結束角度
您可以使用 StartAngle 與 EndAngle 內容配置轉盤圓弧的開始與結束角度。StartAngle 內容指定滑動條圓弧的起點。這兩個內容支援 0 到 360 度之間的值。依預設，會從 6 點鐘位置以介於 45 到 315 度的順時針方向計算圓弧。您可以使用小器具的 Direction 內容變更圓弧方向。下列範例顯示開始角度設定為 90 度、結束角設定為 270 度的轉盤滑動條。
設定 KPI 值的格式
多個組態內容可讓您設定 KPI 值的格式。您可以使用 UnitOfMeasure 組態指定 KPI 值的量測單位。當使用者將游標置於 KPI 值上時，此量測單位會顯示在工具提示中。當您將 ShowUOMLabel 內容設定為 true 時，小器具會在 KPI 值旁邊顯示量測單位 (UOM)。ValueFormat 組態可讓您使用 0.000 語法設定 KPI 數值的小數格式。
小器具內容
屬性名稱 | 描述 | 基礎類型 | 預設值 | 繫結 | 當地語系化 |
|---|---|---|---|---|---|
Clicked | 當按一下小器具時會觸發的可繫結事件。 | 事件 | Y | N | |
ValueFormat | 使用「狀態定義」實體將狀態格式套用至小器具與 KPI 值。 | 狀態定義 | 0000 | Y | N |
Label | 指定小器具標籤的文字。 | STRING | 標籤 | Y | Y |
Layout | 控制用於在小器具上顯示 KPI 值的版面配置類型。選項：「轉盤」、「水平長條圖」、「垂直柱狀圖」 | STRING | 「轉盤」 | N | N |
StartAngle | 從 6 點鐘位置開始，相對於零設定轉盤上值與目標滑動條的開始角度。您可以輸入 0 到 360 之間的正角度。使用 Direction 內容可設定角度方向。 | NUMBER | 45 | N | N |
EndAngle | 從 6 點鐘位置開始，相對於零設定轉盤上值與目標滑動條的結束角度。您可以輸入 0 到 360 之間的正角度。使用 Direction 內容可設定角度方向。 | NUMBER | 315 | N | N |
Direction | 指定轉盤、垂直柱狀圖或水平長條圖上的值滑動條方向。 選項 轉盤：順時針/逆時針 水平：從左到右/從右到左 垂直：從下到上/從上到下 | STRING | 轉盤：「順時針」 水平：「從左到右」 垂直：「從下到上」 | N | N |
IconPosition | 指定 KPI 狀況圖示相對於值標籤的位置。您可以使用狀態格式指定要顯示的圖示。 | STRING | 「靠右對齊」 | Y | N |
LabelAlignment | 控制小器具標籤的對齊方式。選項：「靠左對齊」、「置中」、「靠右對齊」 | STRING | 「左」 | Y | N |
IconSize | 設定 KPI 狀況圖示的大小。選項：「小」、「中」、「大」、「超大」 | STRING | 小 | Y | N |
LabelType | 設定標籤類型。選項：「標題」、「本文」、「標籤」、「標題」、「大型標題」、「子標題」、「標題」、「大標題」 | STRING | 「標籤」 | N | N |
MinimumValue | 設定要在小器具上顯示的最小 KPI 值。 | NUMBER | 0 | Y | N |
MaximumValue | 設定要在小器具上顯示的最大 KPI 值。 | NUMBER | 100 | Y | N |
UnitOfMeasure | 指定 KPI 值的量測單位。量測單位會顯示在工具提示中。 | STRING | 「空白」 | Y | Y |
ShowUOMLabel | 在 KPI 值旁顯示量測單位。 | BOOLEAN | False | Y | N |
Value | 設定 KPI 值。 | NUMBER | 「空白」 | Y | N |
驗證內容
屬性名稱 | 描述 | 基礎類型 | 預設值 | 是否可繫結 (Y/N) | 可當地語系化 (Y/N) |
|---|---|---|---|---|---|
ValidationState | 這是設定驗證狀態的可繫結內容。您可以將此內容設定為 Undefined、Unvalidated、Valid 或 Invalid。 | STRING | Undefined | Y | N |
ValidationOutput | 擷取小器具驗證的輸出。傳回的值為 Undefined、Unvalidated、Valid 或 Invalid。 | STRING | Y | N | |
Validate | 小器具值變更時觸發的可繫結事件。將此事件繫結至服務或函數以套用驗證模式或運算式。 | 事件 | Y | N | |
CriteriaMessage | 驗證失敗時顯示的訊息。 | STRING | 「空白」 | Y | |
CriteriaMessageDetails | 顯示有關驗證失敗訊息之詳細資訊的次要訊息。 | STRING | 「空白」 | Y | Y |
ShowValidationSuccess | 驗證成功時顯示成功訊息。 | BOOLEAN | False | Y | N |
SuccessMessage | 驗證成功時顯示的訊息。 | STRING | Y | Y | |
SuccessMessageDetails | 顯示有關驗證成功訊息之詳細資訊的次要訊息。 | STRING | Y | Y | |
ValidationSuccessIcon | 選取要在驗證成功時於狀況訊息中顯示的 SVG 圖示。 | SVG 圖示的清單 | PTC Success | N | N |
ShowValidationFailure | 設定在驗證失敗時是否顯示失敗訊息。 | BOOLEAN | False | Y | N |
ValidationFailureIcon | 選取要在驗證失敗時於狀況訊息中顯示的 SVG 圖示。 | SVG 圖示的清單 | PTC error | N | N |
MinValueFailureMessage | 當 KPI 值低於在 MinimumValue 內容中所設定值時顯示的訊息。 | 文字欄位 | <MinValue> is the minimum value. | Y | Y |
MaxValueFailureMessage | 當 KPI 值高於在 MaximumValue 內容中所設定值時顯示的訊息。 | 文字欄位 | <MaxValue> is the maximum value | Y | Y |