任務進度
「任務進度」是「進度」元件的預先定義組態。「任務進度」是顯示任務進度資訊的小器具;它專為顯示變更請求任務的進度而設計。其中包含進度列、已完成任務的總成員數,以及成員投票的摘要。
以下是顯示任務進度預先定義組態的範例圖像:
繫結內容
| 對於任務進度,輸入繫結內容支援 PTC.Workflow.WorkItem 物件類型。 |
組態內容
範例組態
{
"progressBarMessage":{
"version":"1.0.0",
"value":"[[PTC.Nav.TaskProgress.ProgressBarMessage]]"
},
"title":{
"version":"1.0.0",
"value":"[[PTC.Nav.TaskProgress.Title]]"
},
"baseConfigurationVersion": {
"value": "nav.1"
},
"implementationConfigurationVersion": {
"value": "nav.1"
}
}
自訂服務
除組態以外,每個元件還支援延伸其企業邏輯以自訂元件。每個元件的企業邏輯包括物範本中可以進行延伸與取代的置換服務。此元件的置換服務會在下表中詳細說明:
如需每個服務的傳回結果與參數範例,請參閱
自訂服務的輸入/輸出範例。
名稱 | 描述 |
---|
CalculateProgress | 計算並傳回進度資料。其邏輯如下: 1. 針對指定的 WorkItem ID,會從後端系統擷取 UserEventList 屬性的值。 2. 針對指定的 WorkItem ID,會從後端系統擷取所有參與者 workitems 的 WorkItemRoutingChoices 與 Status 屬性。參與者 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"
}
]
}