任務進度
「任務進度」是「進度」元件的預先定義組態。「任務進度」是顯示任務進度資訊的小器具;它專為顯示變更請求任務的進度而設計。其中包含進度列、已完成任務的總成員數,以及成員投票的摘要。
以下是顯示任務進度預先定義組態的範例圖像:
繫結內容 
如需有關繫結任務進度的資訊,請參閱進度元件。
* 
對於任務進度,輸入繫結內容支援 PTC.Workflow.WorkItem 物件類型。
組態內容 
如需有關配置任務進度的資訊,請參閱進度元件。
範例組態 
{
"progressBarMessage":{
"version":"1.0.0",
"value":"[[PTC.Nav.TaskProgress.ProgressBarMessage]]"
},
"title":{
"version":"1.0.0",
"value":"[[PTC.Nav.TaskProgress.Title]]"
}
}
自訂服務 
除組態以外,每個元件還支援延伸其企業邏輯以自訂元件。每個元件的企業邏輯包括物範本中可以進行延伸與取代的置換服務。此元件的置換服務會在下表中詳細說明:
如需每個服務的傳回結果與參數範例,請參閱自訂服務的輸入/輸出範例
名稱
描述
CalculateProgress
計算並傳回進度資料。其邏輯如下:
1. 針對指定的 WorkItem ID,會從後端系統擷取 UserEventList 屬性的值。
2. 針對指定的 WorkItem ID,會從後端系統擷取所有參與者 workitemsWorkItemRoutingChoicesStatus 屬性。參與者 workitems 是指參與了此工作項目所屬活動之使用者的任務。
3. 使用擷取的值,可建構 CCO 格式的 JSON,其中包含下列資訊:
a. 路由選擇的清單,且針對每一項,透過選擇它來完成的任務數。待處理的任務也包括在內。待處理任務的狀況為 Potential
b. 每個路由選擇的下列中繼資料資訊:
a. label (必要) -
在使用者介面中顯示為路由選擇名稱的字串
b. icon (選用) -
顯示在路由選擇名稱旁邊之圖示的 ThingWorx 媒體實體路徑
c. isVisible (選用) -
決定路由選擇是否顯示在使用者介面中的布林值。即使設定為 false,路由選擇的值仍用於計算。在「任務進度」中,如果存在沒有任務選擇的任何路由選擇,這些路由選擇會將此金鑰設定為 false。待處理任務始終會將此金鑰設定為 true
d. ordinal (選用) -
此金鑰決定了使用者介面中類別的排序。如果未指定序數,則不會保證類別的排序。
e. step (必要) -
指示此路由選擇的任務是否已完成的數字。
0 表示任務尚未開始
1 表示任務已完成
進度元件僅支援值 0 與 1。在「任務進度」中,待處理是值為 0 的唯一路由選擇。
參數:
input (必要) - CCO 格式的 JSON,其中包括要從後端系統擷取之資料的輸入 ID,以及後端系統的轉接器資訊。
configuration (選用) - 包含從「調整管理員」資源取得之最終合併組態的 JSON。
傳回:JSON
實行定義 
{
"array": [
{
"value": {
"initializationData": {
"properties": {},
"constraints": {}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.TextBox"
},
"mandatory": false,
"key": "title"
},
{
"value": {
"initializationData": {
"properties": {},
"constraints": {}
},
"elementVersion": "1.0.0",
"elementName": "PTC.Nav.DynamicForm.TextBox"
},
"mandatory": false,
"key": "progressBarMessage"
}
]
}
這是否有幫助?