1.1 功能介绍

商旅字段映射功能，模拟了商旅平台对接外部系统的整个过程，实现了接口推送（人员、组织、出差申请单主动推送给商旅平台）和接口拉取（比如从商旅平台接口获取订单、结算单等）两种模式，接口推送模式下展示基本信息、查询条件（查星瀚对应功能的数据）、字段映射（将星瀚对应的值映射到推送报文字段）、可忽略的业务异常4部分。接口拉取模式下，展示基本信息、查询条件（查询商旅接口数据的入参报文）、数据过滤（对接口获取到的数据进行条件过滤）、字段映射4部分。最终达到暴露映射逻辑、可扩展、映射代码可复用、易使用的效果。

1.2 应用场景

1、目前费用报销与商旅平台集成时，映射的字段以及字段取值，都是通过代码写死的，到具体客户实施时，需要增加或者减少字段，都需要进行二次开发处理，难度比较大；

2、每个字段的取值规则没有在前端进行展示，对于实施来说，就是一个黑盒，不方便了解映射逻辑，实施起来一片茫然3、客户使用的商旅平台有可能不是标准产品对接的功能，二开工作量大，难度很大

1.3 系统路径

【财务云】→【费用核算】→【商旅设置】 →【商旅字段映射

【员工服务云】→【费用查询】→【商旅设置】 →【商旅字段映射】

1.4 关键字段/按钮说明

关键字段说明

关键按钮说明

2 主要操作

2.1 字段映射配置

操作步骤

步骤1：对于第三方平台，需先在财务云-费用核算-商旅设置-服务商设置先预置第三方平台的服务商数据（包括appkey，秘钥、签名等等，每家服务商都不一致，根据具体情况设置），服务商设置不能新增，都是通过脚本预置的。

步骤2 ：确定星瀚对接的功能，确定商旅平台接口地址以及对接的模式（拉取模式还是推送模式）

步骤3：通过商旅对接人员拿到商旅接口推送的入参报文和返回接口报文示例

步骤4：推送模式下，基本信息填写完成后，输入查询条件，查询星瀚对应功能中需要推送的数据，通过“字段映射”将星瀚功能字段和入参报文字段建立映射关系，最终形成入参报文推送给商旅平台，通过“可忽略的异常”来判断商旅平台的返回接口。注意：返回成功的信息需要设置到“可忽略的异常”中。

步骤5： 拉取模式下，基本信息填写完成后，输入查询条件，形成接口入参报文，然后通过“数据过滤”对接口返回的数据进行过滤，最后通过“字段映射”将返回报文与星瀚字段建立映射关系，最终保存至数据库中。

步骤6：字段映射配置完成后，可通过调试按钮进行调试

步骤7：  创建调度作业，配置调度计划执行字段映射方案（比如组织同步、人员同步、订单获取、结算获取等功能适用）

备注：调度作业中的执行程序固定为kd.fi.er.business.trip.v2.task.TripIntegrationTask，自定义参数的参数名称为number，参数类型为文本，默认值为商旅字段映射方案的编码

步骤8：针对实时同步的功能，调度计划处理不了，比如出差申请单，系统在对应的功能点预置了代码调用对应的商旅字段映射方案，比如出差申请单审核通过时，会自动调用启用的服务商的出差申请单同步方案（新增），撤销，反审核，审核不通过，关闭，行程变更会调用出差申请单同步方案（修改）改变状态。