1 适用版本

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

2 功能场景

2.1 根据工号查询人员信息

借助苍穹开放平台，用户可以快速配置人员主数据接口。

路径：【开发服务云】→【开放平台】→【API管理】→【API开发】列表，点击“新增”按钮，进入到零代码开发模式。

上传图片

开放平台新增操作API

依次维护API编码、名称、请求方式等信息，选择业务对象“人员”，操作方式“查询”。随后，定义请求入参，可以通过添加属性快速完成添加，也可以通过点击“增行”，手工输入。

注：此处参数名称可以根据需要自定义。

上传图片

维护API基本信息和请求参数

请求入参定义完后，可以直接在页面配置查询接口执行逻辑和返回参数。根据业务对象中的字段和请求入参进行比较，常见的比较方式有“等于”、“不等于”、“在...中”等等，接口根据入参变化接口返回不同的数据，如下图所示：

上传图片维护参数控制和返回参数

上述步骤维护结束后，一个查询API就开发完毕了。接下来就可以点击“API测试”按钮，测试接口功能，如下图所示：

上传图片

API在线测试

2.2 自由组合查询条件，查询人员信息资源更新

在场景一中，用户可以通过“添加属性”，将第三方系统需要的字段添加到返回参数中，包含人员所有的基本信息和分录信息，出参调整非常灵活。那么如果想要更灵活的入参，应该怎么办呢？

只需要在定义查询条件时，配置多组不同的查询条件，如根据人员状态、创建时间和性别来查询人员信息。

上传图片

配置多组请求参数和组合条件

若想要调用方在不传某项参数时，接口自动忽略该参数和条件，按剩余条件进行过滤，只需要将参数设为“非必填”，并且设置默认值为“*”即可。

当然，有些参数有具体含义的默认值，比如说，当调用方不传”性别“时，接口默认传的是0，如下图中：

上传图片维护请求参数默认值

设置完成后，可以测试效果。此时，调用方只传了一个时间参数，但接口执行时，过滤条件（filter）会忽略默认值为“*”的参数条件（enable），并组合了默认值为“0”的参数条件（gender）。

上传图片

组合条件调用效果

2.3 指定固定常量或脚本查询人员信息

在实际应用中，还有另一个场景：当A系统对B系统开放查询接口，但出于数据安全考虑，只想将某组织（org）或来源于某供应商的采购订单返回到对方。那么，可以在查询条件中默认添加固定查询条件，调用方无感知。

这里仍然以“人员”为例，通过配置固定常量查询条件的方式，限制接口返回数据范围。

上传图片

维护比较常量

可以看到，调用方无需传入任何参数，调用接口后，返回使用状态为“1”（可用），创建时间小于当前时间的人员信息。

上传图片

常量查询调用效果

3 亮点价值

提升集成效率。通过零代码配置的方式，快速开发接口，提升集成效率。

灵活易用。灵活的出入参配置，可快速调整请求参数和返回参数，同时参数名称也可以完全自定义，实时生效。

多场景支持。通用查询、组合条件查询、常量查询以及多种比较方式，满足系统对接的不同场景。

4 划重点

1、常见的查询接口开发，可通过开放平台零代码配置的方式快速搞定，更加复杂的数据处理、跨表查询等场景，可使用自定义API。

2、若需要接口自动忽略该参数和条件，必须将参数设为“非必填”，并且设置默认值为“*”。

3、灵活使用组合查询和常量查询，可满足系统对接的不同场景。

#往期推荐#

# 学会苍穹基本认证和匿名访问，快速搞定接口回调场景

# 苍穹OpenAPI新体验之保存接口

# API出入参加解密与防篡改，保障企业数据安全

更多精彩内容，“码”上了解！↓

妈见夸，三分钟内搞定查询接口开发！

妈见夸，三分钟内搞定查询接口开发！

恭喜您！