リスト内の特定のアイテムの位置を見つけるには、ITEMLEVEL を使用します。リストは特定のアイテムのデータ型に基づいて識別されます。この関数を使用すると、アイテムからそのルート祖先または最も遠い最下層の子孫までの距離を見つけることができます。
構文
ITEMLEVEL(Item[, Direction])
引数
| 引数 | データ型 | 説明 |
| Item | リスト アイテム | ルート祖先または最も遠い最下層の子孫までの距離が返されるリスト アイテム。 |
| Direction (オプション) | キーワード | 距離を測定する方向を決定します。 キーワードは
|
ITEMLEVEL 関数は数値を返します。
計算エンジンの機能の違い
この関数は Polaris 計算エンジンでのみ使用できます。
構文の例
ITEMLEVEL(United States)
アイテム「United States」は「Geographic hierarchy」というリストに属しています。この関数は、「United States」からそのルート祖先までのリスト内のアイテムの数を返します。カウントにはそのアイテム自体も含まれます。
ITEMLEVEL(United States, LEAF)
この関数は、「United States」からその最も遠い子孫までの「Geographic hierarchy」リスト内のアイテムの数を返します。カウントにはそのアイテム自体も含まれます。
追加情報
関数の結果は、リストの種類とリスト内のリスト アイテムの位置によって異なります。主なポイントは以下のとおりです。
- この関数ではリスト内のアイテムのみをカウントします。リストはアイテムのデータ型に基づいて識別されます。
- 次の場合は 0 が返されます。
ROOT方向で Item にルート祖先がない。LEAF方向で Item に最下層の子孫がない。
- リスト アイテムが空白の場合、結果は 0 になります。
- トップレベル アイテムは、対応するリストの (一意の) ルートとして扱われます。
例
以下は地理的階層の例です。
| Spain | ||||
| Italy | ||||
| England | ||||
| Scotland | ||||
| Wales | ||||
| Greater London | ||||
| United Kingdom | ||||
| France | ||||
| Germany | ||||
| Europe | ||||
| India | ||||
| China | ||||
| Japan | ||||
| Asia | ||||
| San Jose | ||||
| San Francisco | ||||
| Los Angeles | ||||
| California | ||||
| Texas | ||||
| New York | ||||
| United States | ||||
| Canada | ||||
| North America | ||||
| All regions |
「All regions」には「North America」、「Asia」、「Europe」という三つの子があります。
- 「
North America」には「Canada」と「United States」という二つの子があります。- 「
United States」には「New York」、「Texas」、「California」という三つの子があります。- 「
California」には「Los Angeles」、「San Francisco」、「San Jose」という三つの子があります。
- 「
- 「
- 「
Asia」には「Japan」、「China」、「India」という三つの子があります。 - 「
Europe」には「Germany」、「France」、「United Kingdom」、「Italy」、「Spain」という五つの子があります。- 「
United Kingdom」には「Greater London」、「Wales」、「Scotland」、「England」という四つの子があります。
- 「
次のモジュールには三つのライン アイテムがあります。
- 「
Item」 には「Geographic hierarchy」のすべてのリスト アイテムが含まれています。 - 「
Result 1」と「Result 2」にはITEMLEVEL式があります。
| Item | Result 1 | Result 2 |
| Spain | 3 | 1 |
| Italy | 3 | 1 |
| England | 4 | 1 |
| Scotland | 4 | 1 |
| Wales | 4 | 1 |
| Greater London | 4 | 1 |
| United Kingdom | 0 | 0 |
| France | 3 | 1 |
| Germany | 3 | 1 |
| Europe | 0 | 0 |
| India | 3 | 1 |
| China | 3 | 1 |
| Japan | 3 | 1 |
| Asia | 0 | 0 |
| San Jose | 5 | 1 |
| San Francisco | 5 | 1 |
| Los Angeles | 5 | 1 |
| California | 0 | 0 |
| Texas | 4 | 1 |
| New York | 4 | 1 |
| United States | 0 | 0 |
| Canada | 3 | 1 |
| North America | 0 | 0 |
| All regions | 0 | 0 |
ITEMLEVEL(Item)では、Item のルート祖先の数とそれ自体をカウントします。ITEMLEVEL(Item, LEAF)では、Item の最も遠い子孫までのパスにあるアイテムの数と、それ自体をカウントします。