工作流程:從網頁應用程式進行感測器資料映射¶
本頁是從網頁應用程式進行的感測器資料映射:兩個映射命令與放其餘呼叫的「腳本」命令、一次一個項目建構這種任務的 HTTP 路由,以及映射樣本出現的三個地方。檔案格式、映射策略與呼叫本身在那一頁;這些請求所依賴的登入、回應封套與檔案路由,見透過 HTTP 驅動網頁服務(英文,未鏡像)。
任務中的映射命令¶
兩個檔案映射各自是一種任務命令:「CSV 一對一映射」(Map Single By CSV File)與 「CSV 一對多映射」(Map Series By CSV File),位於「新增命令」的「映射」類別中(見其他命令)。每一個都帶著它的檔案與該檔案的欄位標題,感測器那一個另帶「週期取樣模式」。感測器資料映射中其他的呼叫放進「腳本」命令,和任何任務腳本一樣,針對執行中的工作階段求值(見其他命令)。檔案放在專案資料夾中,經由檔案路由上傳(見檔案與具名根目錄(英文,未鏡像))。
任務的形狀是在「程式檔案」之後、同一個「清單」裡放兩個映射命令:
▸ Mapping
腳本 [clear] ClearTimeMappingData();
程式檔案 NC/machining.nc
CSV 一對一映射 Mapping/controller.csv
CSV 一對多映射 Mapping/sensor.csv
SessionShell 在整次執行中是同一個物件,每個命令都依序針對它求值,所以這份清單等同於把完整範例寫進一個「腳本」命令、中間夾著 PlayNcFile。順序也以同樣的方式影響結果:控制器檔給各步它們的實際時間,感測器檔再透過這些時間配對。策略 D 則是在「程式檔案」之前放一個帶 AddTimeDataByFile 呼叫的「腳本」,之後不放映射命令,由程式中的錨點觸發映射。
透過 HTTP 建構任務¶
透過 HTTP 時,任務是一次一個項目建構起來的(依製程安排任務):
| 步驟 | 請求 |
|---|---|
| 加入映射項目 | POST /api/Mission/list-command/entries/{listPath},本體為 {"CommandType": "mapsinglebycsvfile"} 或 "mapseriesbycsvfile",位置的指定方式與下面的「腳本」項目相同。 |
| 設定它的檔案與欄位標題 | GET /api/Mission/commands/{path}/fields 列出各欄位——relFile,接著每個欄位標題各一個(fileNoTag、actualTimeTag、… / timeTag、mxTag、…),感測器命令上還有 cycleSamplingMode 及其 options。PUT /api/Mission/commands/{path}/fields/{key} 接受裸的 JSON 值:"Mapping/controller.csv"、"Timestamp"、"FluteCycle"。不在選項清單中的值會被拒絕。 |
| 加入「腳本」項目 | POST /api/Mission/list-command/entries/{listPath},本體為 {"CommandType": "script", "IsEnabled": true, "InsertIndex": n}——n 是在清單中的位置,0 為第一個;省略時項目放在最後。回應中的 path 從此用來指定這個項目;GET /api/Mission/list-command/entries 列出整個任務及每一個 path。 |
| 寫入腳本 | PUT /api/Mission/commands/{path}/script,本體為 {"ScriptText": "…", "Title": "…"}。回應帶有 contentHash;之後的 PUT 可以把它以 ExpectedContentHash 送回,若腳本在這期間被別處編輯過,該 PUT 就會以 409 content_hash_mismatch 被拒絕。 |
| 檢查能否編譯 | POST /api/Mission/compile-check 編譯每一個已啟用的「腳本」命令,回應 isValid 與一個 scripts 陣列,每個腳本列出其 path、title、hasErrors 與 diagnostics(id、severity、message、line、column);POST /api/Mission/commands/{path}/compile-check 只檢查一個。有已啟用的腳本帶錯誤時,啟動會被拒絕,並回應 code: "script_compile_error"——見透過 HTTP API 進行重播驗收 §2。 |
| 儲存 | POST /api/Project/save——腳本文字與標題會寫入專案檔。 |
結果出現在哪裡¶
- 所選步的感測器週期圖。 選取一個步——在時序圖或刀具路徑上點一下,或以
POST /api/execution/cl-strip/select-step送出{"stepIndex": n}——「步資訊」欄的「感測器主軸力矩週期」就會畫出該步在一個週期時間窗內、隨時間變化的Mx、My、Mz樣本,「感測器切削力週期」則畫出它的Fx、Fy、Fz。這兩張圖都在「偏好設定」›「選用節點與圖表」底下開啟,預設為關閉(檢視一個步)。透過 HTTP,同一組序列是GET /api/execution/cycle-line/sensor-spindle-moment,回應{hasData, ts, xs, ys, zs},力則是GET /api/execution/cycle-line/dynamometer-force;hasData為 false 表示該步沒有樣本。 - 由樣本推導的步屬性。
AvgAbsTorqueByMapping_Nm是該步樣本Mz絕對值的平均,AvgMomentXyByMapping_Nm是彎矩大小的平均;AvgAbsTorqueErrorRatioWithMapping與AvgMomentXyErrorRatioWithMapping是(仿真 − 量測)/量測,量測值低於 0.1 N·m 時為空:這是比值,步屬性與圖表以百分比顯示它,仿真比量測低 12.35 % 時是-12.35%,HTTP API 與步檔案帶的則是比值本身,−0.1235。可在「步屬性」的選擇器中挑選它們,或在「視覺指標時序圖」的屬性選擇器中選一個,沿著執行畫出來(觀看執行:時序圖);透過 HTTP,GET /api/execution/step-properties列出這些鍵,而重播驗收 §4 的時序圖請求可以傳回其中任一個的序列。這四個是物理鍵:只有在該次執行啟用物理時(任務的「啟用物理模擬」設定),它們才會被列出與畫出。 - 訊息,在
GET /api/Execution/messages的shell清單中。CsvEmbed--Begin與CsvEmbed--Done包夾控制器那一層。Map-ShotGap--StepsSkipped是一則警告,計數一個週期時間窗內沒有任何樣本的步:錄製範圍之外的步——錄製資料沒有涵蓋整支程式時必然會有——加上錄製範圍內的任何資料中斷。TimeShotFile--NotFound表示找不到感測器檔,TimeShotFile--ReadFailed表示感測器檔的標頭列缺少時間欄位或命令所指名的欄位標題,訊息中會寫出缺少的標題。控制器檔無法讀取,或缺少檔案編號、行號或時間欄位時,沒有自己專屬的訊息;它會讓呼叫映射的那一方出錯。從映射命令呼叫時是Map-SingleCsv--Fault(感測器檔則是在它的TimeShotFile--ReadFailed之後出現Map-SeriesCsv--Fault),從腳本呼叫時是ScriptCommand-Run--Fault——每一則都會指出缺少的標頭,而且都讓任務繼續進行到下一個項目。
延伸閱讀¶
- 感測器資料映射 — 檔案格式、映射策略,以及本頁放進任務的那些呼叫
- 沒有控制器日誌時的感測器資料映射 — 控制器沒有寫下日誌時,要在「CSV 一對一映射」命令上指名的步檔案,以及把它放到錄製資料時鐘上的偏移量
- 依製程安排任務 — 透過 HTTP 建構任務
- 透過 HTTP API 進行重播驗收 — 時序圖請求與訊息清單
- 透過 HTTP 驅動網頁服務 — 登入、回應封套、檔案根目錄(英文,未鏡像)
- 其他命令 — 兩個映射命令,以及其餘呼叫所放進的「腳本」命令
- 檢視一個步 — 所選步的感測器週期圖
- 觀看執行:時序圖 — 沿著執行畫出映射步屬性的視覺指標時序圖