View source for 导入模块

<!-- BEGIN interlang links -->
<!-- Do NOT edit this section
     Links below are automatically managed by PolyglotBot
     You can edit links on the English source page : Module_Imports -->
[[en:Module_Imports]]
[[fr:Module_Imports FR]]
[[es:Módulo_Importaciones]]
<!-- END interlang links -->

[[Category:管理]]
{{Template用户手册}}
{{TemplateModZH}}
{{模块模板|
name=导入|
num=250|
devdoc=本页|
userdoc=本页}}

=简介=
要将现有/遗留的数据批量导入Dolibarr，有几种可能的方法。本页介绍使用内置的导入模块的首选方法。 

其他解决方案在页面 [[批量导入]] 中介绍。
=安装=
{{NoInstallModuleZh}}

=设置=
{{ActivationModuleZh}}

另请参阅页面 [[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 用以修复此问题：

<source lang="sql">UPDATE `llx_societe` SET `fk_stcomm` = '0' WHERE fk_stcomm IS NULL</source>

*导入产品

使用本模块导入产品后，系统不显示这部分数据，需要将产品类型（llx-product.fk-product-type）从 NULL 更改为“0”（需要有关可能值的详细信息）。

导入后要执行以下 SQL 用以修复此问题：

<source lang="sql">UPDATE `llx_product` SET `fk_product_type` = '0' WHERE fk_product_type IS NULL</source>

=用例示例=
{{ExamplesCaseZh|actions=前往菜单“工具->导入助手->新建导入”并选择产品和服务|situation=我有一个包含3000个产品的Excel文件。我想将它们导入Dolibarr。|nom=UCMI01：}}

&nbsp;

{{ExamplesCaseZh|actions=前往菜单“工具->导入助手->新建导入”并选择合作方|nom=UCMI02：|situation=我有一个包含1000个准客户的文本文件。我想将它们导入Dolibarr。}}

&nbsp;