LISTOFFIELDS ER 関数
LISTOFFIELDS 関数は、列挙またはコンテナー (レコード) タイプの指定された引数の構造に基づいて作成されたレコード リストの値を返します。
構文 1
LISTOFFIELDS (path)
構文 2
LISTOFFIELDS (path, language)
引数
path: データ ソース参照
次のいずれかのデータ型のデータ ソースの有効な参照パス。
- モデルの列挙
- 形式列挙
- アプリケーションの列挙
- コンテナー (レコード)
language: 文字列
言語コードを表すテキスト。
戻り値
レコード リスト
レコードの結果リスト。
使用上の注意
作成するリストは、次のフィールドを持つレコードで構成されます。
- 名前 (文字列データ型)
- ラベル (文字列データ型)
- 説明 (文字列データ型)
- IsTranslated (ブール値データ型)
path 引数がコンテナー (レコード) タイプのデータ ソースを参照している場合、参照コンテナー レコードのすべてのフィールドに対して、作成されたリストに新しいレコードが追加されます。 作成されるすべてのレコードについて、名前フィールドは、現在のレコードが作成された参照コンテナー レコードのフィールドの名前を返します。
path 引数が列挙型のいずれかのデータ ソースを参照している場合、参照列挙の列挙値ごとに、作成されるリストに新しいレコードが追加されます。 作成されるすべてのレコードについて、名前フィールドは現在のレコードが作成された、参照列挙の値を返し、説明フィールドはその列挙の説明を返し、ラベル フィールドは、その列挙のラベルを返します。
実行時に構文 1 を使用する場合、ラベルおよび説明フィールドは、実行中の電子申告 (ER) 形式の言語設定に基づく値を返す必要があります。
- 要求された言語のラベルと説明が使用可能な場合、ラベルおよび説明フィールドはその言語に基づく値を返し、IsTranslated フィールドは True を返します。
- 要求された言語のラベルと説明が使用できない場合、ラベルおよび説明フィールドは既定の EN-US 言語に基づく値を返し、IsTranslated フィールドは False を返します。
実行時に構文 2 を使用する場合、ラベルおよび説明フィールドは、呼び出された関数の 2 番目の引数として定義されている言語に基づく値を返す必要があります。
- 要求された言語のラベルと説明が使用可能な場合、ラベルおよび説明フィールドはその言語に基づく値を返し、IsTranslated フィールドは True を返します。
- 要求された言語のラベルと説明が使用できない場合、ラベルおよび説明フィールドは EN-US 言語に基づく値を返し、IsTranslated フィールドは False を返します。
例 1
次の図では、列挙は ER データ モデルで導入されます。
次の図は、これらの詳細について説明しています。
- モデル列挙はデータ ソースとしてレポートに挿入されます。
- ER の式は
LISTOFFIELDS関数のパラメーターとしてモデル列挙を使用します。 - レコード リスト タイプのデータ ソースは、作成された ER の式を使用してレポートに挿入されます。
次の例では、LISTOFFIELDS 関数を使用して作成されたレコード リスト タイプのデータ ソースにバインドされている ER 形式要素を示します。
次の図は、設計された形式が実行される際の結果を示します。
メモ
親 FILE および FOLDER 形式要素の言語設定に基づいて、ラベルと説明の翻訳文は、ER 形式出力に入力されます。
例 2
計算済フィールド データ ソース型を使用して、enumType データ モデル列挙に対して enumType_de および enumType_deCH データ ソースを構成します。
-
enumType_de =
LISTOFFIELDS (enumType, "de") -
enumType_deCH =
LISTOFFIELDS (enumType, "de-CH")
この場合、その翻訳が使用可能な場合は、スイス ドイツ語の列挙値のラベルを取得する次の式を使用できます。 スイス ドイツ語翻訳を使用できない場合、ラベルはドイツ語になります。
IF (NOT (enumType_deCH.IsTranslated), enumType_de.Label, enumType_deCH.Label)