查询操作API

1 接口介绍

查询操作API是通过在系统中维护接口基本信息、配置请求参数、查询条件及返回参数来定义查询接口具体的功能。

2 注意事项

• 无论是GET请求还是POST请求，查询接口必须携带分页参数。

• 系统已预置Content-Type、accesstoken等请求头参数，用户无需维护。

• 查询操作API无需代码开发，支持配置快速生成，注意请求参数和返回参数不要泄露敏感信息。

• 若要在调用API时，调用方不传请求参数时忽略参数对应的过滤条件，可以将参数设为非必填，同时默认值为“*”。

• 若API要进行分录过滤时，分录中的物料必须选分录最内层的物料属性，否则返回的物料信息为null。

  
  

另外，关于提升查询接口性能，有以下优化建议：

• 请确保每条查询条件都有索引，建议使用日期范围、单号、ID作为查询条件。如果有多个查询条件，建议建立联合索引，能有效提升查询性能。

• 不建议将子表属性作为查询条件，会导致全面关联查询；如果是基础资料，还可能涉及跨库连接，性能极差。

• 避免在名称上使用 "like" 查询条件，否则，也会触发全表扫描，影响查询性能。

• 针对业务单据的查询，建议将日期范围作为必要的查询条件之一，并建立日期字段索引，这样可以帮助过滤掉大量无用数据，提升查询性能。

3 接口示例

3.1 根据工号查询人员信息

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

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

维护请求参数后，接着维护查询条件和返回参数，比较业务字段和请求参数，常见的比较方式有等于、不等于、包含...等等。

备注：当查询条件比较方式为“在...中”或“不在...中”时，对应比较变量的参数类型必须为Array数组。此时可以选择Array<Integer>、Array<String>、Array<Long>、Array<Date>这四种数组类型。

维护完返回参数后，接口就开发完毕了，接下来点击“API测试”，开始调试你的接口吧！

3.2 自由组合查询条件，查询人员信息

在上个场景中， 用户通过“添加属性”返回外部系统需要的字段，并且配置非常灵活。那么如果想要更加灵活的请求参数组合，应该怎么做呢？

您只需要在定义查询条件时，配置多组