建置號碼 2.119.x

升級注意事項（2025R2.116.1 → 2025R3.119.1）¶

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

版本相容性檢查清單

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

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

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

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

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

請務必檢查並調整下列設定，確保新版欄位資料結構正確對應，避免功能異常：

主檔相關

涉及功能：表單驗證器、外部資料來源

檢查項目：
- 參數來源 =「設計表單時再指定」
- 選擇欄位型態 =【單選 / 複選 / 下拉選單】
- 並調整相對應的 API 程式或 SQL 指令
→ 請將「類型：文字」調整為「類型：物件 / 陣列」
欄位設定

涉及功能：欄位串外部、按鈕欄位（取值）

檢查項目：
- 欄位開啟外部串接，且參數來源 =【單選 / 複選 / 下拉選單】
- 按鈕欄位使用「取值」功能，且參數來源 =【單選 / 複選 / 下拉選單】
→ 請將「類型：文字」調整為「類型：物件 / 陣列」
流程

涉及功能：外部程式站點、簽核事件

檢查項目：
- 參數來源 =【單選 / 複選 / 下拉選單】
→ 請將「類型：文字」調整為「類型：物件 / 陣列」
外掛模組（外掛欄位）

若使用跨欄位取值：getTargetFieldValue且來源為【單選 / 複選 / 下拉選單】

→ 接收到的是「物件資料」格式，請依新的資料結構調整程式取得欄位資料
外部起單

若有使用外部起單功能，且表單欄位包含【單選 / 複選 / 下拉選單】

→ 請將套件版本升級至 EDE.UOFX.PubApi.Sdk.NetStd 2.4.1

調整指南：

💡 表單欄位格式傳出值

相容性提醒

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

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

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

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

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

🛠️ 說明：上述新方法皆整合於 fieldUtils 與 pluginUtils 工具中，提供更一致的欄位操作方式。

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