1. 概述
1.1 版本
| FineBI 版本 | JAR 包 | 新增內容 |
|---|---|---|
| 5.1 | 2020-01-15 | - |
| 5.1.5 | 2020-08-04 | Excel 更新不跟隨 業務包更新 和 全局更新 |
| 5.1.9 | 2021-01-06 | 支援多 sheet 匯入；更改「追加上傳」與「重新上傳」為「追加資料」和「更換資料」 |
注：2020-01-15 之前版本的 BI ，兩種更新 Excel 的方式均需要保證重新上傳的 Excel 表與原先的版本一致、表結構一致，即欄位名稱、欄位順序均一致。有資料表編輯權限的使用者在更新 Excel 的時候可以對原先的欄位型別進行修改再更新。
1.2 應用場景
使用者需要對 Excel 進行更新的時候，可以使用「更新 Excel」功能。
1.3 功能介紹
支援「追加資料」與「更換資料」的操作。
追加資料：是指在原先上傳的 Excel 資料表基礎上追加增量資料。
更換資料：是指上傳新的 Excel ，更換掉原先上傳的資料。
注1：在對 Excel 資料集中的欄位型別進行修改時，無論是在表編輯介面，還是更新 Excel 介面，均以最後一次修改的型別生效。
注2：Excel 資料集不支援實時更新。
2. 操作步驟
1）進入「資料準備」，選擇你要更新的 Excel 資料集，點選「更新excel」按鈕，如下圖所示：
注：有編輯權限的 Excel資料集才會有「更新 Excel」按鈕。
2）進入到 Excel 更新頁面，可以看到有兩種更新方式：「追加資料」和「替換資料」。
2.1 追加資料
追加資料即將上傳的 Excel 資料作為新增資料，新增到原資料後面。追加資料不會影響之前的原資料。
1）選擇要追加的 Excel 檔案，點選開啟，如下圖所示：
2）使用者需要勾選自己需要的 sheet 頁。若 Excel 檔案就只有一個 sheet ，直接上傳就可以。點選「確定」，如下圖所示：
3）追加資料成功後，頁面提示「Excel 追加資料成功」，並可以在最後看到追加的華東的資料。如下圖所示：
追加資料的上傳邏輯
| 情況 | 上傳方式 |
| 追加表中有新欄位（新欄位與原表所有的欄位名稱都不相同） | 忽略新欄位，不追加資料到原表中 |
| 追加表中缺少欄位（原表中有該欄位，但追加表中沒有欄位名稱與之相同的進行匹配） | 在上傳以後的追加資料的那部分，原表該欄位對應的值為空值 |
| 追加表中的欄位型別和原表的欄位型別不同 | 根據欄位型別轉換為原表的型別 |
| 追加表中有重複欄位 | 按照欄位出現的先後順序進行對應 |
2.2 替換資料
重新上傳是指將資料更換為新上傳的 Excel 資料。
1）點選「更新Excel>更換資料」，選擇要更換資料的 Excel 檔案，如下圖所示：
2）使用者選擇自己需要上傳的 sheet 頁，點選「確定」。如下圖所示：
3）上傳成功後， FineBI 提示「Excel 上傳成功」，如下圖所示：
更換資料的上傳邏輯
| 情況 | 上傳方式 |
| 更換表中有新欄位（新欄位就是與原表所有的欄位名稱都不相同的欄位） | 增加該欄位 |
| 更換表中缺少欄位（原表中有的欄位，更換表中沒有欄位名與之一致的欄位） | 上傳成功後，欄位值都為 null |
| 更換表中的欄位型別和原表的欄位型別不同 | 根據欄位型別轉換規則轉換為當前 Excel 的型別 |
| 更換表中有重複欄位 | 按照欄位的出現的先後順序進行對應，即重新上傳不改變原欄位名順序 |
3. Excel 資料集更新說明
3.1 會觸發 Excel 更新的操作
進行一些操作會觸發Excel資料集的更新，如下所示：
| 操作 | 更新內容 | 聯動 |
|---|---|---|
| 上傳 Excel 資料集，成功儲存該資料集後 | 立即更新資料集本身 | 无关联 |
| 修改一個已經成功更新過的的 Excel 資料集的欄位型別 | 立即更新資料集本身 | 更新存在的聯動 |
| 重新上傳一個Excel資料集，成功儲存該資料集後 | 立即更新資料集本身 | 更新存在的聯動 |
| 追加上傳一個Excel資料集，成功儲存該資料集後 | 立即更新資料集本身 | 更新存在的聯動 |
注1：在業務包更新時，業務包下的 Excel 資料集不會同時更新。
注2：全局更新時，某特定 Excel 資料集所在的某特定業務包配置為跟隨全局更新而更新，Excel 資料集不跟隨更新。