Функция PATHITEM (DAX)

Возвращает элемент с указанным параметром position из строки результатов вычисления функции PATH. Позиции считаются слева направо.

Синтаксис

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.

Пример

В следующем примере возвращается руководитель третьего уровня для текущего сотрудника. Идентификаторы сотрудника и руководителя используются как входные данные для функции PATH, которая возвращает строку с иерархией родительских элементов для текущего сотрудника. Функция PATHITEM возвращает из этой строки третий элемент в виде целого числа.

=PATHITEM(PATH(Employee[EmployeeKey], Employee[ParentEmployeeKey]), 3, 1)