網域特定建構區塊 > 工作指示建構區塊 > 設定與使用工作定義執行狀況
設定與使用工作定義執行狀況
可透過執行狀態深入瞭解正在作為工作訂單一部份執行的工作定義的進度狀況。工作指示建構區塊提供一組基本的工作定義執行狀況,可供您根據企業需求進行自訂:
Planned
Running
Held
Canceled
Completed
針對預設生產訂單管理員物件 (PTC.SCA.SCO.DefaultProductionOrderManager) 提供了服務,用於建立新狀態、更新或刪除現有狀態、擷取個別狀態或擷取所有狀態之清單。工作指示建構區塊也提供了其他一些服務,用於擷取工作定義執行狀況的變更記錄檔,並提供每個狀況所花費時間的摘要。
* 
為監控製程計劃轉換的進度,工作定義轉換器服務另外提供了三個執行狀態:
Building - 製程計劃轉換仍在執行中。
BuildingSuccess - 製程計劃轉換已成功完成。
BuildingFailure - 製程計劃轉換期間發生錯誤。
請勿刪除或更新這三個狀態。
對於執行時間較長的轉換製程,您可使用 GetWorkDefinition 服務或 PostgresDatabase 查詢服務查詢根工作定義以檢視其執行狀態。
建立工作定義執行狀態
使用 CreateWorkDefinitionExecutionStatuses 服務,可透過將工作定義執行狀態新增至 WorkDefinitionExecutionStatuses 輸入參數表來建立多個工作定義執行狀態。
* 
建立工作定義執行狀況 (或屬於工作指示建構區塊資料模型一部份的任何物件) 時,系統會自動產生 UID 值。系統會略過您在 UID 欄位中輸入的任何值。
執行 CreateWorkDefinitionExecutionStatuses 服務後,系統會回傳所建立工作定義執行狀態及其 UID 的清單。
擷取工作定義執行狀態
使用 GetWorkDefinitionExecutionStatus 服務,可透過在 UID 輸入參數中輸入狀態的 UID 來擷取個別工作定義執行狀態以供檢視。
或者,也可以使用 GetWorkDefinitionExecutionStatuses 服務擷取資料庫中的所有工作定義執行狀態,包括其 UID。
更新工作定義執行狀態
可以使用 UpdateWorkDefinitionExecutionStatuses 服務來更新現有工作定義執行狀態的名稱。在 WorkDefinitionExecutionStatuses 輸入參數表中,輸入要更新的工作定義執行狀態的 UID,然後為該狀態輸入新的「名稱」值。執行服務後,系統會回傳所更新工作定義執行狀態及其 UID 的清單。
刪除工作定義執行狀態
使用 DeleteWorkDefinitionExecutionStatus 服務,可透過提供要刪除的工作定義執行狀態的 UID 來刪除之前建立的任何工作定義執行狀態。嘗試擷取已刪除 (或不存在的) 工作定義狀態時,會產生一個空白的結果表格。
* 
刪除工作定義執行狀態時,請務必小心。系統不會阻止您刪除已在使用中或已使用的工作定義執行狀態。
檢視執行狀況變更記錄檔
可以使用 GetWorkDefinitionExecutionLog 服務檢視工作定義的執行狀況變更記錄檔。在 WorkDefinitionUID 輸入參數中,輸入工作定義的 UID。回傳的結果會提供執行狀態的 UID 與名稱、狀態變更的時間戳記以及進行變更的使用者名稱。
檢視執行摘要
可以使用 GetWorkDefinitionExecutionSummary 服務檢視在工作定義的每個執行狀況下所花費的總時間摘要。在 WorkDefinitionUID 輸入參數中,輸入工作定義的 UID。欲計算在目前狀態下所花費的時間,請為 IncludeCurrentStatus 選取 True
回傳的結果會提供執行狀態的 UID 與名稱,以及該狀態所花費的總時間 (以秒為單位)。
驗證工作定義執行狀態
如果在建立或更新工作定義時指定執行狀況,則系統會驗證指定的狀況是否存在,然後才允許完成建立或更新動作。若需進一步資訊,可參閱 動作前、動作時和動作後事件分派與驗證
這是否有幫助?