跳轉到

建置號碼 2.119.x

升級注意事項(2025R2.116.1 → 2025R3.119.1)

修復以下議題,若您的專案有相關需求,請考慮升級至最新版套件:

套件名稱 版本
@uofx/web-components 4.19.13
@uofx/app-components 3.18.4
@uofx/core 3.11.0
@uofx/error-code 2.17.0
@uofx/icon 2.9.0
@uofx/plugin 4.3.2

修正

  • Internal Tracking ID: 40839 [上傳檔案]將檔案全部刪除時,整個物件會回傳null,正確應該只 files 清空
  • Internal Tracking ID: 40969 [外掛模組]外掛頁面切換時發生錯誤
  • Internal Tracking ID: 40793 [模擬流程]外掛欄位設定擴充屬性為條件式站點時,使用模擬流程發生錯誤

版本相容性檢查清單

UOF X 升級後,請確認以下項目,以避免正式環境發生不相容問題:

  • 您的外掛模組已在指定的 UOF X 版本上完整測試
  • 參考 @uofx/plugin 版本對應表 確認對應關係
  • 有疑慮時,請先於測試環境中驗證,避免直接部署至正式環境

Breaking Changes¶

1. 更新 ClientApp/src/webpack.config.js 檔案內容

請將原本的 webpack.config.js 完整替換為以下內容:

const initUofxPluginWebpack = require('@uofx/plugin/scripts/initialWebpack');

module.exports = initUofxPluginWebpack({ usePort: 40001 });

2. 因應新功能:單選/複選/下拉選單欄位支援文字填答

功能亮點

此次升級為單選、複選、欄位新增了 文字填答功能,讓表單設計更加靈活

更豐富的資料收集:使用者可在選項後方補充詳細資訊
減少表單欄位數量:不需額外建立文字欄位來收集補充說明
提升使用者體驗:一個欄位同時滿足選擇與填寫需求

Image

⚠️ 開發者調整須知

由於欄位傳出值格式已調整,若您的外掛模組有在以下功能拿【單選/複選/下拉選單】欄位值,請務必進行調整:

影響範圍:

  • 欄位串外部
  • 按鈕欄位
  • 表單驗證器
  • 外部程式站點
  • 簽核事件
  • 外掛欄位跨欄位取值

調整指南:

💡 表單欄位格式傳出值

相容性提醒

此變更會影響欄位值的資料結構,請在測試環境中完整驗證後再部署至正式環境,以避免功能異常。

🔧 外掛欄位升級注意事項

舊用法將於 2025R4、2026R1 版本起正式移除,為避免未來相容性問題,請務必升級至新寫法:

以下方法將於 2025R4 版本起正式移除:

舊用法 新用法
this.addFormControl this.fieldUtils.addFormControl
this.initPluginSettings this.pluginUtils.initPluginSettings
this.getTargetFieldValue this.pluginUtils.getTargetFieldValue

以下方法將於 2026R1 版本起正式移除:

舊用法 新用法
this.parentFormBinding this.fieldUtils.parentFormBinding

🛠️ 說明:上述新方法皆整合於 fieldUtilspluginUtils 工具中,提供更一致的欄位操作方式。

如需支援,歡迎聯繫我們的技術團隊。