1. 概述编辑
1.1 应用简介
用户需要将本地的 Excel 数据上传至九数云中进行分析，但本地数据会经常更新。如果一个个更新数据，会耗费很多时间。
而使用 agent 客户端，可以直接连接本地电脑文件夹，获取文件夹中的 Excel 表、csv 表。当本地文件夹中的表数据发生变化，agent可以自动获取更新。
1.2 功能简介
1）九数云同步宝支持获取连接本地电脑文件夹，获取文件夹中的（包含子文件夹中的）Excel 表、csv 表。
2）当本地文件夹中的表数据发生变化时，九数云同步宝自动获取更新，并显示在本地数据源中。
3）若 Excel 表中包含多个 sheet 页，客户端会将每个 sheet 页拆分成一表。若想要合并表，先根据第 2 节内容连接好本地文件夹后，根据第 3 节内容将多表合并成一张表。
1.3 注意事项
仅高级版/企业版用户可使用「本地数据源」功能，免费版用户需升级版本，详情参见：报价咨询。
在连接本地文件夹前，需确定好本地文件夹位置，以及文件夹名称，再根据本文的操作步骤连接本地文件夹。若连接好本地文件夹后，再更改文件夹位置或者文件夹名称，数据连接会失效，需要按照第 2 节的步骤重新连接本地文件夹。
若想要实现本地数据变化，九数云同步变化，需要保持九数云同步宝一直开启。若数据变化时，九数云同步宝是未开启状态，开启后，需要手动同步一下这张表。
2. 连接本地文件夹编辑
2.1 准备条件
1）从下表中下载适合自己操作系统的连接器，并安装：
| 操作系统 | 下载地址 |
|---|---|
| Windows 64位（推荐） | |
| mac | |
| Linux |
2）安装完成后，请根据接下来的步骤连接本地文件夹。
2.2 添加本地数据源
1）进入数据连接市场，新增「飞书表格」数据源。如下图所示：
2）选择节点，点击「下载配置文件」按钮，如下图所示：
4）打开下载的压缩包，直接右击复制 config.yaml 文件，如下图所示：
5）打开2.1 节下载的九数云同步宝，按照步骤点击「从剪贴板导入」，这样可以直接导入文件中的配置内容，如下图所示：
注：请确认数据源标识（agentID）是否与九数云节点的 AgentID 是否一致，不一致的话需要重新导入。
6）点击左上角「+」按钮添加一个本地目录的数据源，如下图所示：
7）在弹窗中，选择好本地文件夹所在目录，并设置文件夹读取策略。相关说明如下表所示：
| 功能点 | 说明 |
|---|---|
| 分组名 | 自定义分组名称、方便识别 注：分组名不要包含「&」，该符号无法同步显示在九数云的数据源界面中 |
| 目录 |
|
| 文件夹读取策略 | 客户端文件读取策略有三种，具体执行情况如下，请根据自己的需求选择合适的策略：
|
8）当前配置已经发生了变化，点击左上角的「保存」按钮使配置生效，如下图所示：
9）这样客户端获取的表就会显示在本地数据源中，如下图所示：
2.3 数据源协作
创建者默认拥有数据源的管理权限，管理者可将此数据源分配给其他成员使用。
点击「权限设置」按钮，在弹窗中即可自定义配置数据源权限，详情参见文档：数据源权限设置
2.4 使用数据
添加好数据后，可以将数据表添加到团队的项目中，进一步的分析。
注：这里的位置，是指当前数据源界面所在团队的项目中。比如 A 从 团队 1 中进入数据源界面，这些数据只能添加到团队 1 中的项目中。
3. 合并表编辑
如果用户每天要从其他平台中导出 Excel ，且 Excel 的格式都是一样的，可以在客户端中进行设置，自动追加成一张表，无需再使用上下合并。
请用户先根据 2.1 、2.2 节链接好本地文件夹后，再进行接下来的操作。
3.1 操作步骤
1）在本地目录下，新建一张表作为合并表。如下图所示：
2）在弹窗中设置好信息，相关的说明见下表：
| 设置 | 说明 |
|---|---|
| 表名 | 自定义表的名称 |
| 表来源策略 | 有两大类策略： 1）单文件作为一个表：单个 Excel 表作为一张表 2）追加文件内所有文件为一个表：有四种排序策略【按创建时间、按修改时间、按文件名（编码顺序）、按文件名（自然顺序）】，根据顺序排列，将第一个表的表头作为合并表的表头，后续表的数据依次填充进合并表。请选择好排序策略。 |
若选择 追加文件内所有文件为一个表，可以设置仅读取当前目录/递归读取所有子目录：
| |
| 列判断策略 | 有两种列判断策略：
|
| 文件路径 | 需要选择父节点下的子文件或者子目录。
|
| 文件密码 | 若文件设置了加密，则输入密码；若文件没有加密，则保持为空即可。 |
| sheet 选择策略 | 有三种选择策略：
|
| 表头行序号 | 设置表头所在的行号，若表头在第 2 行，那么这里的序号选择 2。 注：若表头行为空，表会标红报错。用户可查看一下自己数据的表头行，并对此配置进行设置。 |
3.2 示例
1）在「数据表>签约表示例数据」文件夹中，有各城市的签约信息。且这些表的结构都是一样的，希望能通过 agent 自动将这三张表合并为一张签约信息表。如下图所示：
2）根据 2.1 、2.2 节的操作，添加一个本地文件夹目录。如下图所示：
3）根据 3.1 节的操作，添加一张合并表，按照修改时间追加所有的签约表为一张表。如下图所示：
4）设置完成后，可以点击小眼睛眼看当前设置下，合并表的顺序。如下图所示：
5）那么在九数云中会增加一张合并后的表，包含文件夹中所有表的数据。且后续在「签约表示例数据」中再增加其他城市表，那么九数云中也会自动合并。如下图所示：
4. 同步数据编辑
1）若本地的 Excel 文件更新了，agent 获取的数据也会同步更新，也就是数据源界面的本地文件夹的数据是实时更新的。
2）若将数据添加到项目中使用，项目中的数据也会自动更新，但有默认 3min 最小间隔时间。
比如本地的 Excel 文件在 12 点操作更新了一次，添加进项目的表自动更新了，下一次本地 Excel 更新时间最好在 3min之后。
5. 其他说明编辑
如果将 agent 客户端安装在 centos系统上，可能会因为没安装字体文件，导致安装失败，如下图所示：
解决方法：
可以先直接执行命令安装下字体，然后再进行九数云agent客户端的安装。
Ubuntu系统执行的命令是：apt-get install fontconfig；
Centos执行的命令是：yum install fontconfig