目录

Search

  1. 前言
  2. 业务实体服务简介
  3. EJB 业务实体服务调用
  4. REST 业务实体服务调用
  5. 适用于 Data Director 的 REST API
  6. SOAP 业务实体服务调用
  7. 交叉引用记录和 BVT 计算服务
  8. 支持企业关联服务
  9. 清理、分析和转换数据的外部调用
  10. 附录 , A: 使用 REST API 添加记录
  11. 附录 , B: 使用 REST API 上载文件
  12. 附录 , C: 使用 REST API 管理报告

业务实体服务指南

业务实体服务指南

排序顺序的注意事项

排序顺序的注意事项

读取记录 API 支持对每个业务实体子节点按一个或多个字段进行排序。下一节介绍了指定排序顺序时需要了解的某些注意事项。
  • 如果为孙元素而非子元素指定排序顺序,则孙元素将按指定的顺序进行排序。子元素不会按照为孙元素指定的排序顺序进行排序。以下是一个示例请求:
    http://localhost:8080/cmx/cs/localhost-orcl-DS_UI1/Person/1242/Phone/861/PhonePermissions?order=-column1
    在此示例请求中,虽然为孙元素 PhonePermissions 指定了降序排序顺序,但没有为子元素 Phone 指定任何顺序,因此 Phone 不会按照 PhonePermissions 排序顺序进行排序。
  • 如果为子元素而非孙元素指定排序顺序,则子元素将按指定的顺序进行排序。孙元素不会按照为子元素指定的排序顺序进行排序。以下是一个示例请求:
    {parameters: {coFilter: { object: { name:"Person", key: { rowid: 1242 }, order: "lastName", object:[ {name:"Names", order:"-name"}, {name:"Phone", order:"-phoneCountryCd, -phoneNum", object:[{name:"PhonePermissions"}]}, ]} }}}
    在此示例请求中,为子元素 Phone 而非孙元素 PhonePermissions 指定了排序顺序,因此子元素 Phone 将按指定的顺序进行排序。
  • 如果同时为子元素和孙元素指定排序顺序,则子元素和孙元素都将按该排序顺序进行排序。以下示例请求同时为 Phone(子元素)和 PhonePermissions(孙元素)指定了排序顺序:
    {parameters: {coFilter: { object: { name:"Person", key: { rowid: 1242 }, order: "lastName", object:[ {name:"Names", order:"-name"}, {name:"Phone", order:"-phoneCountryCd, -phoneNum", object:[{name:"PhonePermissions", order:"-column1"}]}, ]} }}}
  • 子元素只能按子元素本身中的列进行排序,而孙元素可以按孙元素中的列进行排序。在以下示例请求中,Phone 按 PhoneType 进行排序,而 PhonePermissions 按列 1 进行排序。PhoneType 是 Phone(子元素)中的一个列,而列 1 是 PhonePermissions(孙元素)中的一个列。
    http://localhost:8080/cmx/cs/localhost-orcl-DS_UI1/Person/1242/Phone?order=-PhoneType
    http://localhost:8080/cmx/cs/localhost-orcl-DS_UI1/Person/1242/Phone/861/phonePermissions?order=column1
  • 在业务实体的每个级别,仅允许对每种子项类型使用一种排序顺序。在以下请求中,您为不同父元素的 PhonePermissions 子元素指定了不同的排序顺序。但是,由于第一排序顺序指定为降序,因此两个父元素(行 ID 861 和行 ID 862)的 PhonePermissions 子元素都按降序进行排序。
    {parameters: {coFilter: { object: { name:"Person", key: { rowid: 1242 }, order: "lastName", object:[ {name:"Names", order:"-name"}, {name:"Phone", key: { rowid:861 }, order:"+phoneCountryCd, -phoneNum", object:[{name:"PhonePermissions", order:"-column1"}]}, {name:"Phone", key: {rowid:862}, order:"phoneNum, -phoneCountryCd", object:[{name:"PhonePermissions", order:"column1"}]} ]} }}}