一文带你了解苍穹OpenAPI国际化多语言解决方案

该功能适用版本为金蝶云·苍穹V5.0.021及以上。

基于金蝶动态领域模型，苍穹国际化能力提供了多语言的支撑能力，OpenAPI支持查询单据或基础资料中的多语言文本字段，也可以通过接口保存当前语言或所有语言数据。

通过OpenAPI执行操作时，自动根据接口访问令牌（accesstoken）上下文中的语言（language），进行多语言文本处理。在新版本中，OpenAPI对多语言文本的处理更加灵活，支持以下场景：

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

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

3) 支持调用接口时自定义语言环境。

示例1：查询接口多语言 -- 返回所有语言的供应商名称。

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

供应商名称的多语言信息

当通过接口查询供应商信息时，首先需要获取accesstoken信息。在获取登录令牌时，传入默认系统语言。简体中文为 zh_CN、繁体中文 zh_TW，英文 en_US，这里传入英文标识en_US，如下图所示：

获取accesstoken（英文语言环境）

在请求中，携带accesstoken调用接口，默认返回英文语言的数据，如下图所示，查询供应商名称和简称时，会返回对应的英文名称。

接口查询英文环境下的供应商名称

若需要一次返回所有语言的供应商名称信息，则需要打开“返回多语言”开关，路径：【开发服务云】 → 【开放平台】→ 【API管理】→ 【API开发】。

打开API配置【返回多语言】

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

接口查询所有语言的供应商名称

示例2：保存接口多语言 -- 保存所有语言的供应商名称。

以供应商基础资料为例，通过接口保存不同语言的供应商名称。

当只需要保存某个语言数据时，我们同样可以在获取accesstoken的请求参数中，传入语言（language），同示例1，将环境语言定义为英文en_US。

接口保存供应商 - 名称为英文

接口保存成功后，查看生成的供应商名称，如下所示：

接口保存的供应商名称多语言信息

当需要一次保存所有语言的供应商名称时，在请求参数中传入如下map样式，如下所示：

接口保存供应商 - 名称传入所有语言

接