Fonction PATHITEM (DAX)

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

Syntaxe

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

Paramètres

• path
  Chaîne de texte sous la forme des résultats d'une fonction PATH.

• position
  Expression entière avec la position de l'élément à retourner.

• type
  (Facultatif) Énumération qui définit le type de données du résultat :

  É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 de retour

Identificateur retourné par la fonction PATH à la position spécifiée dans la liste des identificateurs. Les éléments retournés par la fonction PATH sont triés de l'élément le plus éloigné à l'élément actuel.

Notes

• Cette fonction peut être utilisée pour retourner un niveau spécifique d'une hiérarchie retournée par une fonction PATH. Par exemple, vous pouvez retourner uniquement les responsables de tous les employés, indépendamment du niveau hiérarchique.

• Si vous spécifiez un nombre pour position inférieur à un (1) ou supérieur au nombre d'éléments de path, la fonction PATHITEM retourne BLANK.

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

Cette fonction DAX n'est pas prise en charge en mode DirectQuery. Pour plus d'informations sur les limitations dans les modèles DirectQuery, consultez https://go.microsoft.com/fwlink/?LinkId=219172.

Exemple

L'exemple suivant retourne le responsable de troisième niveau de l'employé actuel ; il utilise les ID de l'employé et du responsable en tant qu'entrées d'une fonction PATH qui retourne une chaîne comprenant la hiérarchie des éléments parents de l'employé actuel. À partir de cette chaîne, PATHITEM retourne la troisième entrée sous forme d'entier.

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