Get (ソート順)

ソート順を JSON オブジェクトとして返します。

構文 

Get (ソート順)

引数 

なし

戻り値のデータタイプ 

テキスト

起点バージョン 

26.1

説明 

この関数はアクティブなウインドウのソート順を次の構造を持つ JSON オブジェクトとして返します:

コピー
{
  "Sort" : 
  {
    "field" : 
    [
      {
        "fieldName" : "テーブル::フィールド",
        "overrideLanguage" : "言語",
        "sortOrder" : "Ascending | Descending | 値一覧名",
        "summary" : "集計フィールド"
      }
    ],
    "maintain" : "true | false"
  }
}

次の表に、返される JSON オブジェクトの要素に関する説明を示します。

JSON 要素 説明
Sort

ソート順を含むオブジェクト。

field

[レコードのソート] ダイアログボックスで指定された順序の、各ソートフィールドのオブジェクトを含む配列。

fieldName

テーブルオカレンスを含むソートフィールドの名前 (例: 製品::製品名)。

sortOrder

フィールドのソート順。次のいずれか:

  • Ascending

  • Descending

  • [値一覧に基づく順位:] で指定されている場合、値一覧の名前

overrideLanguage

[フィールドの言語設定を変えてソート:] で指定されている場合、言語名 (例: Swedish)。使用できる名前については、ソートおよび索引設定の言語名を参照してください。

summary

[集計フィールドに基づいて並べ替え] で指定されている場合、テーブルオカレンスを含まない集計フィールドの名前。

maintain

[ソートされた順位でレコードを保持] が選択されているかどうかを示す、"true" または "false" のテキスト値。

メモ 

  • ソート順は各ウインドウで異なります。

  • この関数はレコードがソートされなくなった場合でも (例: [レコード] > [ソート解除] を選択した後)、ウインドウの最新のソート順を返します。レコードが現在ソートされているかどうかを確認するには、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 (ソート状態) のテストが必要です。