List
フィールド内の空白を除く値の連結一覧を返します。
構文
List (フィールド {; フィールド...})
引数
フィールド - 任意の関連フィールド、繰り返しフィールド、複数の非繰り返しフィールドのセット、またはフィールド、繰り返しフィールド、複数の非繰り返しフィールドのセットを返す式、または変数
中カッコ { } 内の引数はオプションです。
戻り値のデータタイプ
テキスト
起点バージョン
8.5
説明
最後の値以外の返される各値はキャリッジリターンで区切られます。
この関数を使用して、次のいずれかに対して値の一覧を返します:
- 1 つのフィールド
(テーブル::フィールド)では、これらのレコードがポータルに表示されているかどうかにかかわらず、このフィールドのすべての繰り返しに対して、またすべての一致する関連レコードに対して 1 つの結果が計算されます。 - 複数のフィールドやリテラル値
(テーブル::フィールド 1、定数、テーブル::フィールド 2...)では、各フィールドのそれぞれの該当繰り返しにわたる計算のそれぞれの繰り返しについて別個の結果が計算されます。関連付けられているフィールドがある場合は、最初に関連付けられたレコードだけが使用されます。
メモ
- 複数の繰り返しフィールドを参照する場合、List 関数は、その計算の初回の繰り返しにおいて最初の繰り返し全体の値の一覧を返し、次に 2 番目の繰り返しにおいて 2 番目の繰り返し全体の値の一覧を返し、以後同様に行います。
例 1
次の例の説明:
- フィールド 1 には白が含まれています。
- フィールド 2 には黒が含まれています。
- フィールド 3 は繰り返しフィールドで、赤、緑、青という値が入力されています。
- 関連::フィールド 4 は 100、200、300 を含む 3 つのレコードを参照しています。
- $f1 にはオレンジ¶紫が含まれています。
List (フィールド 1 ; フィールド 2) は次を返します:
白
黒
List (フィールド 3) は次を返します:
赤
緑
青
List ($f1 ; フィールド 2) は次を返します:
オレンジ
紫
黒
List (フィールド 1 ; フィールド 2 ; フィールド 3; $f1) は次を戻します:
- 計算繰り返し 1 では:
白
黒
赤
オレンジ
紫
- 計算繰り返し 2 では:
緑
オレンジ
紫
- 計算繰り返し 3 では:
青
オレンジ
紫
List (関連::フィールド 4)は次を返します:100
200
300