参数转义
提供COP平台内部实体和枚举与第三方系统实体和枚举间的转换配置。
少于1分钟
1、概述
提供COP平台内部实体编码或枚举与第三方系统实体编码或枚举的转换机制。主要用于COP平台与第三方系统相互调用时的实体编码或枚举转换。
2、能力位置
能力路径:管理后台–>集成平台–>基础设置–>参数转义
URL相对路径:/main/backstageManage/cip-manager/escape-setting/app
3、能力特征
3.1、特征清单
功能特征 | 描述 |
---|---|
新建 | 支持用户自助新建参数转义 |
列表展示 | 支持列表展示、分页查询、模糊搜索 |
编辑/配置 | 支持用户编辑参数转义内容 |
删除 | 支持用户删除组织映射 |
3.2、核心界面示例
4、使用场景
4.1、外部编码自动转义为内部实体编码
UDC定制应用通过三方集成应用调用三方接口时,且参数类型为实体/枚举时,可以将入参由内部ID转义为外部编码或者内部ID转义为内部编码,出参由外部编码转义为内部编码或者外部编码转义为内部ID;
配置规则如下:
参数转义:厂商标识==集成应用:厂商标识
参数转义:产品标识==集成应用:标识
参数转义:版本号==集成应用:版本号
参数转义:应用==集成应用-接口-参数:转义应用(对应后台代码需要添加注解)
参数转义:实体/枚举==集成应用-接口-参数:转义实体(对应后台代码需要添加注解)
4.2、OpenAPI自动将外部编码转义为内部实体ID
三方系统调用开放平台OpenAPI时,可以将请求参数外部编码自动转义为内容实体ID,返回参数由内部实体/枚举ID转为外部编码;
配置规则如下:
参数转义:厂商标识==接入应用:厂商标识
参数转义:产品标识==接入应用:产品标识
参数转义:版本号==接入应用:版本号
参数转义:应用==接入应用-参数:转义应用(对应后台代码需要添加注解)
参数转义:实体/枚举==接入应用-参数:转义实体(对应后台代码需要添加注解)