本章節說明如何透過 CNC Program Transfer API 執行 CNC 程式管理作業。操作內容包含：
- 取得 CNC 的程式清單
- 刪除 CNC 的程式
- 將程式從檔案伺服器傳輸至 CNC
- 設定 CNC 的主程式
二、事前準備
1.確認FANUC CNC Program Transfer APP 是Running。
- 20250515004
- 20250515004.png (68.83 KiB) 已瀏覽 270 次
2.打開API執行權限。
(1) 點選【Roles】。
- 20250515001
- 20250515001.png (33.45 KiB) 已瀏覽 270 次
(2) 找到API使用的Role後，點選編輯按鈕。
- 20250515002
- 20250515002.png (30.6 KiB) 已瀏覽 270 次
(3) Modify Role 確保Execute都打勾後，點選【Save】。
- 20250515003
- 20250515003.png (41.74 KiB) 已瀏覽 270 次
3.建立檔案伺服器。
(1) 在主機上至設定建立帳戶，供API使用 (可選)。
(2) 在主機上建立一個新的資料夾「FsBP_FileServer」。
(3) 右鍵點選資料夾後，選擇「內容」。
(4) 找到API使用的Role後，點選編輯按鈕。
(5) 點選【進階共用】。
(6) 勾選「共用此資料夾」。
(7) 點選【權限】，設定讀取、變更權限。
(8) 點選【確定】。
- 20250515005
- 20250515005.png (1.81 MiB) 已瀏覽 270 次
三、使用API
1.取得 CNC清單
(1) API : [GET] https://[box-ip]/ap-fanuc.co.jp-program-transfer/api/v1/list_cnc。
(2) Status對應表。
- 20250515006
- 20250515006.png (10.59 KiB) 已瀏覽 270 次
2.取得 CNC 的程式清單
(1) API : [POST] https://[box-ip]/ ap-fanuc.co.jp-program-transfer/api/v1/list_program。
(2) 說明:
- cnc_path：新型號使用資料夾名稱；舊型號使用路徑編號。
- program：程式名稱或資料夾名稱。若為資料夾，名稱會以「/」 結尾。
3.刪除 CNC 的程式
(1) API : [POST] https://[box-ip]/ ap-fanuc.co.jp-program-transfer/api/v1/delete_program。
(2) 說明:
- 依據指定的程式名稱，刪除CNC的程式。
- 僅能刪除可從 list_program API 可取得的程式，但不會刪除正在執行中的程式。
- 若指定資料夾名稱或不存在的程式名稱系統將自動忽略，並繼續執行下一個程式的刪除作業。
4.將程式從檔案伺服器傳輸至 CNC
(1) API : [POST] https://[box-ip]/ ap-fanuc.co.jp-program-transfer/api/v1/write_program。
(2) 說明:
- 支援使用group將相同程式傳送給多台 CNC。
- CNC若存在同名稱檔案，則不能覆寫。
- 在從檔案伺服器讀取程式時，可根據參數指定是否執行 SHA-256 雜湊值驗證，請注意雜湊值為「小寫」。
- 若傳輸失敗，可注意是否與防火牆設定有關。
5.設定 CNC 的主程式
(1) API : [POST] https://[box-ip]/ ap-fanuc.co.jp-program-transfer/api/v1/select_program。
(2) 說明:
- 將指定的程式設定為 CNC的主程式。