リスト内の特定のアイテムの位置を見つけるには、ITEMLEVEL を使用します。リストは特定のアイテムのデータ型に基づいて識別されます。この関数を使用すると、アイテムからそのルート祖先または最も遠い最下層の子孫までの距離を見つけることができます。

ITEMLEVEL(Item[, Direction])

引数データ型説明
Itemリスト アイテムルート祖先または最も遠い最下層の子孫までの距離が返されるリスト アイテム。
Direction (オプション)キーワード

距離を測定する方向を決定します。

キーワードは ROOTLEAF です。

  • ROOT - Item のルート祖先の数とそれ自体をカウントします。
    Direction 引数を省略した場合のデフォルトのキーワードです。
  • LEAF - Item の最も遠い子孫までのパスにあるアイテムの数と、それ自体をカウントします。

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

  ITEMLEVEL(Item)

Result 2

  ITEMLEVEL(Item, LEAF)

Spain31
Italy31
England41
Scotland41
Wales41
Greater London41
United Kingdom00
France31
Germany31
Europe00
India31
China31
Japan31
Asia00
San Jose51
San Francisco51
Los Angeles51
California00
Texas41
New York41
United States00
Canada31
North America00
All regions00
  • ITEMLEVEL(Item) では、Item のルート祖先の数とそれ自体をカウントします。
  • ITEMLEVEL(Item, LEAF) では、Item の最も遠い子孫までのパスにあるアイテムの数と、それ自体をカウントします。