TEXTLIST 集計関数はテキスト値のコレクションをカンマ区切り値として返します。返される値はソース モジュールのマッピングに基づきます。

たとえば、TEXTLIST 関数を使用して各リージョンの顧客のリストを返すことができます。

Values to list[TEXTLIST:Mapping, TEXTLIST:Mapping 2, etc.]

引数データ型説明
Values to listテキストMapping 引数に基づいて、カンマ区切りテキスト値として返す値
Mappingリスト、日付、時間軸

カンマ区切りテキスト値として返す値を決定するマッピング。

この引数の各インスタンスは Values to sum 引数に存在するディメンションである必要があります。

この引数を繰り返して、複数のマッピングを指定できます。

TEXTLIST 関数は結果をテキストで返します。結果ライン アイテムでは、Mapping 引数で使用されるすべてのディメンションを共有する必要があります。

Customer Sales.Product Text[TEXTLIST:Customer Sales.Customers, TEXTLIST:Customer Sales.Sales Period]

この例では、「Customer」と「Sales Period」の組み合わせごとに、「Product Text」ライン アイテムの各テキスト値がカンマ区切り値として返されています。

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

Mapping 引数と Values to list 引数でディメンションを同じにする必要があります。

TEXTLIST 集計関数はデータ型がテキストの値でのみ使用できます。データ型がリストの値を列挙する必要がある場合は、NAME 関数を使用してリストの値をテキストに変換できます。

Mapping 引数で選択したセル群に同じテキスト値が複数ある場合、TEXTLIST 集計関数では重複が返されます。TEXTLIST 計算関数では、各テキスト値を一度だけ返すことも、テキスト値間の区切り文字を変更することもできます。

非常に長いテキスト文字列が作成されることを防ぐため、TEXTLIST 集計関数では文字数が 1 万文字までに制限されています。1 万文字に達すると、リストへの追加が停止され、他にもアイテムがあることを示す省略記号が追加されます。省略記号は 1 万文字目ではなく、1 万 1 文字目に表示されます。1 万文字を超えた場合、TEXTLIST 関数では列挙された最後の単語が切り捨てられる場合があります。

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

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

CONCATENATE

以下は「Transactions」モジュールで、他の例で集計したデータが含まれています。このモジュールでは行に「Transactions」リストがあります。列には複数のライン アイテムがあり、以下が含まれています。

  • 販売製品のテキスト値
  • 販売先顧客のリスト値
  • 取引が発生した時間軸の値

Product Text顧客日付
Transaction 01ApplesCustomer AJan 21
Transaction 02BananasCustomer BJan 21
Transaction 03GrapefruitCustomer AJan 21
Transaction 04OrangesCustomer CFeb 21
Transaction 05ApplesCustomer DMar 21
Transaction 06GrapefruitCustomer BMar 21
Transaction 07OrangesCustomer BApr 21
Transaction 08BananasCustomer CApr 21
Transaction 09GrapefruitCustomer AMay 21
Transaction 10OrangesCustomer BJul 21
Transaction 11BananasCustomer AJul 21
Transaction 12OrangesCustomer AAug 21
Transaction 13BananasCustomer DSep 21
Transaction 14ApplesCustomer BSep 21
Transaction 15GrapefruitCustomer DOct 21
Transaction 16ApplesCustomer DOct 21
Transaction 17OrangesCustomer CNov 21
Transaction 18GrapefruitCustomer CNov 21
Transaction 19ApplesCustomer CDec 21
Transaction 20BananasCustomer DDec 21

この例では列に「Customer」リストがあります。行のライン アイテムには、TEXTLIST を使用して各顧客に販売された製品を列挙する式があります。


Customer ACustomer BCustomer CCustomer D

Products sold by customer

Transactions.Product Text[TEXTLIST:Transactions.Customer]

Apples, Grapefruit, Grapefruit, Bananas, OrangesBananas, Grapefruit, Oranges, Oranges, ApplesOranges, Bananas, Oranges, Grapefruit, ApplesApples, Bananas, Grapefruit, Apples, Bananas

この例では列に時間があります。行のライン アイテムには、TEXTLIST を使用して各時間軸で販売された製品を列挙する式があります。


Jan 21Feb 21Mar 21Apr 21May 21Jul 21Aug 21Sep 21Oct 21Nov 21Dec 21

Products sold in period

Transactions.Product Text[TEXTLIST:Transactions.Date]

Apples, Bananas, GrapefruitOrangesApples, GrapefruitOranges, BananasGrapefruitOranges, BananasOrangesBananas, ApplesGrapefruit, ApplesOranges, GrapefruitApples, Bananas

この例では、列に「Customer」リスト、行に時間があります。

ページにはライン アイテムがあり、選択したライン アイテムには次の式があります。

Transactions.Product Text[TEXTLIST:Transactions.Customer, TEXTLIST:Transactions.Date]

顧客と時間軸の各組み合わせについて、販売製品が式によって列挙されています。


Customer ACustomer BCustomer CCustomer D
Jan 21Apples, GrapefruitBananas

Feb 21

Oranges
Mar 21
Grapefruit
Apples
Apr 21
OrangesBananas
May 21Grapefruit


Jul 21BananasOranges

Aug 21Oranges


Sep 21
Apples
Bananas
Oct 21


Grapefruit, Apples
Nov 21

Oranges, Grapefruit
Dec 21

ApplesBananas