参数转义

提供COP平台内部实体和枚举与第三方系统实体和枚举间的转换配置。

1、概述

提供COP平台内部实体编码或枚举与第三方系统实体编码或枚举的转换机制。主要用于COP平台与第三方系统相互调用时的实体编码或枚举转换。

2、能力位置

能力路径:管理后台–>集成平台–>基础设置–>参数转义

URL相对路径:/main/backstageManage/cip-manager/escape-setting/app

1719365958627

3、能力特征

3.1、特征清单

功能特征 描述
新建 支持用户自助新建参数转义
列表展示 支持列表展示、分页查询、模糊搜索
编辑/配置 支持用户编辑参数转义内容
删除 支持用户删除组织映射

3.2、核心界面示例

1720076416160
1720076485096

4、使用场景

4.1、外部编码自动转义为内部实体编码

UDC定制应用通过三方集成应用调用三方接口时,且参数类型为实体/枚举时,可以将入参由内部ID转义为外部编码或者内部ID转义为内部编码,出参由外部编码转义为内部编码或者外部编码转义为内部ID;

配置规则如下:

参数转义:厂商标识==集成应用:厂商标识

参数转义:产品标识==集成应用:标识

参数转义:版本号==集成应用:版本号

参数转义:应用==集成应用-接口-参数:转义应用(对应后台代码需要添加注解)

参数转义:实体/枚举==集成应用-接口-参数:转义实体(对应后台代码需要添加注解)

4.2、OpenAPI自动将外部编码转义为内部实体ID

三方系统调用开放平台OpenAPI时,可以将请求参数外部编码自动转义为内容实体ID,返回参数由内部实体/枚举ID转为外部编码;

配置规则如下:

参数转义:厂商标识==接入应用:厂商标识

参数转义:产品标识==接入应用:产品标识

参数转义:版本号==接入应用:版本号

参数转义:应用==接入应用-参数:转义应用(对应后台代码需要添加注解)

参数转义:实体/枚举==接入应用-参数:转义实体(对应后台代码需要添加注解)
最后修改 September 4, 2024: 修改路径名称为英文 (55b791f)