Get (ソート順)
ソート順を JSON オブジェクトとして返します。
構文
Get (ソート順)
引数
なし
戻り値のデータタイプ
テキスト
起点バージョン
26.1
説明
この関数はアクティブなウインドウのソート順を次の構造を持つ JSON オブジェクトとして返します:
{
"Sort" :
{
"field" :
[
{
"fieldName" : "テーブル::フィールド",
"overrideLanguage" : "言語",
"sortOrder" : "Ascending | Descending | 値一覧名",
"summary" : "集計フィールド"
}
],
"maintain" : "true | false"
}
}
次の表に、返される JSON オブジェクトの要素に関する説明を示します。
| JSON 要素 | 説明 |
|---|---|
Sort
|
ソート順を含むオブジェクト。 |
field
|
[レコードのソート] ダイアログボックスで指定された順序の、各ソートフィールドのオブジェクトを含む配列。 |
fieldName
|
テーブルオカレンスを含むソートフィールドの名前 (例: |
sortOrder
|
フィールドのソート順。次のいずれか:
|
overrideLanguage
|
[フィールドの言語設定を変えてソート:] で指定されている場合、言語名 (例: |
summary
|
[集計フィールドに基づいて並べ替え] で指定されている場合、テーブルオカレンスを含まない集計フィールドの名前。 |
maintain
|
[ソートされた順位でレコードを保持] が選択されているかどうかを示す、 |
メモ
-
ソート順は各ウインドウで異なります。
-
この関数はレコードがソートされなくなった場合でも (例: [レコード] > [ソート解除] を選択した後)、ウインドウの最新のソート順を返します。レコードが現在ソートされているかどうかを確認するには、Get (ソート状態) 関数を使用します。
例 1
レコードが「製品名」で昇順にソートされていて [ソートされた順位でレコードを保持] が選択されていない場合、この関数は次を返します:
{
"Sort" :
{
"field" :
[
{
"fieldName" : "製品::製品名",
"sortOrder" : "Ascending"
}
],
"maintain" : "false"
}
}
例 2
スクリプトが対象レコードを変更する前にアクティブなウインドウのソート順を「レポート::最後に使用したソート順」フィールドに保存します。レコードがソートされていない場合、フィールドは空の値に設定されます。
フィールド設定 [レポート::最後に使用したソート順 ;
If (Get (ソート状態) = 0 ; "" ; Get (ソート順))
]
例 3
リスト形式のレイアウトで、レコードが「カテゴリ」順でソートされたときに「カテゴリ」の小計パートに見出しを表示します。その場合ボディパートの「カテゴリ」フィールドの各行で見出しを繰り返します。ボディの「カテゴリ」フィールドを非表示にするには、[次の場合にオブジェクトを隠す] の条件として次の計算式を入力します (レイアウトオブジェクトの表示と非表示を参照してください)。
Get (ソート状態) ≠ 0 and
JSONGetElement (Get (ソート順) ; "Sort.field[0].fieldName") = "製品::カテゴリ"
レコードがソートされていて「カテゴリ」が最初のソートフィールドである場合にのみこの計算式は 1 (フィールドは非表示) を返します。そうでない場合、0 を返します。[レコード] > [ソート解除] を選択した後でもこの関数は依然として最後に使用されたソート順を返すため、Get (ソート状態) のテストが必要です。