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 関数はテキスト値を返します。

キーワード説明
ALL

Text to concatenate 引数に同じテキストの複数のインスタンスが含まれている場合、結果には各インスタンスが一覧されます。

Duplicate behavior 引数を省略した場合のデフォルトの動作です。

UNIQUEText to concatenate 引数に同じテキストの複数のインスタンスが含まれている場合、結果には最初のインスタンスだけが一覧されます。

TEXTLIST('Regional product sales.Products', ", ", Regions, UNIQUE)

TEXTLIST 関数を使ってユーザー リストを参照できます。ただし、ユーザー リスト内の特定のユーザーは、内容が変化して式が無効になる可能性がある本番データであるため参照できません。

TEXTLIST 関数には 10,000 文字の文字数制限があります。これは、非常に長くてモデルのパフォーマンスに影響を及ぼすテキスト値が作成されないようにするための措置です。

テキスト関数の結果が 10,000 文字を超える場合、関数は文字を加えるのを停止し、さらに文字があることを示す省略記号 (…) を追加します。

Polaris では TEXTLIST 計算関数を使用できません。

Classic エンジンでは使用できます。

CONCATENATE

この例では二つのモジュールを使用しています。一つ目のモジュール「Sales Transactions」には、顧客名とトランザクションの値を含む二つのライン アイテムが列にあります。行には「Transactions」リストがあります。「Regions」リストはページ ディメンションで、現在「London」が選択されています。

Region:London


顧客Transaction Value
Transaction 01
0
Transaction 02Fairgreen Furniture Ltd20,000
Transaction 03Carpenter Oak Ltd15,000
Transaction 04Carpenter Oak Ltd20,000
Transaction 05Bluebottle Inc5,000
Transaction 06
0
Transaction 07Purple Haze & Co2,000
Transaction 08Fairgreen Furniture Ltd1,000
Transaction 09Brass Monkeys Inc1,000
Transaction 10Purple Marine Stores1,000
Transaction 11
0
Transaction 12Purple Marine Stores5,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 all customers

TEXTLIST(Sales Transactions.Customer, ", ", Transactions, ALL)

List of all customers without duplicates

TEXTLIST(Sales Transactions.Customer, ", ", Transactions, UNIQUE)

Total Transactions Value

Sales Transactions.Transaction Value

LondonFairgreen Furniture Ltd, Carpenter Oak Ltd, Carpenter Oak Ltd, Bluebottle Inc, Purple Haze & Co, Fairgreen Furniture Ltd, Brass Monkeys Inc, Purple Marine Stores, Purple Marine StoresFairgreen Furniture Ltd, Carpenter Oak Ltd, Bluebottle Inc, Purple Haze & Co, Brass Monkeys Inc, Purple Marine Stores66,000
BirminghamFairgreen Furniture Ltd, Fairgreen Furniture Ltd, Brass Monkeys Inc, Purple Marine StoresFairgreen Furniture Ltd, Brass Monkeys Inc, Purple Marine Stores110,000
UK

176,000
ParisÉlectricité Berlioz S.A., Amiot S.AÉlectricité Berlioz S.A., Amiot S.A75,000
LyonDufay 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
MunichHans-Jürgen GmbH, Von Bose AGHans-Jürgen GmbH, Von Bose AG58,000
BerlinKlughardt GmbH, Offenbach AG, Offenbach AG, Telemann GmbHKlughardt GmbH, Offenbach AG, Telemann GmbH202,000
Germany

260,000
New YorkAnderson International Inc., Cummings Industries Inc., Headley Inc., Headley Inc.Anderson International Inc., Cummings Industries Inc., Headley Inc.200,000
Los AngelesKennedy Inc, ABC IncKennedy Inc, ABC Inc20,000
USA

220,000
Total Company

835,000