Excel批量匯入插件

1.1 應用場景

在需要匯入Excel進行提交入庫的場景下，如果Excel資料量較大，匯入時會給瀏覽器造成比較大的負擔，甚至導致頁面當機。

使用「Excel批量匯入」插件可以在不預覽範本的情況下進行多Excel檔案的匯入提交，適用於沒有在頁面上修改資料需求的場景。

注：不支援行動端使用。

1.2 功能邏輯

1）匯入和提交會一起執行，不需要預覽相關範本。

2）功能入口屬於平台，所以支援分配權限操作。

3）支援選擇多個Excel進行匯入。

4）支援資料校驗設定，但不支援web屬性中的填報事件設定。

5）Excel匯入邏輯與「普通Excel匯入」一致

6）批量匯入時，預設使用增量匯入規則，而非瀏覽器匯入時預設改寫匯入。

      如不希望最終資料重複入庫，請勿在填報範本中預設查詢出資料庫的資料。

2.1 插件安裝

點選下載插件：Excel 批量匯入

設計器插件安裝方法請參見：設計器插件管理

伺服器安裝插件方法請參見：伺服器插件管理

2.2 新增連結節點

管理者登入FineReport系統，點選「管理系統>目錄管理>管理目錄>填報錄入>新增連結」。

• 連結名稱：批量匯入

• 連結路徑：/webroot/decision/url/excel/submit

• 展示終端：PC

點選「確定」。如下圖所示：

2.3 分配連結權限

點選「管理系統>權限管理」，選中人力資源部門的「部長」職位，為其分配「批量匯入」的查看權限。如下圖所示：

2.4 新增批量匯入任務

1）點選目錄>填報錄入>批量匯入，點選新增任務按鈕，任務名稱為任務一，選擇範本%FR_HOME%\webapps\webroot\WEB-INF\reportlets\doc\SpecialSubject|\ExcelImport\ImportSubmitVerify.cpt

注：次級管理者不能進行新增任務、刪除任務的操作。

2）新增完成後，可對「任務列表」裏的任務執行匯入、編輯、刪除的操作，如下圖所示：

3）點選任務權限，選中人力資源部長，將任務一的查看權限分配給人力資源部長職位。如下圖所示：

2.5 效果查看

點選下載excelimport.xls表：excelimport.xls

使用人力資源部長 Lily 的帳號登入數據決策系統，FineReport 內建所有使用者密碼均為 123456 。

點選填報錄入>批量匯入，可看到批量匯入連結裏只有任務一，點選匯入按鈕，選擇Excel進行匯入，如下圖所示：

Excel 批量匯入功能如果在執行匯入提交的程式中出現問題，會中止程式並給出錯誤提示。常見的錯誤有2種，資料校驗失敗和提交失敗，具體範例如下。

3.1 資料校驗失敗

1）為範本設定資料校驗， F3 儲存格的值必須在 0 到 1000 之間，若不在 0 到 1000 中間就彈出錯誤資訊，如下圖所示：

2）修改 excelimport.xls，修改「成本價」欄位資料，使之不符合資料校驗規則，如下圖所示：

3）重新匯入 Excel，提示校驗出錯，如下圖所示：

4）點選提示資訊按鈕，可看到錯誤資訊的內容，如下圖所示：

5）點選下載勘錯檔案，會自動下載wrong.xls檔案。開啟該檔案，可看到被標記為紅色背景的錯誤儲存格，如下圖所示：

3.2 填報入庫失敗

如果出現下圖所示報錯，則表示失敗原因為提交入庫失敗，此時可以排查對應範本是否存在設定問題。

雖然批量匯入省去了預覽範本的程式，但是其效能仍然有一定的上限。建議 Excel 資料總量（行×列）在 200w 以下，否則匯入會佔用較多伺服器資源，且時間較長。超過25min時，進程會被消除並傳回 process is null/timeout 的報錯。