1. 概述
1.1 版本
| 版本 | 功能变动 |
|---|---|
| V1.0 | - |
| V1.2.6 |
|
1.2 应用场景
电商数据想要在 FineReport 中进行深入分析，首先需要将这些数据成功导入 FineReport ，本文将详细介绍如何将电商平台数据导入 FineReport。
1.3 功能简介
支持以下电商平台：
2. 前期准备
2.1 环境要求
一台能够同时连接到 FineReport 工程和外部网络的计算机，以确保能进行电商数据源的授权操作。
FineReport 工程所在服务器具备外网访问权限，或者可以配置白名单（添加白名单：dm.shukuajing.com），以确保电商数据源的数据能够成功传输到本地数据库。
服务器的带宽要求为20Mbps及以上。
本地数据库需采用 MySQL8，且编码选择 utf8mb4。数据库所在的计算机推荐使用固态硬盘，提高读写速度。
若 MySQL 数据库与 FineReport 工程之间可以通过内网连接，则建议使用内网通信方式。
FineReport 需要为 11.0 及以上版本。
2.2 安装插件
要获取不同的电商平台数据，需要安装对应的插件。这里我们以旺店通为例，安装旺店通的插件：
插件安装方法可参见：服务器插件管理。
安装后管理系统中会出现「应用数据源」，点击「连接管理」，选择「旺店通企业版」，会弹跳出配置引导页面。如下图所示：
3. 配置数据连接管理
我们要创建一个 MySQL 数据连接，作为存放第三方电商数据的目标数据库。
1）点击「前往数据连接管理」，建立 MySQL 与 FineReport 的连接关系，如下图所示：
2）连接步骤可参见：MySQL数据连接，效果如下图所示：
注1：填写的用户需要有以下数据库权限：SELECT、INSERT、UPDATE、DELETE、CREATE、ALTER、CREATE TEMPORARY TABLES，否则会更新失败；
注2：数据连接URL需要添加后缀 ?useUnicode=true&characterEncoding=UTF-8，否则中文会乱码；
3）回到引导页面，点击「下一步」，进入第②步：连接目标库，如下图所示：
4. 连接目标库
FineReport工程中可能建立了多个 MySQL 数据连接。系统不知道我们要把电商数据存放在哪个 MySQL 中，所以我们需要手动指定一个 MySQL 数据连接作为目标库。
下拉「目标库」选择本文第 3 节创建的数据连接 ecwork 作为目标库。点击「下一步」，进入第③步：安装插件，如下图所示：
5. 安装插件
若没有安装插件，需要：
点击「前往插件管理」安装插件，安装教程可参见：服务器插件管理
联系帆软销售顾问获得插件 License 授权
在本示例中，我们已经在 2.2 节安装了「旺店通企业版」的插件并获得了授权。直接点击「下一步」进入到第④节：新增数据连接，如下图所示：
6. 新增数据连接
1）系统提示已完成初始设置，点击「前往新增数据连接」，如下图所示：
2）填写第三方电商平台的连接和授权信息，FineReport 需要获得第三方平台的授权，才可以将数据新增进来。如下图所示：
点击「如何获取授权信息」可以查看不同电商平台连接和获取授权的教程。
3）点击「确定」，即可将数据添加到数据列表中。如下图所示：
7. 同步数据
将第三方电商数据同步到 MySQL 数据库。
7.1 同步数据步骤
1）授权完成后，数据表出现在左侧列表。需要同步数据，才能将数据表导入到 MySQL 数据库中。点击「同步数据源」，可以对该数据源下的所有数据表先进行一次同步。
同步数据表有三种方式：
A同步数据源：同步数据源下的所有表
B同步表单：同步当前选择的单张表
C批量同步表：同步勾选的数据表
之后可以根据自己的实际需求，选择手动同步或者定时同步，避免全量同步等待时间过长。
注：如果您希望进行定时同步配置，请确保将 FR 系统的数据抽取时间设置在数据源同步完成之后。例如，如果数据源已配置每天 00:00 进行定时同步，00:30 数据完全抽入 MySQL 数据库。那么在 FR 系统中，建议将定时更新设置在每天 00:30 之后，例如设置在每天1:00。
2）查看同步状态，一共有四种同步状态，可点击「下拉箭头」进行筛选，如下图所示：
同步成功
同步失败
同步中
部分成功：一个数据源下的多个数据连接（站点），部分同步成功
点击状态按钮，可查看同步详情，特别是同步失败后，可查看失败原因。如下图所示：
7.2 辨别数据来源
此时进入 MySQL 数据库，即可看到入库的数据表。
辨别数据表的来源电商平台
所有电商平台的数据表都存储在一起。例如，如果同时授权了金蝶云星空和亚马逊的数据源，那么产生的金蝶云星空数据表和亚马逊数据表都会存在于同一个 MySQL 库中。
若要区分表属于哪个数据源，可以通过表名的不同前缀来实现。例如，以 11020 开头的表是金蝶云星空的表，以 7 开头的表是亚马逊的表。
| 开头数字 | 电商平台 |
|---|---|
| 7 | 亚马逊 |
9 | Lazada |
| 10 | shopee |
| 12 | 店匠 |
| 13 | Shoppify |
| 16 | Google Analysis |
| 17 | |
| 22 | AliExpress |
10001 | Wakmart |
10003 | 旺店通（企业版） |
| 10004 | 聚水潭 |
10005 | 旺店通（旗舰版） |
| 10006 | Wayfair |
| 10008 | 万里牛（Beta） |
| 10009 | 金蝶管易云C-ERP数智版（Beta） |
| 10010 | TikTok Shop（Beta） |
| 11012 | 小红书评论（Beta） |
| 11013 | 抖音评论（Beta） |
| 11014 | 淘宝评论（Beta） |
| 11015 | 美团（Beta） |
| 11020 | 金蝶云星空（Beta） |
对来自同个电商平台不同站点的数据，进行区分
例如：客户的亚马逊平台，可能拥有美国，加拿大、等多个站点。如此需要建立多个数据连接，每个数据连接都拥有自己的 connectId，如下图所示：
加拿大和美国多个站点的数据都储存在同一张表中。在进行分析时，我们如何区分哪些数据来自美国，哪些来自加拿大呢？
在数据表中，有一个名为 「__dm_connect_id 」的字段，我们可以通过该字段来识别数据的来源，即哪个数据连接（站点）提供的。若只需看部分站点的数据，直接对该字段进行筛选即可。
8. 添加数据库的表至FineReport
详情请参见：数据集
9. 补充说明
9.1 新增数据连接
若需要添加多个电商平台的数据到 FineReport 中进行分析，可点击「新增数据连接」，如下图所示：
9.2 更改目标库
若想要更换目标数据库，可在「连接目标库」中点击「编辑」按钮进行调整，如下图所示：
