数据集成

> 动态替换作品内容，可实现动态数据/内容填充，实现制作提效或访客千人千面的应用需求；

在动态替换作品内容时，要替换的数据来源支持两种：接口方式和Excel导入方式。

## 接口方式

### 制作流程
1. 开发接口，按照《查询动态数据》接口规范开发获取动态数据的接口。
2. 配置接口，在控制台-集成管理-数据集成中配置开发的接口。
3. 制作作品，创建作品，并配置动态替换的内容。
4. 访客打开作品，根据接口返回的内容动态展示作品内容。

#### 配置接口
在控制台-集成管理-数据集成中添加接口。
![](/media/202511/2025-11-14_115451_4156300.194208948838968.png)
- 接口地址：第1步开发好的接口地址。
- 接口入参：在请求接口时携带的参数。
  - 参数类型：
  （1）内置参数：接口默认携带，不用配置。
  （2）URL参数：配置后若访问活动链接上有该字段则会携带。
  （3）表单参数：配置后若作品有表单组件绑定有该字段则会携带。
  （4）自定义。配置后接口默认携带该字段。
  - 字段：请求接口时的字段名。
- 接口出参：接口返回的参数。
  - 字段：响应的字段名，在配置作品时动态替换的名字，注意遵循一般代码的字段命名规则，不要添加一些特殊符号，如@、&等。
  - 类型：字段的类型，包含文本、图片和图表，其中图表应用于图表组件。
 
#### 制作作品
##### （1）创建作品
##### （2）开启数据集成
进入H5编辑器-预览设置-动态渲染-选择“开启”。

##### （3）配置字段
  - 设置入参字段
![](/media/202312/2023-12-06_133329_7716250.5137115808095243.gif)
  - 设置显示文本字段
![](/media/202312/2023-12-06_133746_3690400.5367608896212798.gif)
注意：如果接口字段返回数据为0或者空时，可以设置字段显示方式。
![](/media/202401/2024-01-05_092017_2173720.002567611198288633.png)
  - 设置显示图表
![](/media/202312/2023-12-06_134615_3503510.6408541530141034.gif)
  - 设置组合组件
![](/media/202401/2024-01-16_141028_3145200.6146415277220876.gif)
  - 设置视频组件
![](/media/202401/2024-01-16_143318_6503110.4737629572649692.gif)
  - 设置轮播图组件
![](/media/202402/2024-02-01_142531_5905530.3724192977389268.gif)
### 接口规范
- 接口描述：查询动态数据
- 请求方式：POST
- Content-Type：application/json
- 接口入参（开启加密）：
| 参数名 | 是否必须 | 参数类型 | 参数说明 |
| --- | --- | --- | --- |
| timestamp | 必须 | String | 请求时的时间戳 |
| nonce | 必须 | String | 随机字符串 |
| signature | 必须 | String | 请求签名 |
| msgEncrypt | 必须 | String | 加密后的消息，解密后的参数同不开启加密的参数 |
- 接口入参（不开启加密）
| 参数名 | 必须 | 参数类型 | 参数说明 |
| --- | --- | --- | --- |
| creationId | 是 | Long | 默认携带。作品id |
| creationCode | 是 | String | 默认携带。作品code |
| encodeId | 否 | String | 默认携带。 在内容中台测唯一身份标识|
| channelKey | 否 | String | 默认携带。渠道编码，对应访客信息接口返回channelKey，若未返回则有一个默认值 |
| headImgUrl | 否 | String | 默认携带。 访客头像|
| nickName | 否 | String | 默认携带。访客昵称 |
| unionId | 否 | String | 默认携带。unionId |
| thirdAppId | 否 | String | 默认携带。微信授权的appId |
| mobile | 否 | String | 默认携带。 手机号|
| openId | 否 | String | 默认携带。微信openId，微信授权有效 |
| thirdUserId | 否 | String | 默认携带。自定义授权的userId，自定义授权有效 |
| ...... | 否 | String | 其他url、表单、自定义参数根据在数据集成的设置传递 |

- 请求示例
```json
{
    "openId": "oYy90xOy-sGx2_kiOYb2E2KcOIvA",
    "thirdUserId": "d0c8e4a470aa482b9720075d0859cdc2"
}
```

- 返回示例
```json
{
     "name":"XXX",
     "age":"A0001",
     "sex":"A0001",
     "chartXAxis": ['1月份'， '2月份'， '3月份', '4月份数据'], // 图表字段设置的“横轴数据”格式，即图表的维度字段。
     "chartYAxisData1": ["110","80","80","80"], // 图表字段返回的“图例”格式，即图表的数值字段，其中1、2、3分别对应图例1、图例2、图例3...
     "chartYAxisData2": ["90","80","80","80"],
     "chartYAxisData3": ["50","50","50","50"],
	 "groupField1": { // 组合组件出参字段配置方式一
      "name": "name",
	  "age": "age"
	  },
    "groupField2": { // 组合组件出参字段配置方式二，__EQX_DYN_TYPE和data是固定属性，生成循环组件
    "__EQX_DYN_TYPE": "list",
	"data": 
		[
			{
			"name": "name",
			"age": "age"
			},
			{	
			"name": "name",
			"age": "age"
			}
		]
	},
	"video1": "http://test-asset.eqxiu.cn/transcode/fe275256ce5b4bf5bc73d04ad3cb531c.mp4", // 视频出参字段配置方式一，参数类型【String】:只会修改视频链接
	"video2": { // 视频出参字段配置方式二，参数类型【Object】src和poster是固定属性，修改视频链接和视频封面，poster是封面字段
	"src": "http://test-asset.eqxiu.cn/transcode/c4bc513fa0f349c594bd1d9d9f450a0a.mp4",
	"poster": "https://test-asset.eqxiu.cn/8834deeb66184a81bd5345c1c0062f3e/2d95a624cfc24aa9895ce8fcd7082eea.png?imageMogr2/format/webp/quality/80/thumbnail/204x"
	}
}
```
- 稿件数据
以下数据格式为稿件任务获取稿件数据的数据规范。
-- 入参：
| 参数名 | 是否必须 | 参数类型 | 参数说明 |
| --- | --- | --- | --- |
| pageNo | 必须 | Integer | 第几页 |
| pageSize | 必须 | Integer | 每页多少条数据 |
| ... | | | 其他自定义入参 | 
-- 出参：
```json
{
    "total": 5, //总条数
    "pageNo": 1, //当前第几页
    "pageSize": 5, //每页多少条数据
    "end": false
	"records": [ //数据
        {
            "id": 14651993, //数据唯一标识，必须返回且字段名为id，其他字段可以自定义
            "title": "新闻",
			"linkUrl": "https://www.eqxiu.cn/article/14651993",
            "imgUrl": "https://asset.eqxiu.cn/article/14651993.png",
            "taskCompleted": "已完成"
        },
        {
            "id": 14651994,
            "title": "新闻",
			"linkUrl": "https://www.eqxiu.cn/article/14651994",
            "imgUrl": "https://asset.eqxiu.cn/article/14651994.png",
            "taskCompleted": "已完成"
        }
    ],
}
```

- 错误返回示例
```json
{
    "EQS_REQ_CODE":-1
}
```

## Excel导入方式
采用接口的方式需要开发接口。有时候有固定的数据，希望直接在这些数据里动态替换数据，而不想开发接口。就可以采取Excel导入的方式。

### 导入数据
设置字段。在资源-我的数据-新建
![](/media/202312/2023-12-06_135845_1526790.13319244648070538.png)
导入数据。设置好字段后点击保存-下载Excel示例模板-填写数据-上传Excel文件，上传后就可以看到数据
![](/media/202312/2023-12-06_140153_0713910.3762285362914134.png)

### 制作作品
制作作品的流程和接口的方式一样。