实施排序

ABAP RESTful 应用程序编程模型 › 开发 › 开发应用程序 › 通过访问远程服务开发 UI 服务 › 使用远程 OData 服务 › 实施服务使用查询 › 实施排序

排序选项可委派给远程服务。使用相关查询选项 $orderby 填充传递到 OData 客户端代理的请求。

预览

要按适当的顺序检索数据,必须将排序信息添加到 OData 客户端代理的请求。

实施步骤

此场景仅实施按远程服务的字段排序。服务代理 API 提供将排序顺序委托给远程服务的方法 set_orderby。

备注

要按本地字段排序,您必须检索远程服务的所有可用数据集并首先将本地字段合并到这些数据集,以便能够按折扣值排序。在这种情况下,分页也无法委派给远程服务,并且必须在手动检索数据后实施。因此,按折扣值排序可能会导致严重的性能问题,因此在此场景中无法举例说明。

排序信息仅在检索数据时相关。因此,仅当请求数据为远程服务的读取请求提供此信息时,才必须调用实施。

  • 非托管查询 API 提供了一种获取排序信息的方法。使用 DATA(lt_sort) = io_request->get_sort_elements( ). 将排序信息获取到局部变量中。

    有关非托管查询 API 的详细信息,请参阅接口 IF_RAP_QUERY_REQUEST。

  • 循环 lt_sort。

    记住

    由于性能原因,不支持对本地元素进行排序。

  • 引发包含足够消息的异常,例如 Sorting on &1 is not allowed。

  • 声明 lt_sort_properties。此表通过要排序的元素传递到客户端代理。

  • 将远程服务的元素 Description 映射到 Memo 以匹配远程服务的数据模型。

  • 使用要从远程服务中选择的元素填充提供给客户端代理的表 lt_sort_properties 并映射列。

  • 使用 set_orderby 设置请求的排序属性。

" Request Sorting
          DATA(lt_sort) = io_request->get_sort_elements( ).

          LOOP AT lt_sort ASSIGNING FIELD-SYMBOL(<fs_sort>).
            IF <fs_sort>-element_name = 'DISCOUNTPCT' OR
               <fs_sort>-element_name = 'TOTALPRICEWITHDISCOUNT' OR
               <fs_sort>-element_name = 'CALCULATEDETAG'.
              RAISE EXCEPTION TYPE /dmo/cx_travel_serv_cons
                EXPORTING
                  textid  = /dmo/cx_travel_serv_cons=>sorting_failed
                  element = <fs_sort>-element_name.
            ENDIF.
            "map differing names
            DATA: lt_sort_properties TYPE /iwbep/if_cp_runtime_types=>ty_t_sort_order.
            APPEND VALUE #( property_path = COND #( WHEN <fs_sort>-element_name = 'DESCRIPTION' THEN 'MEMO'
                                                    ELSE <fs_sort>-element_name )
                            descending = <fs_sort>-descending )
                   TO lt_sort_properties.
          ENDLOOP.
          "set sorting properties
          IF lt_sort_properties IS NOT INITIAL.
            lo_read_request->set_orderby( lt_sort_properties ).
          ENDIF.

结果

如果已为自定义实体定义 UI 服务(请参阅定义 OData 服务),则可以使用 SAP Fiori 元素预览测试实施。尝试对不同元素进行排序,并检查结果是否已排序或是否抛出异常。