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 illustre les éléments suivants :

• Exportation de la fonction (HelloWorld.Contents), qui prend un paramètre de texte d’option.
• Définition d’un type de source de données qui :
  • Déclare qu’il 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 s’afficher dans la boîte de dialogue Obtenir des données Power BI Desktop.

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

La définition de connecteur suivante contient :

• Une instruction section.
• Une fonction de source de données avec métadonnées qui l’établit comme une définition de source de données avec le type HelloWorld et la publication HelloWorld.Publish.
• Un enregistrement Authentication déclarant que le seul type d’authentification pour cette source est implicite (anonyme).
• Un enregistrement de publication déclarant que cette connexion est en version bêta, quel texte charger à partir du fichier resx, l’image source et l’image de type source.
• Un 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éé et copié le fichier dans le répertoire approprié, suivez les instructions du tutoriel Installation du Kit de développement logiciel (SDK) PowerQuery, puis ouvrez Power BI. Vous pouvez rechercher « hello » pour trouver 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 Se connecter et la boîte de dialogue vous indique qu’il s’agit d’un « connecteur d’aperçu », car Beta 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 obtenir l’exemple entièrement implémenté, consultez l’exemple Hello World dans l’exemple de référentiel de connecteurs de données.