Get(排序顺序)

将排序顺序作为 JSON 对象返回。

格式 

Get ( 排序顺序 )

参数 

无

返回的数据类型 

文本

原始版本 

26.1

说明 

该函数将活动窗口的排序顺序作为具有以下结构的 JSON 对象返回:

复制
{
  "Sort" : 
  {
    "field" : 
    [
      {
        "fieldName" : "Table::Field",
        "overrideLanguage" : "Language",
        "sortOrder" : "Ascending | Descending | Value list name",
        "summary" : "Summary field"
      }
    ],
    "maintain" : "true | false"
  }
}

下表说明返回的 JSON 对象中的元素。

JSON 元素 说明
Sort

包含排序顺序的对象。

field

包含每个排序字段对象的数组,按照“对记录排序”对话框中指定的顺序。

fieldName

排序字段的名称,包括其表摹本(例如,Products::ProductName)。

sortOrder

字段的排序顺序。以下之一:

  • Ascending

  • Descending

  • 值列表的名称 - 如果已由“基于值列表的自定义顺序”指定

overrideLanguage

语言名称 - 如果已为“覆盖字段的语言以进行排序”指定了语言,例如 Swedish。有关可能的名称,请参阅用于排序和编制索引的语言名称。

summary

合计字段的名称 - 如果已为“根据合计字段重新排序”指定,没有表摹本。

maintain

文本值 "true" 或 "false",表示是否选择了“将记录按照排序顺序保存”。

注释 

  • 每个窗口都有自己的排序顺序。

  • 该函数返回窗口的最新排序顺序,即使记录不再排序(例如,在您选择“记录”>“取消排序”后)。要检查记录当前是否已排序,请使用 Get (排序状态)函数。

示例 1 

如果记录按产品名称以升序排序,且未选择“将记录按照排序顺序保存”,则该函数将返回:

复制
{
  "Sort" : 
  {
    "field" : 
    [
      {
        "fieldName" : "Products::ProductName",
        "sortOrder" : "Ascending"
      }
    ],
    "maintain" : "false"
  }
}

示例 2 

在脚本更改搜索结果之前,将活动窗口的排序顺序保存在 Reports::LastSortOrder 字段中。如果记录没有排序,该字段将设置为空值。

复制
设置字段 [ Reports::LastSortOrder ;
    If ( Get ( 排序状态 ) = 0 ; "" ; Get ( 排序顺序 ) )
]

示例 3 

在列表视图的布局中,当记录按“类别”排序时,“类别”小计部分会显示标题。然后,正文部分的“类别”字段会在每行中重复该标题。在这种情况下,要隐藏正文的“类别”字段,请将此公式输入为“隐藏对象时间”条件(请参阅隐藏或显示布局对象)。

复制
Get ( 排序状态 ) ≠ 0 and
JSONGetElement ( Get ( 排序顺序 ) ; "Sort.field[0].fieldName" ) = "Products::Category"

仅当记录已排序且类别是第一个排序字段时,计算才会返回 1(并且字段被隐藏)。否则,它会返回 0。需要 Get(排序状态) 测试,因为在选择“记录”>“取消排序”后,该函数仍然返回最后的排序顺序。