跳轉到

工作流程:透過 HTTP API 進行重播驗收

專案建構以一次乾淨的重播收尾:整個任務播放完畢、每則訊息都依 id 讀過,數值上的交叉核對也都做完。本頁就是透過 HTTP API 驅動的那一次重播,給沒有畫布可看的腳本或代理程式 (agent) 使用:如何開始一次真正全新的執行、如何在它播放時盯著它並得知它已經結束,以及證明它切了該切之處的證據。

登入、回應封套,以及這裡每一條路由都遵循的其他約定,見透過 HTTP 驅動網頁服務(英文,未鏡像)。

flowchart LR
    Free["執行個體空閒?"]
    Reset["重置"]
    Start["開始<br>保留 runId 與 instanceId"]
    Poll["輪詢狀態、觀察執行<br>同一個 runId、同一個 instanceId"]
    Evidence["讀取證據"]
    Msgs["盤點訊息"]

    Free --> Reset --> Start --> Poll --> Evidence --> Msgs
    Msgs -->|修正後再重播| Free

1. 從空閒的執行個體與已重置的工作階段開始

服務替連上它的所有用戶端只持有一個專案與一次執行,所以重播一開始要先確認執行個體是空閒的,而且絕不以停止一次無法證明屬於自己的執行作結。

  1. GET /api/Execution/status。如果 executionStatus 是 Running 或 Paused,就表示有一次執行正在進行——不要開始、重置或停止它。重置也會停止正在進行的執行。review 不是 null,表示有一份記錄下來的播放正開著回顧(§7),可能是別的用戶端開的:回顧開著時不會播放任何程式——執行走到的第一支程式就會以 Player-Run--Fault 結束這次執行——而第 2 步的重置會關掉它。
  2. POST /api/Execution/reset,每次開始之前都要做。開始並不會重置。一次執行完成之後,POST /api/Execution/start 會在那次執行留下的工作階段之上再播放一次任務——已加工的工件、它的步與它的訊息都還在。於是每一筆「首次讀取,否則寫入」記錄都看到已經產生的步,改為寫入而不是讀取,所以第 0 階段的記錄會以加工後的零件覆寫快取的毛胚;之後的每一次執行,不論有沒有重置,都從已經切過的毛胚開始,直到那個檔案被刪除為止。先前那次執行碰到工件的步也會讓未接觸警告 Play-Touch--None 無從觸發;第二次執行回報的反而是每把什麼都沒切到的刀各一則 Tool-Touch--None,指向的是刀長與偏移,而不是漏掉的重置。另一個請求正在本工作階段播放 NC 程式時——例如一個 POST /api/SessionShell/PlayNcFile,executionStatus 不會把它顯示為 Running——重置會回應 409,帶著 code: "Reset--Busy",什麼都不重置:等那段播放結束,再重置。

重置會清空步序列與工作階段的各份訊息清單,所以要先讀完前一次執行的證據(§4、§5),再為下一次執行重置。

2. 開始,並依執行 id 輪詢

  1. POST /api/Execution/start,接著檢查回應本體,而不只看狀態碼。一個已啟用、卻編譯不過的腳本命令,會以 HTTP 200、success: false 與 code: "script_compile_error" 拒絕開始;在有執行正在進行時開始,會回應 alreadyRunning: true,而且什麼也不會開始,旁邊的 runId 是那次正在進行的執行的——服務分辨不出它是不是你的,所以不要為它輪詢。另一個請求發起的工件匯出、Diff 或步物理重算正以單次工作在閒置的播放器上執行時,開始或 run-step 會回應 409 與 code: "Start--BusyOneShot",run-line 回應 RunLine--BusyOneShot,什麼也不會開始:等那個請求回應之後再開始。回應若是在另一個請求的工作仍佔著播放器時送出的——重算期間發出的呼叫會在重算的兩個區塊之間執行並回應,而一個請求會在排在它後面的工作執行之前就回應——開始仍會回應 Start--BusyOneShot:等 executionStatus 變成 Ready 或 Finished,再開始一次。保留真正開始時所傳回的 runId,以及它旁邊的 instanceId,也就是計數這個 runId 的那個服務行程。真正的開始也會說明它是不是在全新的工作階段上開始的:continuesSession: true,連同一則說明此事的 note,表示跳過了 §1 的重置,這次執行疊在先前某次播放留下的工作階段之上播放,所以它的證據裡也會帶著那次播放的步與訊息。這樣的執行什麼都不要驗收:它是你的,所以重置——重置會停止它——再重新開始。在全新工作階段上的開始,回應 continuesSession: false。
  2. 輪詢 GET /api/Execution/status,直到它在同一個 instanceId 之下回報那個 runId,且 executionStatus 為 Finished 或 Ready。重置之後,被停止、或以例外結束的執行,就是以 Ready 回報自己:只等 Finished 的輪詢程式,遇到失敗的執行永遠不會返回。少了 §1 的重置,這樣的執行會承接上一次執行的 Finished。Ready 背後的例外寫在服務日誌裡,GET /api/Project/logs 會傳回當天的日誌。runId 變大,表示在那之後另有呼叫端開始了一次執行。instanceId 不同,表示服務重新啟動過,那次執行已經不在了:新的行程會從 1 重新計數它的執行。
  3. 在任何東西重置工作階段之前,先讀取下面的證據。

邊播放邊觀察

一趟長時間的播放,值得在它執行時就看著,而不只是在結束時評判。程式原點錯了、刀長或補正設錯了,或毛胚擺錯了位置,都不會讓執行停下:它會一連幾個小時不斷碰撞、空切或切得太深,而之後在那塊毛胚上播放的每一支程式都白費了。下面這些請求讀取進行中的執行、不改變任何東西,而且夠輕量,可以在輪詢程式等待時每隔幾分鐘重複一次:

看什麼 請求 正常時
仍在執行、仍是你的 GET /api/Execution/status executionStatus 為 Running,且帶著你開始時傳回的那個 runId 與 instanceId
進度 GET /api/execution/cl-strip/range 兩次查看之間 count 有增加
警報 GET /api/Execution/messages?minSeverity=Message&tail=0&idPrefix=<prefix>,對 Collision-- 與 Play-RapidCut 各查一次,Stroke 則改用 minSeverity=Error(排除開場一次性的設置警告 StrokeLimit--Unconfigured) 每份清單的 matched 都維持 0
新的警告 GET /api/Execution/messages?minSeverity=Warning&head=1000,某份清單的 returned 小於它的 matched 時接著讀(§5) 沒有你還沒交代過的 id(§5)
播放到哪裡 §4 的時序圖,帶 widthHint=0、比 count 早一段的 dispBegin、dispEnd=<count>,inspectingKey 為 FileNo、LineNo、ToolId、Cl.X、Cl.Y、Cl.Z,取其中最後一個不是 NaN 的值——count 也算進了還在計算中的步,它們回答 NaN 檔案與行號持續往前走;刀具是程式所呼叫的那一把,位在程式切削的地方
有沒有在切、切得多重 同一張時序圖,涵蓋最後幾千步,用 IsTouched、CuttingDepth_mm、MaxAbsForce_N、StressRatio 與 MaxSpindlePowerRatio——後三者是物理量:專案沒開物理、沒有物理授權,或顯示物理選項關著時,它們回答 NaN 或空的 items 在程式切削之處有接觸;切深不超過刀具的刃長——只有沒吃到壁面時才接近每層下刀量,壁面、轉角或側刃加工可能以整段刃長吃刀(§6);應力比與主軸功率比都低於 1——回答帶的是比值本身,1 就是瀏覽器顯示的 100 %,items 裡它那一項的 unit 是 %、scale 是 100;比值超過 1 標示的是不良加工,不一定是失效加工,本身並不代表設定錯誤:量產及已被核可的製程也可能讀到超過 1(不良加工,不一定是失效加工),所以把這樣的讀值記下來寫進報告,不要為了把它壓到 1 以下而去改材料或它的切削參數;遠超過 1 的讀值,要對照假設檢查(仿真報告)

時序圖的 Individual 面向只回答專案的檢視鍵(HiNC 3.2.46 起):先設鍵——設之前記下專案現有的鍵(不帶鍵的 GET /api/execution/strip-chart-item-config 回答的 inspectingKey),再 POST /api/execution/inspecting-key 帶 {"inspectingKey": "FileNo"},回應的 currentKey 必須就是那個鍵——再讀。回應帶 pending: true 表示還沒準備好:主機還在為每一步填那個鍵的值,過一會兒再讀,直到它變成 false;items 是空的而 pending: true,表示那個鍵不是專案的檢視鍵(別的用戶端設了自己的)。設鍵會改掉專案自己的設定、存檔時會一起存下,所以讀完要再讀一次專案的鍵,它仍是你設的那個時,才把專案原本的鍵——也就是你先前記下的那個——設回去;若在那之後別的使用者設了另一個鍵,那是他們的,就留著。帶 tail=0 時,每份清單只回答它的 total 與符合篩選條件的 matched 計數,不傳回訊息本身,所以一次警報檢查,每個前綴只花一個小小的回應。播放期間不選取任何步時,應用程式的畫布會顯示刀具,以及到目前為止切出來的毛胚;幾何差異則要到播放結束才會建立。

只有在設置錯誤會毀掉之後的加工時,才停止播放——警報接連不斷、程式該切的地方沒有接觸、切深或負載遠遠超出該趟加工、刀具出現在程式從不去的地方。這時才停止它(POST /api/Execution/stop 會停止當下的任何一次執行,所以只停你確知是自己的那一次),修正設置,再從 §1 重播。不會毀掉之後加工的缺陷——一則已經弄清楚的警告、退刀時的一次碰觸——就記下來,讓播放跑完;它和其餘的證據一起在 §4 與 §5 評判。

輪詢程式放棄時,就讓它放棄:逾時不是呼叫 POST /api/Execution/stop 的理由。它不帶執行 id,會停止當下的任何一次執行——在共用的執行個體上,那未必是你的——而被停止的執行,不會跑到任務中它停下之處以下的各列:既沒有執行後作業的輸出,也沒有階段末記錄。

3. 先粗後細——並在兩者之間清掉毛胚快取

新專案最初的幾次播放檢查的是基準,而不是表面,所以它們以粗的初始解析度(PUT /api/Workpiece/init-resolution)與粗的加工解析度執行。為了驗收執行而改用精細解析度時,有一個陷阱。第一支程式上方的第 0 階段記錄,快取的是依當時的初始解析度網格化的毛胚,而之後的每一次執行都會把那個檔案讀回來——所以在變更初始解析度、毛胚幾何或它的預留量之後,下一次執行仍從舊的毛胚開始,而且沒有任何東西會說明這一點。

下一次開始之前,先刪除第 0 階段的檔案:DELETE /api/Mission/commands/{path}/recordmeshedgeom/file,其中 {path} 是該記錄項目的路徑(GET …/recordmeshedgeom/file-status 會回報檔案是否存在)。你打算從它接續的階段末檔案,同樣是以舊的寬度寫下的;刪掉它,或把它的階段再播放一次。變更加工解析度命令則不需要刪除任何東西——它管的是它下方的切削,而不是快取的毛胚。這些記錄所屬的配置見能接續的任務;在應用程式中,記錄自己的重設會刪除它的檔案。

4. 完成的執行不等於通過的執行

Finished 說的是任務走到了終點,並沒有說切到了任何東西。工作階段開始時主軸上沒有刀具,除非專案隨它的設備存了一把——這個 API 沒有任何路由能設定這把刀,所以透過它建出的專案從來不會有——在那之後,只有換刀指令或手動裝刀項目會裝上刀具。一支從未裝上刀具的程式——為操作員手動換刀的機台寫的、不帶 T… M06 的程式;執行器解析不了的刀具字語;空的刀具名稱表——會播放每一行,完全不產生任何加工步,卻仍以 Finished 結束。它在 step 清單裡留下一則警告 Step-Tool--NotEquipped,位於主軸空著時的第一個進給移動上,指名那個移動的行號與檔案——每次重置後一則。播放結束時的警告 Play-Touch--None 只在有步、而其中沒有一步碰到毛胚時才會提出,所以一趟零步的播放永遠走不到它;NC 訊息也往往完全看不出沒裝上刀具這件事——不論主軸上有沒有刀具,G43 H1 都照表補正,而不帶 H 的 G43 則沿用模態的 H(程式寫出任何 H 之前為 H0),一聲不吭,一如控制器的做法。

在切削之前給這樣的程式一把刀,就像操作員做的那樣。首選:在它的程式檔案上方放一筆手動裝刀項目——POST /api/Mission/list-command/entries,本體為 {"commandType": "manualtooling", "insertIndex": <該程式檔案的索引>},再以 PUT /api/Mission/commands/{path}/fields/toolId 送出刀號作為本體。它裝上刀、什麼也不播放,所以檔案保有它的各行與它的檔案編號(裝上操作員手動裝的刀)。否則就在專案播放的那份副本裡(專案建構 §1)把換刀放在開頭——T1 M06。在程式檔案上方放一筆內容為換刀的 NC 程式碼項目也能裝上刀,但它本身就以一個檔案播放,所以會佔一個檔案編號,之後的每支程式都往後一號:依 FileNo 映射的控制器紀錄(感測器資料映射)要跟著改。沒有 G43 的程式還需要刀具長度——在副本裡為該刀具加上 G43 H,或照不做長度補正的現場的做法,把刀長併進工件偏移的 Z(程式原點對齊)。少了它,刀尖會在每一個程式 Z 之下整整一支刀長處運行,播放要不是什麼也沒碰到、以 Play-Touch--None 結束,就是往毛胚裡多插那麼深。

零步的執行也會躲在接續配置的背後。沒有產生任何步時,程式下方的每一筆「首次讀取,否則寫入」記錄仍然會讀取,所以先前一次成功的執行所留下的階段末檔案會被載入回來——而畫布與幾何差異會把那個先前的結果,顯示得像是這次執行做出來的一樣。

所以要憑證據驗收一次重播:

檢查 請求 通過條件
有步 GET /api/execution/cl-strip/range count > 0
有東西被切到 GET /api/execution/strip-chart?aspect=Individual&inspectingKey=IsTouched&xValueCategory=IndexByStep&widthHint=1&dispBegin=0&dispEnd=<count> items[0].max 中的最大值為 1
每支程式都執行過 GET /api/NcProgram/files 每個檔案——以及列在其呼叫者的 children 之下的每支副程式——都至少有一趟 (invocation) 的 executedLineCount 不為零
差異已經建立 GET /api/Workpiece/diff-settings hasDiffOverlay 為 true(而且 detectionRadius 不再是 null)
輸出已寫出 GET /api/Execution/messages?kinds=shell&idPrefix=StepFile-&tail=1000(以及 idPrefix=ShotFile-),再 GET /api/file-explorer/list?rootName=ProjectDirectory&relativePath=<範本所在的資料夾> 每個預期的檔案都有一列 StepFile-Create--Start(ShotFile-Create--Start),也就是正在建立檔案 […],位於寫出器的 …-Write--Start 與 …-Write--Finish 之間;沒有 …-Write--NoFile;每個檔案都列得出來,且 size 大於 0
訊息 GET /api/Execution/messages 每個 id 都有交代(§5)

GET /api/Workpiece/diff-settings 回應 { hasWorkpiece, diffVisualRadius, detectionRadius, hasDiffOverlay };沒有載入專案時則回應 { hasWorkpiece: false }。hasDiffOverlay 說的是此刻有一份覆蓋層掛在即時的網格樹上——既不代表找到了偏差,也不代表有要求過比對——而 detectionRadius 在覆蓋層存在之前為 null,所以 null 的半徑與 false 的旗標是同一個答案。重置會把兩者都清掉。

執行後作業只寫出在它上面已播放的內容。它的寫出器若一個檔案都沒打開——命令排在程式上方,或這次執行沒有任何步——就會以警告 StepFile-Write--NoFile 或 ShotFile-Write--NoFile 收尾,而不是 …-Write--Finish。正在建立檔案 […]那一列裡的路徑是展開後的範本,除非範本是絕對路徑,否則相對於專案資料夾;從沒建立過的資料夾,file-explorer 的 list 會以 404 回應。

要明確傳入 dispBegin 與 dispEnd:少了它們,時序圖只涵蓋目前的顯示範圍,而不是整次執行。widthHint=1 最多傳回兩個點:第一個涵蓋去掉最後一步的範圍,第二個只涵蓋最後一步。範圍的峰值取 items[0].max 中的最大值(谷值則取 items[0].min 中的最小值);widthHint=0 則改為每一步傳回一個點。先設鍵(§2):只有 IsTouched 是專案的檢視鍵時,這個請求才回答它;主機還沒填完它的值時回 pending: true。

對某一行的效果有疑問時,GET /api/NcProgram/syntax-piece?fileIndex=<i>&lineIndex=<n> 會傳回執行器剖析出來的那個語句,連同它產生的步——要看出某個位址字語究竟附在哪個命令上,這是最直接的方法。回顧中(§7),它回答的是記錄在那個檔案、那一行的程式單節——記錄在那裡的第一個——JSON 的形式相同,並帶著由它重建的步;只帶 sentenceIndex 的查詢什麼也找不到。

案例自己的通過標準

案例的通過標準,是它的結果要算是通過就必須達到的條件:在第一次播放之前寫下,之後完全照它們寫的內容判定。結果不符合一條標準的文字時,這條標準就照原文判定不通過——即使那段文字後來證明是錯的,或結果只在文字沒有料到的地方沒達到它,也一樣。

上面的證據適用於每一次重播;案例的標準則是它自己的——形狀必須守住的公差、刀具可以承受的負載與可以撓曲多少、該花多少時間,以及依 id 與次數預期會出現的訊息(專案建構 §1)。HiNC 沒有管它們的設定或命令:它們是一種做法,以書面放在專案旁邊,並用本頁與幾何驗證的讀數來判定。

  • 每一條都在第一次播放之前寫下,寫成一個讀數與一個值——一支程式各步的 StressRatio 或 MaxSpindlePowerRatio 峰值低於 1,也就是 100 %(§2、§6);沒有 Collision-- 或 Play-RapidCut 訊息(§2、§5);仿真時間與後處理器估計值的差在寫明的百分比以內(§6);顯示半徑設成公差時,程式切削的面上沒有全紅或全藍——在畫布上看,因為幾何差異給的是顏色而不是數字,或在 HiNC 之外量匯出的切削件。每一條旁邊都寫下你預期的結果;一條標準檢驗的是模型沒有拿到的東西時,預期的不通過也照寫。這份清單放在專案的 README 裡(專案建構 §7),專案有版本控制時就和它一起提交,之後有什麼修改才看得出來。第一次播放之前請別人讀一遍:那時發現寫錯的標準,還來得及改。
  • 照原文判定:通過、不通過,或無法照原文判定。最後這一種,是文字要的讀數這次執行沒有產生——步回答 NaN 時的負載比(沒開物理,§2;刀具的樑材料沒有設定或強度未知;沒有主軸能力),§6 的峰值會跳過這些步;碰撞偵測關著、或什麼都沒偵測到(沒有碰撞偵測的授權,或沒有可供偵測的加工鏈)的播放裡沒有 Collision-- 訊息——或是文字定的公差細到比對分不出它與零的差別,也就是低於比對的雜訊底限。在這樣的判定旁邊寫明有哪些證據可以代替它,如果有的話。讀數一出來,就不要放寬、挪動或刪掉任何一條標準:讀數之後才改的標準,什麼也判定不了。
  • 寫錯的標準,或只在文字沒料到之處沒達到的標準,仍照原文判定——選取範圍涵蓋了程式從不切削的面,會讓正確的結果不通過;對每一步做的檢查,會在什麼都沒切到的步上不通過;在網格的尺度上擦過毛胚的快移,會引發一則 Play-RapidCut。保留文字給出的判定,在旁邊加註說明原因,並把本來要量的讀數——在本來要量的面或步上——能量的就量出來,當成一項關於計畫的發現回報,絕不當成新的判定。
  • 標明哪些只記錄、不判定——一次播放花了多少電腦時間、需要多少記憶體,以及雜訊底限本身——免得之後有人把沒判定過的數字讀成通過。播放之後才加上的標準或比對,標明是事後加上的。

這些是針對完成結果的條件,不是 NC 優化器在選擇進給時逐步守住的那些準則(決定優化進給率的因素)。

5. 盤點訊息

GET /api/Execution/messages 每份清單傳回一個區段——shell、nc、step 與 ncManip——並以同樣的方式篩選它們全部:

  • minSeverity=Warning&head=50 傳回最前面的符合項,一連串連鎖訊息的起因就在那裡;預設則是從尾端取。
  • tail 與 head 的上限都是 1000,所以一次請求每份清單最多傳回 1,000 則訊息;tail=0 只傳回計數——這是估量每份清單有多大的快速方法。
  • idPrefix 把範圍縮小到同一族的 id;kinds 指名要讀哪幾份清單。
  • sinceIndex 一次只替一份清單分頁,所以這時 kinds 必須恰好指名一份。
  • 一份清單符合的訊息超過 1,000 則時,一次讀 1,000 則。每則訊息帶著它的 index,也就是它在所屬清單裡的位置。先以 head=1000 讀;某份清單的 returned 小於它的 matched 時,對那份清單以 kinds=<清單>&sinceIndex=<上一次傳回的最後一則訊息的 index>&head=1000 接著讀,其他篩選條件不變,直到一次回應就傳回剩下的全部。接著讀要用 head,不用 tail:配上 sinceIndex 時,tail 傳回的仍是那個索引之後的最後 1,000 則,中間的都跳過。

Collision--Detected 的 stepIndex 是它那個位姿的工步會拿到的索引;碰撞一被發現就回報,那時那一步還沒建成,失敗時會暫停的執行就停在那裡。在授權之前說的授權與租約拒絕(MachiningStep--LicenseCapReached 與同類的訊息,會讓執行停住)、Player-Run--Fault 與 Step-Task--Fault(建它時失敗的工步),也一樣錨在自己那一步。行程極限的回報也是——Stroke-Limit--Over,在舊版 HardNc 執行器上則是 StrokeLimit-Xyz--Over 與 StrokeLimit-Abc--Over——錨在位姿超出極限的那一步(沒有建出工步的運動,則錨在那一步本來會拿到的索引);它不指名語句,所以它的 sentenceIndex 是 -1。不重置就停止再開始之後,重播的工步從那裡接著編號,所以同一個索引可能屬於之後的另一步。要分辨,就問 GET /api/NcProgram/sentence-of-step?stepIndex=<stepIndex>:只有答覆的 sentenceIndex 等於訊息的,那一步才是這則訊息的。答覆沒有 sentenceIndex 時:索引小於 stripCount 而 locked,是管線還在填的位置(再問一次);下一個索引(notBuiltYet)而 running,是執行正在建的那一步;其餘的 notBuiltYet,是執行在建成它之前停止或暫停了的那一步;索引小於 stripCount 而沒有 locked,是停止時被丟掉、或建它時失敗了的那一步。其他工步訊息——腳本的、換刀的、行尾的、主軸上沒有刀具的——依設計錨在下一個建成的工步上,不拿來比;sentenceIndex 為 -1 的訊息沒有東西可比。這個比法只在同一段語句編號裡成立:重置會清掉訊息,而 EndSession、腳本的 PowerReset() 或換 NC 執行器會留下它們,並讓之後的語句從零重新編號。回顧中(§7),sentence-of-step 讀記錄下來的步,就像讀實際播放的步一樣;但結果不記錄訊息:清單裡只有回顧自己的訊息,沒有東西可比。

什麼時候可以停——只剩下已宣告的資訊性訊息,再加上維持交付原樣之寫法的預期訊息——見專案建構 §5。

6. 交叉核對用的數值

§4 的時序圖請求,可以傳回任何步屬性在任何步範圍內的峰值——也就是它傳回的各點中,items[0].max 的最大值——前提是先照 §2 把那個屬性設成檢視鍵。鍵從 GET /api/execution/step-properties 取得——切深檢查用 CuttingDepth_mm,力的峰值用 MaxAbsForce_N。一組粗加工的切深峰值應等於它的每層下刀量;精加工程式的切深峰值卻不是它的預留量,因為壁面或轉角可能以整段刃長吃刀——精加工工作的 Z 基準,改用由參照網格建立工件 §1 的距離測試來檢查。以比預留量還粗的加工解析度執行,能告訴你程式有沒有碰到毛胚、碰在哪裡;力與切深則只能取自解析度比預留量更細的執行。要把範圍縮小到一個檔案,就從 GET /api/NcProgram/files 取得該趟的 firstSentenceIndex 與 lastSentenceIndex,再以 GET /api/NcProgram/steps-of-sentence?sentenceIndex=<n> 把兩者各自換成步。回顧中(§7),各趟沒有語句範圍,steps-of-sentence 回答 found: false:一行的步改看它在 line-marks 裡的那一筆,以及它的 syntax-piece 答覆。

第 i 步結束時的仿真時間,就是它的結束時間碼:xValueCategory=IndexByTime&widthHint=0&dispBegin=<i>&dispEnd=<i+1> 會在 xs 中以秒為單位傳回它。一個檔案的步範圍兩端之差,就是要拿來與後處理器估計值比較的時間,而這項比較的限度見專案建構 §6。

7. 透過 API 回顧記錄下來的播放

以記錄播放結果記錄下來的播放,不必播放就能再讀一次(記錄播放並回顧它)。POST /api/LocalProjectService/OpenNcResultReview?relResultDirectory=<資料夾> 開啟回顧——資料夾相對於專案資料夾,留空就是最新一個完成的結果——POST /api/LocalProjectService/CloseNcResultReview 則關閉它。兩者都需要已載入的專案,但不需要工作階段;回顧開成或關掉時回應 200,沒有時回應 409,原因在回應本體的訊息裡;不含結果檔的資料夾回應 500。開啟時會先結束仍開著的記錄、重置這次執行,就像 §1 的重置那樣,所以要先讀完實際播放那次執行的證據;重置、關閉與切換專案都會關掉回顧。

回顧開著時,GET /api/Execution/status 帶著 review——資料夾、程式的名稱、記錄的時間、步數、位置數與程式單節數、記錄是否完成以及播放是否跑到了結尾,還有加工完成的素材後來怎麼了(wctState;wctColoured 說載入的素材是否照記錄下來的步著色、可點選,結果沒有素材的節點對應表時為 false,素材以未著色呈現),以及它的 luggage 歸檔後來怎麼了(luggageState:資料夾的 luggage.db——記錄下來的步的力陣列與嚙合——已開啟時為 Loaded,資料夾裡沒有時為 None,回顧沒有讀它時為 Incomplete、Mismatch 或 Failed)——沒有回顧時為 null。步序列、步與時序圖都是記錄下來的那一份;luggageState 為 Loaded 時,「模擬切削力週期」與「模擬主軸力矩週期」兩張圖也是:GET /api/execution/cycle-line/force 與 GET /api/execution/cycle-line/sim-spindle-moment 從歸檔回答,和播放時一樣。結果裡沒有的東西回答已就緒而沒有資料,而不是尚未就緒:CWE 面板的 POST /api/Execution/step-volume/{connectionId} 在每一次回顧裡,以及兩張模擬週期圖在沒有歸檔、或歸檔裡沒有那一步時,都帶著 reviewing: true,應用程式把它顯示成播放結果無此資料;步也沒有步變數的值。Program 的請求從結果檔回答:files 每個記錄到的原始檔一個根,沒有呼叫者、語句範圍與已執行行數(-1);line-marks 標出某一趟記錄了程式單節的行,連同它的步;syntax-piece(§4)、sentence-of-step(§5)與 steps-of-sentence(§6)的答法見各節。結果不記錄訊息,也沒有已執行行數,所以 §4 裡讀取它們的檢查只適用於實際播放的執行。

延伸閱讀

  • 專案建構 — 這次重播所驗收的建構
  • 透過 HTTP 驅動網頁服務(英文,未鏡像) — 登入與回應封套
  • 〈One Service, One Project〉(英文,未鏡像) — 所有用戶端共用一個專案,以及在別人正在使用的執行個體上不該做什麼
  • 能接續的任務 — 記錄的配置,以及它的快取何時會過時
  • 出了問題時 — 應用程式中所顯示的那幾份訊息清單,以及執行完成了、卻什麼也沒有的情形
  • 其他命令 — 執行後作業:寫出什麼、寫到哪裡,以及它如何回報每個檔案;記錄播放結果與回顧播放結果
  • 幾何驗證 — hasDiffOverlay 背後的幾何差異