Excel匯入簡介

1. FineReport 支援填報時將 Excel 中的資料直接匯入到填報頁面，如下圖所示。

1. 目前支援的匯入方式如下圖所示。

2. 下表列出每種方式的說明和詳細文檔超級連結。

1. 匯入邏輯需要安裝Excel匯入邏輯設置插件後才可以修改，Excel匯入邏輯設定文檔參見：D02-00 Excel匯入邏輯設定。目前的匯入邏輯如下表所示。

注：【標記匯入】有自己的匯入邏輯，不受此匯入邏輯設定插件的影響。

1. 由於Excel和帆軟範本的自由化程度很高，所以除了【標記匯入】外的Excel匯入方式無法保證相容每一種場景。下面列出當前支援的和不支援的一些場景，以供參考。

1

支援場景。

注：場景4中，如果Excel中不存在這些內容，則可以直接匯入。如果Excel中也存在這些內容，則需要使用自訂匯入的選擇匯入列功能才可以正常匯入資料。

序號	場景	圖示
1	單列表頭，表頭部分無橫向擴展。
2	單列表頭，表頭部分存在一個橫向擴展。
3	匯入區域上方有標題或其它不擴展的固定內容。
4	匯入區域下方有不擴展的固定內容 。
5	自由報表，不存在擴展儲存格。

2

不支援場景。

注：如果範本預覽時的樣式和Excel完全一致，則會觸發位置匹配，此時支援所有格式。以下不支援場景的前提是觸發不了位置匹配。

序號	場景	圖示
1	多層表頭。
2	表頭部分多個橫向擴展。
3	匯入區域有多列擴展欄。
4	匯入區域裏一個父格對應多個子格。
5	匯入區域由多個資料集組成。

1. 針對常見的一些Excel匯入問題，以下總結幾條範本配置的基礎規範。

2. 匯入區域存在資料欄位時，需要設定成列表展示。當前匯入只支援列表。

3. 匯入區域的儲存格，需設定成可擴展。其他部分則不建議設定為擴展，可能會干擾後台程式判斷。

4. 匯入區域表頭存在橫向擴展，而匯入區域是縱向擴展的場景，需要開啓【雙向擴展格】匯入。

5. 儘可能使用Microsoft Excel 2007及以上版本，對於WPS Excel和Microsoft Excel低版本不保證相容。

6. 建議範本的匯入區域表頭部分，設計成和Excel表頭部分一致。

1. 匯入Excel時不會觸發元件自身設定的校驗規則，可以使用報表填報屬性設定中的資料校驗功能來設定。

2. 範本中設定了公式的儲存格，如果在匯入Excel時被Excel中的資料改寫了，則無法再觸發公式關聯計算的效果。

3. 資料量(列*欄)超過10w的匯入，可以考慮使用【批量匯入】功能。

4. 10.0.19.2版本（2021.10.15jar）後，匯入範本中如果存在彙總類計算公式（max，sum等），且涉及到的資料量較多的話，可能會觸發智慧運維的智慧釋放功能，造成Excel匯入終止。此時可以簡化公式，避免將公式放在擴展欄中，或者聯絡技術支援協助優化。

5. 如果遇到所有Excel都無法匯入的問題，可以檢查下是否是因為網路限制，導致上傳檔案請求阻擋了。例如nginx的【client_max_body_size】設定，預設為1M，就會影響到檔案上傳和Excel匯入，使得超過1M的檔案無法上傳。

6. 不支援匯入圖片。