導入模塊

導入
模塊ID	250
用戶手冊	本頁
開發文檔	本頁

簡介

要將現有/遺留的數據批量導入Dolibarr，有幾種可能的方法。本頁介紹使用內置的導入模塊的首選方法。

其他解決方案在頁面批量導入中介紹。

安裝

該模塊包含在 Dolibarr 發行版中，因此無需安裝。

設置

要使用此模塊，必須首先使用管理員帳戶通過菜單選項 "主頁 - 設置 - 模塊"啟用它：

選擇列出模塊的選項卡。然後點擊 "激活"。。

模塊現在已激活。

如果在該模塊的行尾出現一個齒輪圖標，則單擊它以訪問特定於模塊的設置頁面。

另請參閱頁面 Setup Other ，以修改導入/導出CSV文件的分隔符和字符集（charset）。

使用方法

導入遺留數據可能需要多次嘗試/修改源文件才能成功導入。

建議使用 LibreOffice/OpenOffice 來「構建」單個源電子表格（.ods），並在每次修改/更正後重複地另存為CSV，因為字符集 handling/csv 結構定義在多字節（acccented）文本字符串方面遠優於Excel。

雖然大多數欄位的內容都是合乎邏輯的，但省份的地址數據（StateID）則不然。此欄位不能使用省的名稱導入（在不同國家/地區之間可能不是唯一的，例如「Florida」），但必須與表 llx_c_departements 中的整數 rowid 匹配。file欄位中的值應以「id:」為前綴，以確保強制導入檢查與rowid匹配。要將省份與 rowid 匹配，一種方法是使用SQL編輯器將表導出為CSV，然後將其與電子表格 VLOOKUP 函數一起使用以返回 rowid。這仍然需要手動檢查，因為在省份名稱重複的情況下，VLOOKUP只會返回第一個匹配項。

您可能會發現，您的遺留數據中有一些國家/地區/省份尚未被添加到Dolibarr中。在導入遺留數據之前，可以使用安裝文件中的 myqsl 查詢作為示例添加新的地區/省份。

要導入文件，請執行以下操作：

前往菜單「工具 - 導入助手 - 新建導入」
步驟 1：選擇一個預定義的數據集來匹配您的數據。通過單擊該行尾的按鈕選擇它。
步驟 2：通過單擊行尾的按鈕選擇要導入的文件格式 CSV/Excel (.xlsx) 。注意：您可以通過點擊「下載示例文件」下載一個空示例文件，其中包含有關允許的欄位值的信息/提示。
步驟 3：瀏覽並選擇要從您的計算機上傳到Dolibarr伺服器的文件。文件傳輸完成後，單擊行尾的按鈕進入下一步。
步驟 4：將文件欄位映射到數據集欄位。左列中是您上傳的文件中找到的欄位。右列中是Dolibarr中的可用欄位。您可以通過向上或向下拖動箭頭來移動左列中的欄位，以將輸入文件中的每個欄位都與對應的Dolibarr欄位對齊。如果要忽略/不導入源文件中的某個欄位，則應將其移動到"不導入的源文件欄位"的行下方。

注意：在行尾，將滑鼠懸停在問號上，會顯示Dolibarr對欄位輸入所期望的數據格式、約束和可能的值示例。映射完成後，您可以將映射保存為配置文件以供將來使用。點擊"下一步"繼續。

Step 5: 如果文件有列標題，則選中"不導入源文件的第一行"，然後點擊"啟動導入模擬"。模擬將檢查欄位中的值並顯示錯誤報告。如果沒有錯誤，可以點擊"啟動最終導入"來真正插入數據。導入的數據將添加到現有數據中。

所有導入到dolibarr中的數據行都會被附件一個 import_key 欄位，其值對應本條數據的導入日期。如果在數據導入後發現問題，則可以使用 SQL 查詢輕鬆地找到有問題的導入數據行。

已知問題

在 3.1 版本中可能存在以下問題。但它們已在更高的版本中被更正了。

導入合作方

使用本模塊導入合作方後，系統不顯示這部分數據，需要將潛在客戶狀態（llx_societe.fk_stcomm）從 NULL 更改為「0」（需要有關可能值的詳細信息；外鍵對應於表「llx_c_stcomm」）。

導入後要執行以下 SQL 用以修復此問題：

UPDATE `llx_societe` SET `fk_stcomm` = '0' WHERE fk_stcomm IS NULL

導入產品

使用本模塊導入產品後，系統不顯示這部分數據，需要將產品類型（llx-product.fk-product-type）從 NULL 更改為「0」（需要有關可能值的詳細信息）。

導入後要執行以下 SQL 用以修復此問題：

UPDATE `llx_product` SET `fk_product_type` = '0' WHERE fk_product_type IS NULL

用例示例

UCMI01：
場景	我有一個包含3000個產品的Excel文件。我想將它們導入Dolibarr。
操作	前往菜單「工具->導入助手->新建導入」並選擇產品和服務

UCMI02：
場景	我有一個包含1000個准客戶的文本文件。我想將它們導入Dolibarr。
操作	前往菜單「工具->導入助手->新建導入」並選擇合作方