Share via

PATHITEM

  • Article

S’applique à :Colonne calculéeTable calculéeMesureCalcul visuel

Retourne l’élément à la position spécifiée à partir d’une chaîne résultant de l’évaluation d’une fonction PATH. Les positions sont comptées de gauche à droite.

Syntaxe

PATHITEM(<path>, <position>[, <type>])

Paramètres

Terme Définition
path Chaîne de texte sous la forme des résultats d’une fonction PATH.
position Expression entière spécifiant la position de l’élément à retourner.
type (Facultatif) Énumération qui définit le type de données du résultat :

énumération de type

Énumération Autre énumération Description
TEXT 0 Les résultats sont retournés avec le type de données text (Valeur par défaut.)
INTEGER 1 Les résultats sont retournés sous forme d’entiers.

Valeur renvoyée

Identificateur retourné par la fonction PATH à la position spécifiée dans la liste d’identificateurs. Les éléments retournés par la fonction PATH sont classés du plus éloigné à l’actuel.

Notes

  • Cette fonction peut être utilisée pour retourner un niveau spécifique à partir d’une hiérarchie retournée par une fonction PATH. Par exemple, vous pouvez retourner uniquement les responsables de niveau supérieur pour tous les employés.

  • Si vous spécifiez un nombre pour position qui est inférieur à un (1) ou supérieur au nombre d’éléments dans path, la fonction PATHITEM retourne une valeur vide (BLANK).

  • Si type n’est pas un élément d’énumération valide, une erreur est retournée.

  • Cette fonction n’est pas prise en charge pour une utilisation en mode DirectQuery quand elle est utilisée dans des colonnes calculées ou des règles de sécurité au niveau des lignes (RLS).

Exemple

L’exemple suivant retourne le responsable de troisième niveau de l’employé actuel ; il prend les ID de l’employé et du responsable comme entrée d’une fonction PATH qui retourne une chaîne avec la hiérarchie des parents à l’employé actuel. À partir de cette chaîne, PATHITEM retourne la troisième entrée sous la forme d’un entier.

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