业务实体服务指南

10.2

上一个下一个

排序顺序的注意事项

读取业务实体 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"}]}
    ]}
}}}

读取业务实体

下载指南

发送反馈

社区

Knowledge Base

成功门户

Rename Saved Search

目录

业务实体服务指南

业务实体服务指南

排序顺序的注意事项

排序顺序的注意事项