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
|
排序字段的名称,包括其表摹本(例如, |
sortOrder
|
字段的排序顺序。以下之一:
|
overrideLanguage
|
语言名称 - 如果已为“覆盖字段的语言以进行排序”指定了语言,例如 |
summary
|
合计字段的名称 - 如果已为“根据合计字段重新排序”指定,没有表摹本。 |
maintain
|
文本值 |
注释
-
每个窗口都有自己的排序顺序。
-
该函数返回窗口的最新排序顺序,即使记录不再排序(例如,在您选择“记录”>“取消排序”后)。要检查记录当前是否已排序,请使用 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(排序状态) 测试,因为在选择“记录”>“取消排序”后,该函数仍然返回最后的排序顺序。