Gestion de l’accès aux données

Fonctions de source de données

Un connecteur de données encapsule et personnalise le comportement d’une fonction de source de données dans la bibliothèque M. Par exemple, une extension pour une API REST utilise la fonction Web.Contents pour effectuer des requêtes HTTP. Actuellement, un ensemble limité de fonctions de source de données a été activé pour prendre en charge l’extensibilité.

• Web.Contents
• OData.Feed
• Odbc.DataSource
• AdoDotNet.DataSource
• OleDb.DataSource

Exemple :

[DataSource.Kind="HelloWorld", Publish="HelloWorld.Publish"]
shared HelloWorld.Contents = (optional message as text) =>
    let
        message = if (message <> null) then message else "Hello world"
    in
        message;

Type de source de données

Les fonctions marquées comme shared dans votre extension peuvent être associées à une source de données spécifique en incluant un DataSource.Kind attribut littéral sur la fonction avec le nom d’un enregistrement de définition de source de données. L’enregistrement de source de données définit les types d’authentification pris en charge par votre source de données et les informations de personnalisation de base (comme le nom d’affichage/étiquette). Le nom de l’enregistrement devient son identificateur unique.

Chaque fonction associée à la même source de données doit avoir les mêmes paramètres de fonction requis, notamment le nom, le type et l’ordre. (À des fins de type de source de données, un paramètre n’est pas considéré comme obligatoire s’il est marqué optional ou si ses métadonnées contiennent DataSource.Path = false.)

Les fonctions d’un type de source de données spécifique peuvent uniquement utiliser les informations d’identification associées à ce type. Les informations d’identification sont identifiées au moment de l’exécution en effectuant une recherche basée sur la combinaison des paramètres requis de la fonction. Pour plus d’informations sur la façon dont les informations d’identification sont identifiées, consultez Chemins de source de données.

Exemple :

HelloWorld = [
    Authentication = [
        Implicit = []
    ],
    Label = Extension.LoadString("DataSourceLabel")
];

Propriétés

Le tableau suivant répertorie les champs de votre enregistrement de définition de source de données.

Publier sur l’interface utilisateur

Comme pour l’enregistrement de définition de source de données , l’enregistrement Publier fournit à l’interface utilisateur Power Query les informations dont elle a besoin pour exposer cette extension dans la boîte de dialogue Obtenir des données .

Exemple :

HelloWorld.Publish = [
    Beta = true,
    ButtonText = { Extension.LoadString("FormulaTitle"), Extension.LoadString("FormulaHelp") },
    SourceImage = HelloWorld.Icons,
    SourceTypeImage = HelloWorld.Icons
];

HelloWorld.Icons = [
    Icon16 = { Extension.Contents("HelloWorld16.png"), Extension.Contents("HelloWorld20.png"), Extension.Contents("HelloWorld24.png"), Extension.Contents("HelloWorld32.png") },
    Icon32 = { Extension.Contents("HelloWorld32.png"), Extension.Contents("HelloWorld40.png"), Extension.Contents("HelloWorld48.png"), Extension.Contents("HelloWorld64.png") }
];

Propriétés

Le tableau suivant répertorie les champs de votre enregistrement de publication.