PATHITEM 関数 (DAX)
PATH 関数の評価結果の文字列内で、指定された position にある項目を返します。 位置は、左から右にカウントされます。
構文
PATHITEM(<path>, <position>[, <type>])
パラメーター
path
PATH 関数の結果の形式のテキスト文字列。position
取得する項目の位置を示す整数式。型
(省略可能) 結果のデータ型を定義する列挙。列挙体
代替の列挙
説明
TEXT
0
テキスト データ型の結果が返されます (既定値)。
INTEGER
1
結果は整数として返されます。
戻り値
PATH 関数から返された識別子のリストの、指定された位置にある識別子。 PATH 関数からは、階層の最も遠いレベルから現在のレベルの順に項目が返されます。
説明
この関数を使用すると、PATH 関数から返された階層の特定のレベルを取得できます。 たとえば、すべての従業員の上司を階層レベルをスキップして取得できます。
position に 1 未満の値または path の要素の数を超える値を指定した場合、PATHITEM 関数は空白を返します。
type が有効な列挙要素ではない場合は、エラーが返されます。
この DAX 関数は DirectQuery モードでは使用できません。 DirectQuery モデルの制限の詳細については、https://go.microsoft.com/fwlink/?LinkId=219172 を参照してください。
使用例
次の例では、現在の従業員の 3 番目のレベルの上司が返されます。このコードは、従業員および上司の ID を PATH 関数の入力として受け取ります。PATH 関数は、現在の従業員の親の階層を示す文字列を返します。 PATHITEM は、この文字列の 3 番目のエントリを整数として返します。
=PATHITEM(PATH(Employee[EmployeeKey], Employee[ParentEmployeeKey]), 3, 1)