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)