OpenAPI国际化多语言功能优化

优化了OpenAPI对多语言文本的支持，更加灵活易用。

发布版本：苍穹V5.0

上线日期：2023-05-21

补丁号：V5.0.021（BOS）

特性效果展示

1. 功能介绍

苍穹平台OpenAPI支持国际化多语言，当通过OpenAPI执行查询或保存操作时，系统会获取访问令牌（access_token）上下文中的语言（language），自动处理多语言文本。旧版本中API仅返回或保存当前语言的数据；新版本优化了对多语言文本的支持，具体优化如下：

1. 查询操作API，通过开关配置，支持一次返回字段的所有语言数据；

2. 保存操作API，支持使用map形式传入多语言字段，保存字段所有语言数据；

3. 调用接口时支持自定义语言环境，在请求头中传入Accept-Language（仅v2接口），优先级高于访问令牌上下文。

2. 应用场景

在金蝶云苍穹单据或基础资料中，多语言文本是比较特殊的字段，OpenAPI支持查询单据或基础资料中的多语言文本字段。同时，用户可以通过接口保存当前语言或所有语言的数据。

3. 操作示例

3.1 查询接口，返回所有语言的供应商名称

当企业有部分供应商为跨国公司时，因此，在进行供应商管理时，需要启用多语言字段，分别维护供应商的英语名称与简称。

第三方系统通过接口查询供应商信息时，首先需要获取access_token，此时需要传入默认系统语言作为参数，不同语言的标识如下：

• 简体中文：zh_CN

• 繁体中文：zh_TW

• 英文：en_US

在请求头中携带accesstoken并调用查询接口，默认返回对应语言的数据，即，如传入英文语言标识，那么查询供应商名称和简称时，会返回对应的英文名称。

若第三方系统需要一次返回所有语言的供应商名称信息，可以通过打开API配置中的‘返回多语言’选项实现路径：【开放服务云】 → 【OpenAPI】→ 【API管理】→ 【API开发】

第三方系统若再次调用接口，此时会返回所有语言的供应商名称信息。

3.2 保存接