匯出與匯入追蹤
您可以追蹤實體和資料在 ThingWorx 中的匯入與匯出進度。
任務進度狀況
快取用來追蹤所提交任務的進度。任務可具有下列狀況:
狀況
描述
已登錄
已在快取中提交任務以追蹤進度。
進行中
任務目前在進行中。
成功
任務已完成且沒有任何例外。
部份成功
任務已完成,但某些子任務遇到錯誤/例外而並未完成。
失敗
任務因錯誤/例外而並未完成且已中止。
未登錄
在快取中找不到此任務而未追蹤進度狀況。
啟用匯出/匯入任務進度追蹤
經由在服務呼叫中新增 trackTaskProgress=true 參數可啟用此功能。匯出 (「匯入/匯出」 > 「至檔案」) 和匯入 (「匯入/匯出」 > 「從檔案」) 動作將不會開啟相關任務的追蹤。
啟用實體匯出任務進度
以下範例呼叫可用來啟用匯出任務追蹤進度狀況:
http://localhost:8080/Thingworx/Exporter?repositoryName=SystemRepository&path=/&trackTaskProgress=true
在標題中新增 Accept=application/octet-stream
系統會在回應中傳送 taskID 來回覆此 GET 請求。以下是範例回應:
「已提交實體匯出供進行處理。請檢查記錄檔以瞭解 Task-1493913609284 的完成狀況。」
其中的 taskID1493913609284。您必須從這個回應擷取此 taskID,並使用它來追蹤任務的完成狀況。
啟用實體匯入任務進度
以下範例呼叫可用來啟用匯入任務追蹤進度狀況:
http://localhost:8080/Thingworx/Importer?repositoryName=SystemRepository&path=/&trackTaskProgress=true&exportFileName=AllEntities.twx
系統會在回應中傳送 taskID 來回覆此 GET 請求。以下是範例回應:
「已提交實體匯入供進行處理。請檢查記錄檔以瞭解 Task-1493913609285 的完成狀況。」
其中,taskID1493913609285。您必須從這個回應擷取此 taskID,並使用它來追蹤任務的完成狀況。
請使用追蹤來取得任務完成狀況
在匯出/匯入 GET 請求的回應中傳送的 taskID 用來追蹤該任務的進度。taskCacheKey=taskID 是服務呼叫中的必要參數,以便追蹤該特定任務的完成狀況。
追蹤匯出進度任務
以下追蹤範例可用來取得所提交任務的完成狀況:
http://localhost:8080/Thingworx/Exporter/cache/?taskCacheKey=1493913609284
系統會根據快取中任務的狀況將回應傳送給您。回應會包括上述其中一個任務進度狀況。作為使用者,您可以根據傳回的任務狀況進行定期追蹤,並在最後取得所登錄任務的狀況。
追蹤匯入進度任務
以下追蹤範例可用來取得所提交任務的完成狀況:
http://localhost:8080/Thingworx/Importer?taskCacheKey=1493913609285
系統會根據快取中任務的狀況將回應傳送給您。回應會包括上述其中一個任務進度狀況。您可以根據傳回的任務狀況進行定期追蹤,並在最後取得所登錄任務的狀況。
這是否有幫助?