PATH
S’applique à :
Colonne calculéeTableau calculéeMesureCalcul de visuel
Retourne une chaîne de texte délimitée contenant les identificateurs de tous les parents de l’identificateur actuel, en commençant par le niveau le plus ancien et en continuant jusqu’au niveau actuel.
Syntaxe
PATH(<ID_columnName>, <parent_columnName>)
Paramètres
| Terme | Définition |
|---|---|
| ID_columnName | Nom d’une colonne existante contenant l’identificateur unique des lignes de la table. Il ne peut pas s’agir d’une expression. La valeur ID_columnName doit être de type texte ou entier. Son type de données doit également correspondre à celui de la colonne référencée dans parent_columnName. |
| parent_columnName | Nom d’une colonne existante contenant l’identificateur unique du parent de la ligne actuelle. Il ne peut pas s’agir d’une expression. La valeur parent_columnName doit être de type texte ou entier. Son type de données doit également correspondre à celui de la valeur ID_columnName. |
Valeur renvoyée
Chaîne de texte délimitée avec les identificateurs de tous les parents de l’identificateur actuel.
Notes
Cette fonction est utilisée dans les tables possédant un type de hiérarchie interne pour retourner les éléments associés à la valeur de ligne actuelle. Par exemple, dans une table d’employés contenant des employés, les responsables des employés et les responsables des responsables, vous pouvez retourner le chemin qui connecte un employé à son ou sa responsable.
Le chemin n’est pas restreint à un seul niveau de relations parent-enfant. Il peut retourner des lignes associées situées plusieurs niveaux au-dessus de la ligne de départ spécifiée.
- Le délimiteur utilisé pour séparer les ascendants est la barre verticale « | ».
- Le même type de données (texte ou entier) doit être utilisé pour les valeurs ID_columnName et parent_columnName.
- La valeur parent_columnName doit être présente dans ID_columnName. Autrement dit, vous ne pouvez pas rechercher un parent si aucune valeur n’est disponible au niveau enfant.
- Si parent_columnName est vide, PATH() retourne la valeur ID_columnName. En d’autres termes, si vous recherchez le responsable d’un employé mais que la colonne parent_columnName est vide, la fonction PATH retourne simplement l’ID d’employé.
- Si ID_columnName contient des doublons et que la valeur parent_columnName est la même pour ces doublons, PATH() retourne la valeur parent_columnName commune. Toutefois, si la valeur parent_columnName est différente pour ces doublons, PATH() retourne une erreur. En d’autres termes, si vous avez deux listes pour le même ID d’employé et que l’ID de responsable est le même pour les deux, la fonction PATH retourne l’ID de ce responsable. Toutefois, si deux ID d’employé identiques sont associés à des ID de responsable différents, la fonction PATH retourne une erreur.
- Si ID_columnName est vide, PATH() retourne une valeur vide.
- Si ID_columnName contient une barre verticale « | », PATH() retourne une erreur.
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 crée une colonne calculée qui liste tous les responsables de chaque employé.
= PATH(Employee[EmployeeKey], Employee[ParentEmployeeKey])