低版本協同升級到V5 8.0適配說明 · CAP開發文檔

# 關于協同升級到V5 8.0版本之后，自定義控件適配的說明 ***特別說明，本說明適用于場景：自定義控件基于V5 8.0以前版本開發的，并且需要在V5 8.0既以上版本使用的需要適配，如果是繼續在V5 8.0版本以前使用，不需要進行這個適配。另外，如果是基于V5 8.0既以上版本開發的，則不需要適配。*** 應公司最新的戰略需求，CAP4應用需要支持同一個應用重復安裝多次，并能用原始包對這些已安裝的包都能進行升級。所以在這期間CAP4對應用包的安裝和導出（包括單表單導出和導入）進行了改造，重新設計了各元數據ID的編碼映射機制，保證應用重復安裝之后，可以平滑進行數據升級。 - **為什么要適配**：如果不進行處理，可能自定義控件上的數據定義就不是有效的內容，這樣會影響運行時的數據。首先說下為什么需要自定義控件開發進行適配，原因是：新的編碼映射機制設計了三張表，分別存放應用上的數據，表單上的數據，公共數據（包括枚舉和常量等），如果不進行適配，原來的接口不知道該將數據映射落位到什么地方，也不知道該從那個地方獲取其他模塊已經重置的元數據ID。 - **怎么判斷是否需要適配**：檢查自己實現`FormFieldCustomCtrl`接口的所有自定義控件，是否重寫了`getJson4Export`、`importExtInfo`、`importInfoAfterBizImport`這幾個方法，并且檢查這幾個方法內，是否用到了`BusinessDataBean`中被標注為過時（`@Deprecated`）的方法，比如：`genNewIdByOldId`，`getEnumMapOld2New`，`getRealId4Export`，`getRealId4Upgrade`等方法。 - **怎么改**：將上述被標記過時的方法，替換為`BusinessDataBean`中新的接口，接口說明，見方法上的備注： ```java 導出應用相關的接口 /** * 通過當前資源id，獲取業務編碼。 * 注：該方法僅用于獲取應用id，表單id，枚舉id對應的編碼 * 其他id編碼請調用{@link #lookupBizKey(MappingField,Long,Long)} * @param table 映射表分類 * @param sourceId 資源id，應用id，表單id，枚舉id * @return */ public Long lookupBizKey(MappingTable table, Long sourceId)｛｝ /** * 通過當前資源id，獲取業務編碼。需要傳遞 * 注：該方法僅用于公共數據，比如枚舉和常量函數使用 * 其他id編碼請調用{@link #lookupBizKey(MappingField,Long,Long)} * @param table 映射表分類 * @param sourceId 資源id，應用id，表單id，枚舉id * @param orgAccountId 枚舉和常量的單位id，如果為集團公用的，沒有單位id的，直接傳null * @return */ public Long lookupBizKey4CommonData(MappingTable table,Long sourceId,Long orgAccountId)｛｝ /** * 通過當前二級數據id和資源id，獲取對應業務編碼。 * 其他id編碼請調用{@link #lookupBizKey(MappingTable,Long)} * @param field 字段分類枚舉 * @param sourceId 資源id，應用id，表單id，枚舉id * @param dataId 二級數據id * @return */ public Long lookupBizKey(MappingField field,Long sourceId,Long dataId){} ``` ```java 安裝相關的接口 /** * 只是獲取編碼id對應的資源Id，如果沒有返回null * @param table 表分類 * @param bizKey JSON中解析出來的資源Id * @return */ public Long onlyGetRootId(MappingTable table,Long bizKey){} /** * 只獲取編碼id對應的當前數據id，沒有返回null，不會生成新id返回 * @param field 映射表字段分類 * @param sourceId 資源id * @param bizKey 原二級數據id * @return */ public Long onlyGetSubId(MappingField field,Long sourceId,Long bizKey){} ``` 此處僅寫了幾個比較通用的接口，其他的接口請移步`BusinessDataBean`中查看。