建置號碼 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. 因應新功能:單選/複選/下拉選單欄位支援文字填答¶
功能亮點¶
此次升級為單選、複選、欄位新增了 文字填答功能,讓表單設計更加靈活
✅ 更豐富的資料收集:使用者可在選項後方補充詳細資訊
✅ 減少表單欄位數量:不需額外建立文字欄位來收集補充說明
✅ 提升使用者體驗:一個欄位同時滿足選擇與填寫需求
⚠️ 開發者調整須知¶
由於欄位傳出值格式已調整,若您的外掛模組有在以下功能拿【單選/複選/下拉選單】欄位值,請務必進行調整:
影響範圍:
- 欄位串外部
- 按鈕欄位
- 表單驗證器
- 外部程式站點
- 簽核事件
- 外掛欄位跨欄位取值
調整指南:
相容性提醒
此變更會影響欄位值的資料結構,請在測試環境中完整驗證後再部署至正式環境,以避免功能異常。
🔧 外掛欄位升級注意事項¶
舊用法將於 2025R4、2026R1 版本起正式移除,為避免未來相容性問題,請務必升級至新寫法:¶
以下方法將於 2025R4 版本起正式移除:
舊用法 | 新用法 |
---|---|
this.addFormControl | this.fieldUtils.addFormControl |
this.initPluginSettings | this.pluginUtils.initPluginSettings |
this.getTargetFieldValue | this.pluginUtils.getTargetFieldValue |
以下方法將於 2026R1 版本起正式移除:
舊用法 | 新用法 |
---|---|
this.parentFormBinding | this.fieldUtils.parentFormBinding |
🛠️ 說明:上述新方法皆整合於
fieldUtils
與pluginUtils
工具中,提供更一致的欄位操作方式。
如需支援,歡迎聯繫我們的技術團隊。