导入模块

导入
模块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。
操作	前往菜单“工具->导入助手->新建导入”并选择合作方