导入模块

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