商旅字段映射
变更记录
| 产品版本 | 更新内容 | 更新日期 |
| V5.0.023 | 初始版本 | 2023年06月19日 |
| ...... | ...... |
1 简介
1.1 功能介绍
商旅字段映射功能，模拟了商旅平台对接外部系统的整个过程，实现了接口推送（人员、组织、出差申请单主动推送给商旅平台）和接口拉取（比如从商旅平台接口获取订单、结算单等）两种模式，接口推送模式下展示基本信息、查询条件（查星瀚对应功能的数据）、字段映射（将星瀚对应的值映射到推送报文字段）、可忽略的业务异常4部分。接口拉取模式下，展示基本信息、查询条件（查询商旅接口数据的入参报文）、数据过滤（对接口获取到的数据进行条件过滤）、字段映射4部分。最终达到暴露映射逻辑、可扩展、映射代码可复用、易使用的效果。
1.2 应用场景
1、目前费用报销与商旅平台集成时，映射的字段以及字段取值，都是通过代码写死的，到具体客户实施时，需要增加或者减少字段，都需要进行二次开发处理，难度比较大；
2、每个字段的取值规则没有在前端进行展示，对于实施来说，就是一个黑盒，不方便了解映射逻辑，实施起来一片茫然3、客户使用的商旅平台有可能不是标准产品对接的功能，二开工作量大，难度很大
1.3 系统路径
【财务云】→【费用核算】→【商旅设置】 →【商旅字段映射
【员工服务云】→【费用查询】→【商旅设置】 →【商旅字段映射】
1.4 关键字段/按钮说明
关键字段说明
| 字段名称 | 详细解释 |
| 服务商 | 对接的商旅平台，数据来源于商旅设置-服务商设置 |
星瀚对接功能 | 星瀚系统中对应的功能 |
接口方式 | 支持推送和拉取两种方式，推送：数据在星瀚，通过商旅平台接口，将星瀚数据同步至商旅平台（比如将人员、组织、出差申请单同步至商旅平台）；拉取：数据在商旅平台，星瀚通过接口将数据拉取回星瀚（比如获取商旅平台的订单、结算、月结账单等） |
推送/拉取接口URL | 商旅平台接口地址 |
请求参数报文示例 | 必须是jsonObject格式，需要由商旅平台提供对应接口的请求参数报文示例 |
返回参数报文示例 | 必须是jsonObject格式，需要由商旅平台提供对应接口的返回数据报文示例 |
| 插件 | 商旅映射方案的执行代码路径，如果需要进行二开，需继承该方法，再进行处理，并且把对应继承的插件以对应格式 【插件全路径+#+方法】 填入该字段，如不需要进行二开，该方法请不要进行修改 |
关键按钮说明
| 按钮名称 | 详细解释 |
| 调试 | 接口配置完成之后，点击调试验证接口是否能调通 |
| 复制 | 复制系统中存在的接口方案，修改对应的映射，形成新商旅平台的接口方案 |
2 主要操作
2.1 字段映射配置
操作步骤
步骤1：对于第三方平台，需先在财务云-费用核算-商旅设置-服务商设置
商旅字段映射
声明：除非特别标注，否则均为本站原创文章，转载时请以链接形式注明文章出处。如若本站内容侵犯了原著者的合法权益，可联系本站删除。
