FINDITEM 関数は、指定されたリストまたは時間で、アイテムか時間軸の名前とコードのなかでテキスト値を検索します。FINDITEM 関数で一致が見つかった場合、対応するリスト アイテムか時間軸が返されます。
たとえば、FINDITEM 関数を使用して、ある地域で利用できるアイテムが他の地域でも利用できるかどうかをチェックできます。
構文
FINDITEM(List_or_Time, Item_to_find)
引数
| 引数 | データ型 | 説明 |
| List 又は Time | リスト又は時間ディメンション | Item to find 引数で検索するリスト。 時間ディメンションを使用して期間を検索することもできます。 |
| Item to find | テキスト | 検索するリスト アイテム又は時間軸の名前かコードと照合するテキスト |
FINDITEM 関数は指定した List 又は Time 引数に応じて、データ型がリストか時間軸の結果を返します。
計算エンジンの機能の違い
Polaris では、Time 引数を一つ指定した状態で FINDITEM 関数を使用することはできません。
Classic エンジンでは、Time 引数を一つ又は二つ指定した状態で FINDITEM を使用できます。
構文の例
FINDITEM(USA Products, Product Name)
制約
結果ライン アイテムの構成
List 又は Time 引数がリストの場合、結果ライン アイテムのデータ型をリストにし、同じリストで構成する必要があります。
List 又は Time 引数で時間を使用している場合、結果ライン アイテムのデータ型を時間軸にする必要があります。FINDITEM 関数によって返される結果はライン アイテムの時間軸粒度 (月や四半期など) によって異なります。
同等の操作が行える Excel の関数
例
これらの例では「Products」リストを参照しています。General Lists の [Grid View] タブで見たとおり、「Products」リストには以下のアイテムがあります。
| Parent (親) | Code (コード) | Fruit subset | Vegetable subset | |
| Apples | Fruit | APP001 | ||
| Peaches | Fruit | PEA002 | ||
| Bananas | Fruit | BAN003 | ||
| Fruit | Total Products | |||
| Carrots | Vegetables | CAR004 | ||
| Cucumbers | Vegetables | CUC005 | ||
| Lettuce | Vegetables | LET006 | ||
| Vegetables | Total Products | |||
| Total Products |
リストの例
こちらの例では、列に時間、行に三つのライン アイテムがあります。
各月の最も売れている商品はダッシュボードの「Top-selling product」ライン アイテムに手動で入力されています。「Fruit product top seller?」ライン アイテムと「Vegetable product top seller?」ライン アイテムでは、FINDITEM 関数を使用して果物と野菜のなかで最も売れている商品をそれぞれ返しています。
| Jan 22 | Feb 22 | Mar 22 | Apr 22 | May 22 | Jun 22 | |
| Top-selling product | Apples | Bananas | Cucumbers | Cucumbers | Peaches | Lettuce |
Fruit product top seller?
| Apples | Bananas | Peaches | |||
Vegetable product top seller?
| Cucumbers | Cucumbers | Lettuce |
コードがあるリストの例
この例は、リスト アイテム名のテキストの代わりに、リスト アイテムのコードを使用してアイテムを見つける方法を示したものです。
| Jan 22 | Feb 22 | Mar 22 | Apr 22 | May 22 | Jun 22 | |
| Code of top-selling product | APP001 | BAN003 | CUC005 | CUC005 | PEA002 | LET006 |
Fruit product top seller?
| Apples | Bananas | Peaches | |||
Vegetable product top seller?
| Cucumbers | Cucumbers | Lettuce |
