HIERARCHYLEVEL を使用して、指定されたリスト内の座標の位置を見つけます。ライン アイテムの値を指定すると、この関数はその座標を使用して指定されたリスト内のレベルを特定します。これは、アイテムがリスト内のルート (トップ レベルの祖先) からどれだけ離れているか、又は最も遠い最下層 (ボトムアップ レベルの子孫) からどれだけ離れているかを判断するのに役立ちます。
構文
HIERARCHYLEVEL(List[, Direction[, Level type]])
引数
| 引数 | データ型 | 説明 |
| List (必須) | リスト又は時間 | ルート祖先または最も遠い最下層の子孫までの座標の距離を返すリスト又は時間の名前。 指定するリストは、式が設定されているライン アイテムで使用されるディメンションの一つに関連している必要があります。 |
| Direction (オプション) | キーワード | 距離を測定する方向を決定します。 キーワードは
この引数は必須ではありません。ただし、Level type を使用する場合はこの引数を指定する必要があります。 |
| Level type (オプション) | キーワード | カウントに含めるリスト アイテムを決定します。 キーワードは
この引数は必須ではありません。ただし、この引数を使用する場合は Direction 引数を指定する必要があります。 |
HIERARCHYLEVEL 関数は数値を返します。
計算エンジンの機能の違い
この関数は Polaris 計算エンジンでのみ使用できます。
構文の例
HIERARCHYLEVEL(Geographic hierarchy)
この関数は、ライン アイテムの各値について、「Geographic hierarchy」階層内の値の座標の祖先の数を返します。カウントには座標自体も含まれます。
HIERARCHYLEVEL(Geographic hierarchy, LEAF, ALL)
この関数は、指定されたリスト「Geographic hierarchy」内の座標から最も遠い最下層の子孫までの距離とそれ自体を返します。カウントにはすべてのリスト アイテムが含まれます。
追加情報
関数の結果は、リストの種類とリスト内の座標の位置によって異なります。
- 座標が指定されたリストの一部でない場合、結果は 0 になります。
- 次の場合は 0 が返されます。
ROOT方向で座標にルート祖先がない。LEAF方向で座標に最下層の子孫がない。
- トップレベル アイテムは、対応するリストの (一意の) ルートとして扱われます。
制約
- 指定するリストは、式が設定されているライン アイテムで使用されるディメンションの一つに関連している必要があります。
- また、ターゲット ディメンションの祖先階層では機能しません。
たとえば、ライン アイテムでディメンションとして「listB」を使用している場合、「listA」が「listB」の親であれば、この関数を「listA」で使用することはできません。
例
以下は地理的階層の例です。
| 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」、「Result 3」、「Result 4」にはHIERARCHYLEVEL式があります。
| Item | Result 1 | Result 2 | Result 3 | Result 4 |
| Spain | 3 | 1 | 2 | 3 |
| Italy | 3 | 1 | 2 | 3 |
| England | 4 | 1 | 2 | 4 |
| Scotland | 4 | 1 | 2 | 4 |
| Wales | 4 | 1 | 2 | 4 |
| Greater London | 4 | 1 | 2 | 4 |
| United Kingdom | 3 | 2 | 2 | 3 |
| France | 3 | 1 | 2 | 3 |
| Germany | 3 | 1 | 2 | 3 |
| Europe | 2 | 3 | 2 | 2 |
| India | 3 | 1 | 2 | 3 |
| China | 3 | 1 | 2 | 3 |
| Japan | 3 | 1 | 2 | 3 |
| Asia | 2 | 2 | 2 | 2 |
| San Jose | 5 | 1 | 2 | 5 |
| San Francisco | 5 | 1 | 2 | 5 |
| Los Angeles | 5 | 1 | 2 | 5 |
| California | 4 | 2 | 2 | 4 |
| Texas | 4 | 1 | 2 | 4 |
| New York | 4 | 1 | 2 | 4 |
| United States | 3 | 3 | 2 | 3 |
| Canada | 3 | 1 | 2 | 3 |
| North America | 2 | 4 | 2 | 2 |
| All regions | 1 | 5 | 1 | 1 |
