Création de votre premier connecteur : Hello World

Cet exemple fournit une extension de source de données simple qui peut être exécutée dans Visual Studio Code et chargée dans Power BI Desktop.

Exemple Hello World

En guise de vue d’ensemble, cet exemple montre :

• Fonction d'exportation (HelloWorld.Contents), qui prend un paramètre texte optionnel.
• Définition d’un type de source de données qui :
  • Déclare qu’elle utilise l’authentification implicite (anonyme).
  • Utilise des ressources de chaîne qui autorisent la localisation.
  • Déclaration des métadonnées de l’interface utilisateur afin que l’extension puisse apparaître dans la boîte de dialogue Obtenir des données power BI Desktop.

En suivant les instructions de l’installation du Kit de développement logiciel (SDK) PowerQuery, créez un connecteur appelé « HelloWorld », copiez-le dans le code M suivant et collez-le dans le fichier HelloWorld.pq de votre espace de travail de connecteur, puis suivez les autres instructions pour pouvoir l’ouvrir dans Power BI.

Dans la définition de connecteur suivante, vous trouverez :

• Instruction section .
• Fonction de source de données avec des métadonnées qui l’établissent comme une définition de source de données avec le Type HelloWorld et la Publication HelloWorld.Publish.
• Un Authentication enregistrement déclarant que implicite (anonyme) est le seul type d’authentification pour cette source.
• Un enregistrement de publication déclarant que cette connexion est en version Beta, le texte à charger à partir du fichier resx, l'image source et l'image du type source.
• Enregistrement associant des tailles d’icônes à des PNG spécifiques dans le dossier de build.

section HelloWorld;
 
[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;
 
HelloWorld = [
    Authentication = [
        Implicit = []
    ],
    Label = Extension.LoadString("DataSourceLabel")
];
 
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") }
];

Une fois que vous avez créé le fichier et l’avez copié dans le répertoire approprié, suivez les instructions de l’installation du didacticiel du Kit de développement logiciel (SDK) PowerQuery , ouvrez Power BI. Vous pouvez rechercher « hello » pour rechercher votre connecteur dans la boîte de dialogue Obtenir des données .

Cette étape affiche une boîte de dialogue d’authentification. Étant donné qu’il n’existe aucune option d’authentification et que la fonction ne prend aucun paramètre, il n’y a pas d’autres étapes dans ces boîtes de dialogue.

Appuyez sur Connect et la boîte de dialogue vous indique qu’il s’agit d’un « connecteur d’aperçu », car Beta il est défini sur true dans la requête. Étant donné qu’il n’y a pas d’authentification, l’écran d’authentification présente un onglet pour l’authentification anonyme sans champs. Appuyez à nouveau sur Se connecter pour terminer.

Enfin, l’éditeur de requête affiche ce que vous attendez : une fonction qui retourne le texte « Hello world ».

Pour l’exemple entièrement implémenté, consultez l'exemple Hello World dans le référentiel d'exemples Data Connectors.