Partager via

Certification de connecteur Power Query

  • Article

Remarque

Cet article décrit les exigences et le processus de soumission d’un connecteur personnalisé Power Query pour certification. Lisez l’intégralité de l’article avant de commencer le processus de certification.

Introduction

Le Kit de développement logiciel (SDK) Power Query permet à tout un chacun de créer un connecteur Power Query personnalisé pour se connecter à une source de données à partir de Power Query. Actuellement, les connecteurs personnalisés ne sont pris en charge que dans les modèles sémantiques Power BI (Power BI Desktop et service Power BI), et nécessitent l’utilisation d’une passerelle de données locale pour s’actualiser via le service Power BI. Les connecteurs personnalisés doivent être distribués individuellement par le développeur.

Les propriétaires de source de données qui développent un connecteur personnalisé pour leur source de données peuvent distribuer plus largement leur connecteur personnalisé aux utilisateurs de Power Query. Une fois qu’un connecteur personnalisé a été créé, utilisé et validé par des utilisateurs finaux, le propriétaire de la source de données peut le soumettre à la certification Microsoft.

La certification d’un connecteur personnalisé Power Query rend celui-ci publiquement disponible, prêt à l’emploi, à l’intérieur des modèles sémantiques Power BI (Power BI Desktop et service Power BI), de flux de données Power BI et de datamarts Power BI. Les connecteurs certifiés sont pris en charge dans PowerBI.com et toutes les versions de Power BI Premium.

Les connecteurs certifiés :

  • sont gérés par le développeur partenaire ;

  • bénéficient du support du développeur partenaire :

  • sont certifiés par Microsoft ;

  • sont distribués par Microsoft.

Nous travaillons avec les partenaires pour nous assurer qu’ils disposent d’un support de maintenance, mais les problèmes client en lien avec le connecteur proprement dit sont dirigés vers le développeur partenaire.

Différences entre connecteur certifié et connecteur personnalisé

Les connecteurs certifiés sont intégrés dans Power BI Desktop, et déployés dans le service Power BI, des flux de données Power BI et des datamarts Power BI. Les connecteurs personnalisés ne sont pris en charge que dans des modèles sémantiques Power BI et doivent être chargés dans Power BI Desktop, comme décrit dans Chargement de votre extension dans Power BI Desktop. Les connecteurs certifiés et personnalisés peuvent être actualisés via Power BI Desktop ou le service Power BI à l’aide d’une passerelle de données locale en implémentant une TestConnection. La passerelle de données locale est requise pour les connecteurs personnalisés.

Les connecteurs certifiés dans Power BI Desktop avec une implémentation de TestConnection prennent également en charge l’actualisation de bout en bout via le cloud (service Power BI) sans nécessité d’une passerelle de données locale. L’environnement du service Power BI héberge essentiellement une « passerelle cloud » qui s’exécute comme la passerelle locale. Après la certification, nous déploierons votre connecteur dans cet environnement afin qu’il soit disponible pour tous les clients Power BI.

Les connecteurs personnalisés et certifiés assortis de composants supplémentaires (par exemple, un pilote ODBC) nécessitent que ceux-ci soient installés sur l’ordinateur de l’utilisateur final et requièrent la passerelle de données locale, sauf si le composant supplémentaire est déployé sur le cloud Power BI. Actuellement, nous ne certifions et déployons aucun nouveau composant supplémentaire dans le cloud Power BI. Par conséquent, la certification de connecteurs dépendant d’un composant supplémentaire n’aura pas pour effet de lever l’exigence de passerelle de données locale.

Distribution de connecteur personnalisé

Les connecteurs personnalisés peuvent et doivent être distribués aux utilisateurs finaux avant certification.

M étant un langage polyvalent qui, comme expliqué dans Gestion de l’authentification, est capable d’interagir avec des informations d’identification stockées, nous devons donner aux utilisateurs un moyen de n’autoriser l’exécution que de connecteurs approuvés.

Côté développeurs, ceux-ci doivent auto-signer leur connecteur personnalisé et fournir à leurs utilisateurs les informations (empreinte numérique) nécessaires pour le charger en toute sécurité.

Côté utilisateurs, ceux-ci doivent utiliser l’empreinte numérique du développeur pour approuver et charger le connecteur personnalisé à utiliser en toute sécurité. Les utilisateurs peuvent également choisir de réduire leurs paramètres de sécurité pour autoriser le chargement de code non certifié par Microsoft ou un autre développeur, mais cette option n’est pas recommandée.

Vue d’ensemble de la certification

Prérequis

Pour garantir à nos clients une expérience optimale, nous prenons uniquement en compte les connecteurs qui satisfont à un ensemble de conditions préalables à la certification :

  • Le connecteur doit être destiné à un produit public.

  • Le connecteur doit être considéré comme achevé au niveau du code pour une version initiale. Le programme permet des itérations et mises à jour fréquentes. Veuillez noter que Microsoft ne propose ni assistance technique ni conseil en matière de développement de connecteurs personnalisés. Nous vous recommandons d’utiliser des ressources publiques comme notre documentation du kit de développement logiciel (SDK) et notre référentiel d’exemples. Si vous avez besoin d’une assistance supplémentaire, nous pouvons vous communiquer une liste de consultants tiers connus pour le développement de connecteurs personnalisés que vous pouvez contacter directement, en dehors de tout programme ou partenariat avec Microsoft. Veuillez noter que Microsoft n’est affilié à aucun de ces consultants et n’est pas responsable de votre utilisation de leurs services. Microsoft fournit cette liste pour vous faciliter la tâche, mais sans aucune assurance, recommandation ou garantie. Contactez votre contact de certification Microsoft pour en savoir plus.

  • Le développeur doit fournir une estimation de l’utilisation. Nous suggérons aux développeurs de connecteurs destinés à des produits de niche d’utiliser nos fonctionnalités d’auto-signature de connecteur pour les fournir directement aux clients.

  • Le connecteur doit être déjà mis directement à la disposition des clients pour répondre à un besoin utilisateur ou à un scénario commercial. Ce critère peut être rempli à travers un programme de Préversion privée en distribuant le connecteur terminé directement aux utilisateurs finaux et aux organisations par le biais d’une auto-signature. Chaque utilisateur ou organisation doit être en mesure de formuler des commentaires, ainsi que de valider l’existence d’un besoin du connecteur et le fait que celui-ci répond à ses besoins.

  • Le connecteur doit fonctionner correctement à un niveau d’utilisation prévu par les clients.

  • Il doit y avoir un fil de discussion animé par des clients sur le forum Idées de Power BI traduisant la demande de rendre le connecteur publiquement disponible dans Power BI Desktop. Il n’existe pas de seuil d’engagement défini. Cependant, plus l’engagement est grand, plus la demande de connecteur est forte.

Ces conditions préalables ont pour but de s’assurer que les connecteurs soumis à certification répondent à un besoin important des clients, et qu’ils seront utilisés et soutenus après la certification.

Processus et chronologies

Les connecteurs certifiés étant publiés en même temps que les publications mensuelles de Power BI Desktop, les échéances pour chaque publication sont calculées à partir de chaque date de publication de Power BI Desktop. La durée prévue du processus de certification, de l’enregistrement à la publication, varie en fonction de la qualité et de la complexité de la soumission du connecteur. Microsoft ne garantit aucun délai spécifique concernant l’examen et l’approbation des connecteurs. Les délais fermes pour chaque examen de connecteur sont décrits dans les étapes suivantes, mais Microsoft ne garantit pas le respect de ces délais.

  • Inscription : notification de l’intention de certifier votre connecteur personnalisé. Cette inscription doit être faite avant le 15 du mois, deux mois avant la publication ciblée de Power BI Desktop.

    • Par exemple, pour la version Power BI Desktop du mois d’avril, la date limite est le 15 février.

  • Soumission : soumission des fichiers du connecteur pour révision par Microsoft. Elle doit être faite le 1er du mois avant la publication ciblée de Power BI Desktop.

    • Par exemple, pour la version Power BI Desktop du mois d’avril, la date limite est le 1er mars.

  • Révision technique : finalisation des fichiers du connecteur, passage de la révision et de la certification par Microsoft. Elle doit être faite avant le 15 du mois précédant la publication ciblée de Power BI Desktop.

    • Par exemple, pour la version Power BI Desktop du mois d’avril, la date limite est le 15 mars.

En raison de la complexité des révisions techniques et des retards potentiels, ainsi que des aspects liés à la ré-architecture et aux tests, nous recommandons vivement d’effectuer la soumission tôt, en prévoyant un long délai pour la publication et la certification initiales. Si vous estimez que votre connecteur est important et que vous devez le livrer à quelques clients avec un minimum de contraintes, nous vous recommandons de l’auto-signer et de le fournir de cette manière.

Critères de certification

Nous avons un certain ensemble d’exigences en matière de certification. Nous sommes conscients que tous les développeurs ne peuvent pas répondre à ces exigences, et espérons introduire à brève échéance un ensemble de dispositions qui répondront aux besoins des développeurs.

Fichiers de soumission (artefacts)

Vérifiez que les fichiers de connecteur que vous soumettez incluent tous les éléments suivants :

  • Fichier du connecteur (.mez)

    • Le fichier .mez doit respecter les normes de style et porter le même nom que le produit ou service. Il ne doit pas contenir de termes tels que « Power BI », « Connecteur » ou « API ».
    • Nommez le fichier .mez : ProductName.mez

  • Fichier Power BI Desktop (.pbix) pour test

    • Nous avons besoin d’un échantillon de rapport Power BI (.pbix) pour tester votre connecteur.
    • Le rapport doit inclure au moins une requête pour tester chaque élément de votre tableau de navigation.
    • S’il n’existe aucun schéma défini (par exemple, des bases de données), le rapport doit inclure une requête pour chaque « type » de table que le connecteur peut gérer.

  • Compte de test pour votre source de données

    • Nous utilisons le compte de test pour tester votre connecteur et résoudre des problèmes éventuels.
    • Fournissez un compte de test permanent afin que nous puissions l’utiliser pour certifier de futures mises à jour.

  • Instructions de test

    • Fournissez toute la documentation nécessaire sur la façon d’utiliser le connecteur et de tester sa fonctionnalité.

  • Liens vers des dépendances externes (par exemple, pilotes ODBC)

Fonctionnalités et style

Le connecteur doit respecter un ensemble de règles sur le plan des fonctionnalités et du style de manière à offrir un niveau de convivialité cohérent avec d’autres connecteurs certifiés.

  • Le connecteur DOIT :

  • Le FunctionName doit avoir du sens pour le domaine (par exemple, « Contenu », « Tables », « Document », « Bases de données », etc.).

  • Le connecteur DEVRAIT :

    • Avoir des icônes.
    • Fournir un tableau de navigation.
    • Placer des chaînes dans un fichier resources.resx. Les URL et valeurs devraient être codées en dur dans le code du connecteur, plutôt que placées dans le fichier resources.resx.

Sécurité

Il existe des considérations de sécurité spécifiques que votre connecteur doit gérer.

  • Si la fonction Extension.CurrentCredentials() est utilisée :

    • Son utilisation est-elle requise ? Si c’est le cas, où les informations d’identification sont-elles envoyées ?
    • Est-il garanti que les requêtes seront faites via HTTPS ?
    • Si les informations d’identification sont envoyées à l’aide de Web.Contents() via une requête GET :
      • Peut-elle être transformée en requête POST ?
      • Si une requête GET est requise, le connecteur DOIT utiliser l’enregistrement CredentialQueryString dans l’enregistrement d’options Web.Contents() pour transmettre des informations d’identification sensibles.

  • Si les fonctions Diagnostics.* sont utilisées :

    • Validez ce qui est suivi. Les données ne doivent pas contenir d’informations à caractère personnel ou de grandes quantités de données inutiles.
    • Si vous avez implémenté un suivi significatif dans le développement, vous devriez implémenter une variable ou un indicateur de fonctionnalité déterminant si le suivi devrait être activé. Ce suivi doit être désactivé avant de soumettre la demande de certification.

  • Si la fonction Expression.Evaluate() est utilisée :

    • Validez l’origine de l’expression, ainsi que sa nature (à savoir qu’elle peut construire de façon dynamique des appels à Extension.CurrentCredentials() et ainsi de suite).
    • L’Expression ne devrait pas être fournie par l’utilisateur ou prendre une entrée de celui-ci.
    • L’Expression ne devrait pas être dynamique (c’est-à-dire récupérée à partir d’un appel web).

Inscription à la certification

Si vous souhaitez poursuivre la certification de votre connecteur personnalisé, assurez-vous que votre scénario et votre connecteur sont respectent les conditions préalables et exigences décrites dans cet article. À défaut, la certification sera retardée car notre équipe vous demandera de corriger tout problème ou incohérence avant de procéder à la certification.

Assurez-vous que le code de votre connecteur est complet et qu’il a été testé tant pour la création dans Power BI Desktop, que pour l’actualisation et la consommation dans Power BI Service. Vérifiez que vous avez testé l’actualisation complète de bout en bout dans le service Power BI via l’utilisation d’une passerelle de données locale.

Pour commencer, remplissez notre formulaire d’inscription. Un contact Microsoft vous joindra pour entamer le processus.

Après la certification

Une fois que votre connecteur est certifié et publié via Power BI Desktop et le service Power BI, vous devez effectuer quelques opérations pour vous assurer que vous pouvez utiliser correctement le connecteur certifié disponible en production.

  • Vous et les utilisateurs finaux devez utiliser la version de connecteur certifiée incluse dans Power BI Desktop et la passerelle de données locale, et supprimer les fichiers .mez ou .pqx existants (connecteurs personnalisés) utilisés avant la certification. Dans le cas contraire, votre connecteur personnalisé de test pourrait être utilisé par Power Query par inadvertance au lieu du connecteur nouvellement certifié.
  • Les connecteurs personnalisés doivent uniquement être utilisés pour tester de nouvelles versions du connecteur.
  • Lorsque vous travaillez avec les utilisateurs finaux et les clients, assurez-vous qu’ils comprennent que la version du connecteur personnalisé utilisée dans les tests avant la certification doit être retirée une fois que les tests sont terminés et que la nouvelle version certifiée du connecteur est disponible.

Une fois que vous avez développé un connecteur à une source de données, envisagez d’aider les clients à être rapidement opérationnels en créant une application modèle. Une application modèle fournit aux clients un rapport prédéfini connecté à leurs données, qu’ils peuvent utiliser tel quel ou personnaliser si nécessaire.

Remarque

Les applications modèles ne prennent pas en charge les connecteurs nécessitant une passerelle.