01-认识详情配置页面
详情页面中包含两个大区域,分别是表头、子页签区域。
表头区域主要显示一个基本信息,启动方案等操作;
子页签分别为各项明细功能:
- 日志管理:用于输出集成方案运行过程中的各项日志记录;
- 数据管理:可以对mongoDB的原始数据进行管理;
- 请求队列:查看与维护请求源系统的查询任务;
- 写入队列:查看与维护写入目标系统的写入任务;
- 源平台配置:用于配置如何生成源系统的查询任务;
- 目标平台配置:用于配置如何生成目标系统的写入任务;
- 调试器:运维、开发人员可以通过调试器激活集成方案的各项指令集(参考《调试器的使用》);
- 异常队列:查看方案运行过程中出现的异常错误;
- 加工厂:在一些特殊方案中可以嵌入自定义的脚本代码来做特殊处理(参考《数据加工厂》)
- Throwable:查看方案运行过程中出现的一些代码级的错误异常;
- more info:更多的集成方案信息查看,如重试次数、适配器、回调方案等。
02-四大参数
请求参数-requestParams
源平台的请求参数通常是一些用于查询的业务参数,比如查询条件中的日期、部门、物料编码等字段信息;
注意!金蝶云星空的部分查询操作需要特别处理。详情请参考《金蝶云星空集成专题》
其它请求参数-otherRequestParams
源平台的其它请求参数通常是一些非业务类参数,用于分页、单据识别符等字段信息;二者的界定并不是必须的,依照每个平台的适配有所不同。但最终这两部分参数都会去组成最后的请求参数数据;
响应参数-responseParams
响应参数只源平台查询成功之后将会返回的字段信息,这些字段信息通常不包含非业务参数,比如响应成功状态码、message这些系统级别的参数,这些系统级别的字段会在适配器的handleResponse方法中被适配器过滤掉。
注意!金蝶云星空的部分查询操作需要特别处理。详情请参考《金蝶云星空集成专题》
其它响应参数-otherResponseParams
其它响应参数当前并没有发挥任何作用,未来可能用用作配置系统级别参数来自动处理handleResponse方法;
03-源平台配置基本操作
保存配置操作
可以在修改多个参数之后再点击【保存】整个源平台配置。
【配置视图】与【源码视图】在相互切换时会刷新页面数据,所以在切换之前务必已经点击了【保存】按钮,否则刚刚配置的数据不会被保存;
新增一个查询字段
新增新的字段内容时,需要先在左侧选中对应的上级
- 只有object、array的字段类型才支持下一级字段新增
新增字段时,首选需要选择【所属分组】;
新增字段的类型默认情况下选择【字符串string】类型,特殊情况下可以选择object、array的字段类型;
删除一个字段
先在左侧选中需要删除的字段,然后点击【删除】按钮。注意删除之后只是界面保存了,并没有对后端进行包含,你仍然需要点击【保存】按钮将数据提交到后端;
配置源平台的字段值
左侧树形选择字段后,可以开始对该字段的值进行配置。既可以手工输入一个值,也可以在下方【变量选择器】中选择一个变量值。
动态变量使用 {{}}包裹,可以在后面插入 |format 进行格式化,更多的格式化可以参考《值格式化》该章节。
04-源平台的源码配置
ID 与 Number 的配置
ID是在集成平台中用于区分数据的主键,在查询到源平台的数据时,需要定位到源数据的唯一主键字段。因此这里必须要配置一个源平台的可用字段。
Number并不作唯一主键控制,仅仅是用于前端界面方便查询数据。如果该源数据没有编码 你也可以使用ID或者任意字段作为number。
ID 与 Number目前只能在【源码视图】中进行配置。
idCheck 是否允许覆盖数据
源平台配置的 idCheck 参数用于检测是否开启主键检查,默认开启。
如果开启则会排出重复数据;
不开启则会覆盖已有数据;
拍扁多维数据
将一个结构化的数组数据拍扁
{
"beatFlat": [
"details_list"
]
}
示例:
{
"no":"OUT20210001",
"customer":"CK0001",
"date":"2021-11-11",
"details_list":[
{
"goods":"FOO0001",
"num":12
},
{
"goods":"FOO0002",
"num":50
}
]
}
数据背拍扁后将成为两行数据,并且会在主键后增加一个后缀行号
{
"no":"OUT20210001-1",
"customer":"CK0001",
"date":"2021-11-11",
"details_list_goods":"FOO0001",
"details_list_num":12
}
{
"no":"OUT20210001-2",
"customer":"CK0001",
"date":"2021-11-11",
"details_list_goods":"FOO0002",
"details_list_num":50
}