自訂 ThingWorx Navigate > 建立自訂任務 > 在自訂任務中使用 ThingWorx Navigate 元件 > 可用元件 > 進度
  
進度
定義與用法
「進度」元件是以圖形方式顯示進度狀況的小器具。此元件會將整體進度顯示為水平進度列，並會在進度列下方顯示有關進度的個別詳細資訊。
以下是顯示進度元件的範例圖像：
您可以透過下列方式配置進度元件：
• 定義標題
• 配置進度列下方的訊息
任務進度是適用於「進度」元件的預先定義組態。
繫結內容
輸入
屬性名稱
描述
內容類型
Input
用來識別要從後端系統擷取的資料。
範例 JSON：
{
"version":"1.0.0",
"data":[
{
"adapter":{
"thingName":"PTC.WCAdapter",
"instanceName":"windchill"
},
"itemListsData":[
{
"objectType":"PTC.Workflow.WorkItem",
"items":[
{
"id":{
"value":"OR:wt.workflow.work.WorkItem:566231"
}
}
]
}
]
}
]
}
CCO 格式的 JSON
組態內容
下表顯示用來配置此元件的 JSON 內容。
如需有關組態結構的詳細資訊，請參閱元件組態結構。
如需有關子內容的詳細資訊，請參閱子內容與容器金鑰。
屬性名稱
描述
內容類型
預設值
必要或選用
title
在元件中顯示為標題的字串。
N/A
選用
progressBarMessage
顯示在進度列下方的字串。這是指示進度的訊息，如活動所測。
在進度列訊息中顯示的預留位置是 %0 與 %1。在現成的元件中，這些值會分別被取代為待處理與已完成項目。%total 也可作為預留位置使用，將被項目總數取代。
例如，如果已完成 7 個項目的其中 5 個，有 2 個項目仍處於待處理狀態，則在使用者介面中，字串 "%1/%total 個項目已完成" 會顯示為 "5/7 個項目已完成"。使用者介面中的字串 "%0/%total 個項目待處理" 會顯示為 "2/7 個項目待處理"。請注意，無論字串為何，藍色進度列都會始終反映已完成任務的百分比。
N/A
選用
範例組態
如需進度元件的範例組態，請參閱任務進度。
自訂服務
除組態以外，每個元件還支援延伸其企業邏輯以自訂元件。每個元件的企業邏輯包括物範本中可以進行延伸與取代的置換服務。此元件的置換服務會在下表中詳細說明：
如需每個服務的傳回結果與參數範例，請參閱自訂服務的輸入/輸出範例。
名稱
描述
GetConfigurations
傳回元件實行的可用組態。
參數：無
傳回：JSON
GetImplementationLabel
傳回元件的當地語系化名稱或可用於取得當地語系化名稱的權杖。此當地語系化名稱會顯示在 Mashup Builder 使用者介面中。
參數：無
傳回：字串
CalculateProgress
計算並傳回進度資料。建立自訂實行時，請用自訂邏輯取代此服務。
如需可用於此服務的自訂邏輯範例，請參閱任務進度。
參數：
input (必要) - CCO 格式的 JSON，其中包括要從後端系統擷取之資料的輸入 ID，以及後端系統的轉接器資訊。
configuration (選用) - 包含從「調整管理員」資源取得之最終合併組態的 JSON。
傳回：JSON
實行定義
如需進度元件的實行定義，請參閱任務進度。