Gestion de la navigation
Les tables de navigation font partie intégrante de la fourniture d’une interface conviviale pour votre connecteur. L’interface Power Query les affiche à l’utilisateur une fois que celui-ci a entré tous les paramètres requis pour votre fonction de source de données, et qu’il s’est authentifié auprès de la source de données.
En arrière-plan, une table de navigation n’est qu’une valeur Table M ordinaire avec des champs de métadonnées spécifiques définis sur son Type. Quand votre fonction de source de données retourne une table avec ces champs définis, Power Query affiche la boîte de dialogue du navigateur. Vous pouvez réellement voir les données sous-jacentes sous forme de valeur Table en cliquant avec le bouton droit sur le nœud racine et en sélectionnant Modifier.
Table.ToNavigationTable
Vous pouvez utiliser la fonction Table.ToNavigationTable pour ajouter les métadonnées de type de table nécessaires pour créer une table de navigation.
Remarque
Vous devez actuellement copier et coller cette fonction dans votre extension M. À l’avenir, elle sera probablement déplacée dans la bibliothèque M standard.
La table suivante décrit les paramètres pour cette fonction :
| Paramètre | Détails |
|---|---|
| table | Votre table de navigation. |
| keyColumns | Liste des noms de colonnes qui agissent comme clé primaire pour votre table de navigation. |
| nameColumn | Nom de la colonne à utiliser comme nom complet dans le navigateur. |
| dataColumn | Nom de la colonne qui contient la table ou la fonction à afficher. |
| itemKindColumn | Nom de la colonne à utiliser pour déterminer le type d’icône à afficher. Consultez ci-dessous la liste des valeurs valides pour la colonne. |
| itemNameColumn | Nom de la colonne à utiliser pour déterminer le comportement d’aperçu. Il est généralement défini sur la même valeur que itemKind. |
| isLeafColumn | Nom de la colonne utilisée pour déterminer s’il s’agit d’un nœud feuille ou si le nœud peut être développé pour contenir une autre table de navigation. |
La fonction ajoute les métadonnées suivantes au type de table :
| Champ | Paramètre |
|---|---|
| NavigationTable.NameColumn | nameColumn |
| NavigationTable.DataColumn | dataColumn |
| NavigationTable.ItemKindColumn | itemKindColumn |
| NavigationTable.IsLeafColumn | isLeafColumn |
| Preview.DelayColumn | itemNameColumn |
Valeurs de ItemKind
Chacune des valeurs suivantes de genre d’élément a une icône distincte dans la table de navigation.
- Flux
- Base de données
- DatabaseServer
- Dimension
- Table
- Dossier
- Fonction
- Affichage
- Feuille
- DefinedName
- Enregistrer
Exemples
Table de navigation plate
L’exemple de code suivant affiche une table de navigation plate avec trois tables et une fonction.
shared NavigationTable.Simple = () =>
let
objects = #table(
{"Name", "Key", "Data", "ItemKind", "ItemName", "IsLeaf"},{
{"Item1", "item1", #table({"Column1"}, {{"Item1"}}), "Table", "Table", true},
{"Item2", "item2", #table({"Column1"}, {{"Item2"}}), "Table", "Table", true},
{"Item3", "item3", FunctionCallThatReturnsATable(), "Table", "Table", true},
{"MyFunction", "myfunction", AnotherFunction.Contents, "Function", "Function", true}
}),
NavTable = Table.ToNavigationTable(objects, {"Key"}, "Name", "Data", "ItemKind", "ItemName", "IsLeaf")
in
NavTable;
shared FunctionCallThatReturnsATable = () =>
#table({"DynamicColumn"}, {{"Dynamic Value"}});
Ce code entraînera l’affichage du Navigateur suivant dans Power BI Desktop :
Table de navigation à plusieurs niveaux
Il est possible d’utiliser des tables de navigation imbriquées pour créer une vue hiérarchique de votre jeu de données. Pour cela, définissez la valeur IsLeaf pour cette ligne sur false (qui la marque comme un nœud qui peut être développé) et mettez en forme la colonne Data pour en faire une autre table de navigation.
shared NavigationTable.Nested = () as table =>
let
objects = #table(
{"Name", "Key", "Data", "ItemKind", "ItemName", "IsLeaf"},{
{"Nested A", "n1", CreateNavTable("AAA"), "Table", "Table", false},
{"Nested B", "n2", CreateNavTable("BBB"), "Table", "Table", false},
{"Nested C", "n3", CreateNavTable("CCC"), "Table", "Table", false}
}),
NavTable = Table.ToNavigationTable(objects, {"Key"}, "Name", "Data", "ItemKind", "ItemName", "IsLeaf")
in
NavTable;
CreateNavTable = (message as text) as table =>
let
objects = #table(
{"Name", "Key", "Data", "ItemKind", "ItemName", "IsLeaf"},{
{"Item1", "item1", #table({"Column1"}, {{message}}), "Table", "Table", true},
{"Item2", "item2", #table({"Column1"}, {{message}}), "Table", "Table", true}
}),
NavTable = Table.ToNavigationTable(objects, {"Key"}, "Name", "Data", "ItemKind", "ItemName", "IsLeaf")
in
NavTable;
Ce code produirait l’affichage de Navigateur suivant dans Power BI Desktop :
Tables de navigation dynamiques
Des fonctionnalités plus complexes peuvent être créées sur ces bases. Bien que tous les exemples ci-dessus montrent des entités codées en dur dans la table de navigation, il est facile de voir comment une table de navigation pourrait être générée de façon dynamique sur la base d’entités disponibles pour un utilisateur donné. Voici quelques éléments clés à prendre en compte pour les tables de navigation dynamiques :
- Gestion des erreurs pour garantir une bonne expérience pour les utilisateurs qui n’ont pas accès à certains points de terminaison.
- Par défaut, l’évaluation des nœuds est paresseuse. Les nœuds de terminal ne sont pas évalués tant que le nœud parent n’est pas développé. Certaines implémentations de tables de navigation dynamiques à plusieurs niveaux peuvent entraîner une évaluation précipitée de l’arborescence entière. Veillez à surveiller le nombre d’appels que Power Query effectue lors de l’affichage initial de la table de navigation. Par exemple, Table.InsertRows est « plus paresseux » que Table.FromRecords, car il n’a pas besoin d’évaluer ses arguments.