建置號碼 2.116.x
升級注意事項（2025R1 → 2025R2.116.1）¶
建議更新方式¶
若您暫時不打算使用 Web 上傳元件或透過 UofxUserSetPluginHelper 取得 UserSetModel 等新功能，
只需更新套件版本即可，程式碼無須調整。
但請留意，以下有幾個舊用法將於 2025R4 版本正式移除，建議儘早做好調整準備。
版本相容性檢查清單
UOF X 升級後，請確認以下項目，以避免正式環境發生不相容問題：
- 您的外掛模組已在指定的 UOF X 版本上完整測試
- 參考 @uofx/plugin 版本對應表 確認對應關係
- 有疑慮時，請先於測試環境中驗證，避免直接部署至正式環境
套件版本更新¶
請更新以下 UOF X 套件至指定版本，確保相容性與最新功能：
| 套件名稱 | 版本 |
|---|---|
| @uofx/web-components | 4.16.14 |
| @uofx/app-components | 3.15.0 |
| @uofx/core | 3.9.0 |
| @uofx/error-code | 2.14.0 |
| @uofx/icon | 2.9.0 |
| @uofx/plugin | 4.3.2 |
直接安裝指令如下：
npm install @uofx/web-components@4.16.14 @uofx/app-components@3.15.0 @uofx/core@3.9.0 @uofx/error-code@2.14.0 @uofx/icon@2.9.0 @uofx/plugin@4.3.2
更新後需要額外安裝套件: @mescius/dspdfviewer。
Note
若程式在執行時，於開發人員工具中出現訊息 gc-pdfpane has already been used，即可能未正確安裝 @uofx/plugin，請移除 node_modules 後重新安裝。
🔧 外掛欄位升級注意事項¶
⚠️ 舊用法將於 2025R4 移除，請儘早調整¶
以下方法將於 2025R4 版本起正式移除，為避免未來相容性問題，請務必升級至新寫法：
| 舊用法 | 新用法 |
|---|---|
| this.addFormControl | this.fieldUtil.addFormControl |
| this.initPluginSettings | this.pluginUtils.initPluginSettings |
| this.getTargetFieldValue | this.pluginUtils.getTargetFieldValue |
🛠️ 說明：上述新方法皆整合於
fieldUtils與pluginUtils工具中，提供更一致的欄位操作方式。
調整¶
1. API 攔截器預設關閉¶
ApiSignatureMiddleware 預設已關閉，減少開發初期干擾。
若需啟可至 Ede.Uofx.Customize.Web/Program.cs，將下列程式碼取消註解：
2. App 尚未支援面板功能¶
目前 App 尚未支援面板功能，待支援後會再另行公告。
在 panels-design.json 中，為避免誤用，已將 App 的預設面板設定清空：
✨ 新功能介紹¶
Web¶
1. 上傳檔案元件¶
新增共用 Web 元件 FileUpload，支援在外掛模組中整合檔案上傳功能。
💡 詳細使用方式請參考：上傳檔案元件說明
2. 使用 UofxUserSetPluginHelper 快速取得 UserSetModel¶
可依人員帳號、部門代號、職級與職務代號組合出 UserSetModel，常用於：
- 設定選人元件預設值
- 設定簽核站點
💡 詳細使用方式請參考：選人元件與 UserSetModel
App¶
UofxUserSetPluginHelper 同樣支援 App 使用情境，使用方式與 Web 相同，可取得 UserSetModel 進行資料設定與簽核處理。
若您仍使用舊寫法，建議立即進行調整，以確保後續版本升級不受影響。如需支援，歡迎聯繫我們的技術團隊。