http写入

1 概述

1.1 版本

1.2 功能简介

目录:
1.概述
2.实例
3.制作过程
3.1 http写入界面
3.1.1 公共配置
3.1.2 请求配置
3.1.3 返回配置
3.2 实例制作
3.2.1 JSON类型
3.2.2 XML类型
4.总结

在复杂的多应用系统环境下的数据分析，考虑到系统间的数据安全，除了直接连接业务数据库进行数据查询回写外，往往需要通过调用外部系统已提供的http/https的数据接口将报表数据写入用户服务。而外部系统提供的接口规范不尽相同，乐创者支持通过接口数据方式，对来源自不同外部系统调用接口进行适配。

2 实例

通过接口数据写入客户信息，页面如下：

3 制作过程

3.1 http写入界面

实例制作的第一步就是登录设计器创建接口数据“http写入”，调用第三方提供的外部接口。
“数据”根目录或子目录右键执行“新建数据视图–》接口数据–》http写入”菜单，创建一个http写入接口数据，为报表的制作提供回写数据源。

进行http写入数据创建，需要进行以下配置：

3.1.1 公共配置

请求方式只支持POST请求；
地址：格式要求“http（s）://${域名}/${接口路径}”，用域名和接口路径来确定一个具体的接口；
启用认证：配置系统安全认证方式。

3.1.2 请求配置

1）字符集编码
默认UTF-8，支持选择UTF-8、GBK、GB2312，也可手动填写。

2）请求头
请求头定义需要传入请求链接的参数信息，可设置参数为常量值或变量值或作为报表参数。

3）请求体
请求体配置页面如下：

请求体支持raw和x-www-form-urlencoded两种类型。
raw类型可以上传json或XML类型的文本，以请求体的方式传参。

x-www-form-urlencoded类型以“key-value”的方式传参，当参数值类型为“使用模板”时，可定义参数模板，只能有一个参数值类型为“使用模板”。

3.1.3 返回配置

返回配置界面如下：

返回配置可不配置，当服务器需要返回信息时配置对应的节点及返回模板。
主要根据请求接口返回的数据配置对应的数据类型和取数规则，并配置输出字段。
数据类型支持JSON和XML，返回的数据类型和请求体的数据类型可相同也可不同，根据服务返回的数据类型进行定义。
状态节点：接口调用成功或失败状态的节点名称；
成功状态值：接口调用成功后返回的值；
错误码节点：接口调用失败后返回错误码的节点名称；
错误信息节点：接口调用失败后返回的错误信息的节点名称。

3.2 实例制作

由于http接口写入请求体支持JSON和XML类型，因此使用两种类型分布进行“客户信息写入”实例制作。

3.2.1 JSON类型

3.2.1.1 http写入数据定义

http写入页面配置如下：

请求头中定义了一个参数“backFilePath”用于传入服务器中返回文件的存放路径地址。
请求体配置如下：

JSON模板如下：
{
“code”: 200,
“msg”: “成功!”,
“data”: {
“customer”: [
{
“customerId”: “”,
“name”: “”,
“companyName”: “”,
“linkPerson”: “”,
“post”: “”,
“address”: “”,
“city”: “杭州”,
“area”: “”,
“phone”: “”,
“email”: “”
}
]
}
}
输入JSON模板，点击解析，将根据定义的JSON模板生成JSON树，勾选需要使用的字段。
返回配置如下：

由于实例中我们需要返回写入成功的提示内容，因此定义了返回字段“return”，返回提示信息，当提交成功时将返回信息“提交成功”。

3.2.1.2 报表制作

新建单元格表单，按照实际业务制作“客户信息写入”报表：

将定义的回写数据拉入数据源中：

定义填报回写规则，设置字段以及对应单元格：

由于定义了返回信息，如果想让返回信息在页面显示，可以定义一个填报单元格接收返回的字段信息，也可不指定则页面不显示返回信息：
(若定义了报表参数，则将出现“参数”tab，设置对应的参数值。)

保存预览，进行填报提交：

3.2.2 XML类型

XML类型写入除了请求体中XML模板内容与JSON类型不同，其他配置与JSON类型相同。

1）请求体XML模板配置如下：

XML模板内容如下：


0
400
获取数据失败


1
netSun
网盛数新
刘先生
市场部经理

可重复数据：在同一父节点下可存在多个相同的叶子节点；
CDATA数据：设置为CDATA数据的节点在XML解析时将使用CDATA方式解析。

返回配置如下：

报表制作过程同JSON类型。

4 总结

1）http写入将报表数据写入用户服务；
2）http写入只支持POST请求方式；
3）请求参数可设置为“常量”、“变量”、“参数”；
4）当请求体类型为“x-www-form-urlencoded”时可设置参数为“常量”、“变量”、“参数”、“使用模板”，“使用模板”的参数只能有一个；
5）返回配置根据实际业务可不进行配置；
6）XML请求体类型可右键设置“可重复数据”和“CDATA数据”。