TEXTLIST 関数は一連のテキスト値を一つのテキスト値に連結します。
たとえば、特定の地域で販売されている商品のリストを生成できます。
構文
TEXTLIST(Text to concatenate, Separator, List to reference [, Duplicate behavior])
引数
| 引数 | データ型 | 説明 |
| Text to concatenate (必須) | テキスト ライン アイテム | 式を評価した結果のテキスト ライン アイテム |
| Separator (必須) | テキスト | 連結する各テキスト値を区切る区切り記号として使用するテキスト値 |
| List to reference (必須) | リスト | Text to concatenate 引数の値を連結する順番を指定するリスト |
| Duplicate behavior | キーワード | 重複するテキスト値を 1 回または複数回表示するかどうかを指定します。 |
TEXTLIST 関数はテキスト値を返します。
Duplicate behavior キーワード
| キーワード | 説明 |
| ALL | Text to concatenate 引数に同じテキストの複数のインスタンスが含まれている場合、結果には各インスタンスが一覧されます。 Duplicate behavior 引数を省略した場合のデフォルトの動作です。 |
| UNIQUE | Text to concatenate 引数に同じテキストの複数のインスタンスが含まれている場合、結果には最初のインスタンスだけが一覧されます。 |
計算エンジンの機能の違い
Polaris では TEXTLIST 計算関数を使用できません。
Classic エンジンでは使用できます。
構文の例
TEXTLIST('Regional product sales.Products', ", ", Regions, UNIQUE)
追加情報
ユーザー リストでの TEXTLIST の使用
TEXTLIST 関数を使ってユーザー リストを参照できます。ただし、ユーザー リスト内の特定のユーザーは、内容が変化して式が無効になる可能性がある本番データであるため参照できません。
制約
文字数制限
TEXTLIST 関数には 10,000 文字の文字数制限があります。これは、非常に長くてモデルのパフォーマンスに影響を及ぼすテキスト値が作成されないようにするための措置です。
テキスト関数の結果が 10,000 文字を超える場合、関数は文字を加えるのを停止し、さらに文字があることを示す省略記号 (…) を追加します。
同等の操作が行える Excel の関数
例
一般的な例
この例では二つのモジュールを使用しています。一つ目のモジュール「Sales Transactions」には、顧客名とトランザクションの値を含む二つのライン アイテムが列にあります。行には「Transactions」リストがあります。「Regions」リストはページ ディメンションで、現在「London」が選択されています。
Sales Transactions
Region:London
| 顧客 | Transaction Value | |
| Transaction 01 | 0 | |
| Transaction 02 | Fairgreen Furniture Ltd | 20,000 |
| Transaction 03 | Carpenter Oak Ltd | 15,000 |
| Transaction 04 | Carpenter Oak Ltd | 20,000 |
| Transaction 05 | Bluebottle Inc | 5,000 |
| Transaction 06 | 0 | |
| Transaction 07 | Purple Haze & Co | 2,000 |
| Transaction 08 | Fairgreen Furniture Ltd | 1,000 |
| Transaction 09 | Brass Monkeys Inc | 1,000 |
| Transaction 10 | Purple Marine Stores | 1,000 |
| Transaction 11 | 0 | |
| Transaction 12 | Purple Marine Stores | 5,000 |
2 番目のモジュール「List of customers」には列に三つのライン アイテムがあります。行には「Regions」リストがあります。「London」行は以下の例に対応しています。
最初の二つのライン アイテムには、地域別の顧客リストを表示する式があります。「List of all customers」ライン アイテムの式では、Duplicate behavior キーワードに対して ALL キーワードを使用しているため、重複するテキスト値が複数回返されます。「List of all customers without duplicates」ライン アイテムの式では、Duplicate behavior キーワードに対して UNIQUE キーワードを使用しているため、重複するテキスト値は返されません。
List of customers
List of all customers
| List of all customers without duplicates
| Total Transactions Value
| |
| London | Fairgreen Furniture Ltd, Carpenter Oak Ltd, Carpenter Oak Ltd, Bluebottle Inc, Purple Haze & Co, Fairgreen Furniture Ltd, Brass Monkeys Inc, Purple Marine Stores, Purple Marine Stores | Fairgreen Furniture Ltd, Carpenter Oak Ltd, Bluebottle Inc, Purple Haze & Co, Brass Monkeys Inc, Purple Marine Stores | 66,000 |
| Birmingham | Fairgreen Furniture Ltd, Fairgreen Furniture Ltd, Brass Monkeys Inc, Purple Marine Stores | Fairgreen Furniture Ltd, Brass Monkeys Inc, Purple Marine Stores | 110,000 |
| UK | 176,000 | ||
| Paris | Électricité Berlioz S.A., Amiot S.A | Électricité Berlioz S.A., Amiot S.A | 75,000 |
| Lyon | Dufay S.A., Dufay S.A., Jean Françaix S.A, René Désiré S.A. | Dufay S.A., Jean Françaix S.A, René Désiré S.A. | 104,000 |
| France | 179,000 | ||
| Munich | Hans-Jürgen GmbH, Von Bose AG | Hans-Jürgen GmbH, Von Bose AG | 58,000 |
| Berlin | Klughardt GmbH, Offenbach AG, Offenbach AG, Telemann GmbH | Klughardt GmbH, Offenbach AG, Telemann GmbH | 202,000 |
| Germany | 260,000 | ||
| New York | Anderson International Inc., Cummings Industries Inc., Headley Inc., Headley Inc. | Anderson International Inc., Cummings Industries Inc., Headley Inc. | 200,000 |
| Los Angeles | Kennedy Inc, ABC Inc | Kennedy Inc, ABC Inc | 20,000 |
| USA | 220,000 | ||
| Total Company | 835,000 |
