Visuels Power BI certifiés

Les visuels Power BI certifiés sont des visuels Power BI dans AppSource qui satisfont aux exigences de code et aux tests de l’équipe Microsoft Power BI. Les tests effectués sont conçus pour vérifier que le visuel n’a pas accès à des services ni à des ressources externes. Toutefois, Microsoft n’étant pas l’auteur des visuels personnalisés tiers, nous conseillons aux utilisateurs de contacter directement l’auteur de ces visuels pour vérifier leur fonctionnement.

Les visuels Power BI certifiés s’utilisent comme n’importe quel autre visuel Power BI. Ils offrent plus de fonctionnalités que les visuels non certifiés. Par exemple, vous pouvez les exporter vers PowerPoint ou afficher le visuel dans les e-mails reçus quand un utilisateur s’abonne aux pages du rapport.

Le processus de certification est facultatif. C’est aux développeurs de décider s’ils souhaitent que leur visuel soit certifié. Les visuels Power BI qui ne sont pas certifiés ne sont pas nécessairement dangereux. Certains visuels Power BI ne sont pas certifiés parce qu’ils ne sont pas conformes à une ou plusieurs exigences de certification, Par exemple un visuel Power BI de type carte se connectant à un service externe ou un visuel Power BI utilisant des bibliothèques commerciales ne peut pas être certifié.

Suppression de la certification

Microsoft se réserve le droit, à sa discrétion, de supprimer un visuel de la liste des visuels certifiés.

Critères de certification

Pour que votre visuel Power BI soit certifié, il doit répondre aux exigences énumérées dans cette section.

Conditions générales

Votre visuel Power BI doit être approuvé par l’Espace partenaires. Avant de demander la certification, nous vous recommandons de publier votre visuel Power BI sur AppSource. Pour savoir comment publier un visuel Power BI sur AppSource, consultez Publier des visuels Power BI sur l’Espace partenaires.

Avant de soumettre votre Power BI pour le certifier, vérifiez que :

• Le visuel est conforme à la marche à suivre pour les visuels Power BI
• Le visuel réussit tous les tests requis
• Le package compilé correspond exactement au package soumis

Exigences relatives au référentiel de code

Bien qu’il ne soit pas nécessaire de partager publiquement votre code dans GitHub, l’équipe Power BI doit avoir accès au référentiel de code pour pouvoir l’examiner. La meilleure solution consiste à fournir le code source (JavaScript ou TypeScript) dans GitHub.

Le référentiel doit contenir :

• Code pour un seul élément visuel Power BI. Il ne peut pas contenir le code de plusieurs visuels Power BI ou du code sans rapport.
• Une branche nommée certification (obligatoirement en minuscules). Le code source de cette branche doit correspondre au package soumis. Ce code ne peut être mis à jour que lors du processus d’envoi suivant, si vous envoyez à nouveau votre visuel Power BI.

Si votre visuel Power BI utilise des packages npm privés ou des sous-modules GIT, vous devez aussi fournir l’accès aux référentiels contenant ce code.

Pour comprendre l’aspect d’un référentiel visuel Power BI, examinez le référentiel GitHub sur le Graphique à barres exemple des éléments visuels Power BI.

Exigences relatives aux fichiers

Utilisez la dernière version de l’API pour écrire le visuel Power BI.

Le référentiel doit comporter les fichiers suivants :

• .gitignore - Ajoutez node_modules, .tmp et dist à ce fichier. Le code ne peut pas inclure les dossiers node_modules, .tmp ou dist.
• capabilities.json : si vous soumettez une version plus récente d’un visuel Power BI existant dont les propriétés ont été modifiées dans ce fichier, vérifiez qu’elles ne bloquent pas les rapports pour les utilisateurs existants.
• pbiviz.json
• package.json. Le package suivant doit être installé dans le visuel :
  • "typescript"
  • "eslint"
  • "eslint-plugin-powerbi-visuals"
  • Le fichier doit contenir une commande pour exécuter linter - "eslint": "npx eslint . --ext .js,.jsx,.ts,.tsx"
• package-lock.json
• tsconfig.json

Exigences relatives aux commandes

Vérifiez que les commandes suivantes ne retournent aucune erreur.

• npm install

• pbiviz package

• npm audit : ne doit retourner aucun avertissement de niveau élevé ou modéré.

• ESlint avec la configuration requise. Cette commande ne doit retourner aucune erreur Lint.

  Notes

  Nous migrons actuellement de TSlint vers ESLint. Les visuels utilisant TSlint seront acceptés pour la certification jusqu’en mars 2023. Après cela, ESlint sera obligatoire.

Exigences relatives à la compilation

Utilisez la dernière version de powerbi-visuals-tools pour écrire le visuel Power BI.

Compilez votre visuel Power BI avec pbiviz package. Si vous utilisez vos propres scripts de build, fournissez une commande de build personnalisée npm run package.

Exigences relatives au code source

Vérifiez que vous suivez la liste des stratégies de certification supplémentaires des visuels Power BI. Si votre envoi ne suit pas ces instructions, l’e-mail de rejet de l’Espace partenaires comportera les numéros de stratégie indiqués dans ce lien.

Suivez les exigences relatives au code répertoriées ici pour vous assurer que votre code est conforme aux stratégies de certification Power BI.

Requis

• N’utilisez que des composants OSS consultables par le public, comme des bibliothèques publiques JavaScript ou TypeScript.
• Le code doit prendre en charge l’API d’événements de rendu.
• Vérifiez que le DOM est correctement manipulé. Utilisez l’assainissement pour la saisie ou les données utilisateur avant de les ajouter au DOM.
• Utilisez l’exemple de rapport comme jeu de données de test.

Non autorisé

• Accès à des services ou ressources externes. Par exemple, aucune requête HTTP/S ou WebSocket ne peut accéder à des services à l’extérieur de Power BI. Par conséquent, les privilèges WebAccess doivent être vides, ou omis, dans les paramètres de fonctionnalités.
• Usage de innerHTML ou de D3.html(user data or user input).
• Erreurs ou exceptions JavaScript dans la console du navigateur pour les données d’entrée.
• Code arbitraire ou dynamique, comme eval(), utilisation non sécurisée de settimeout(), de requestAnimationFrame(), de setinterval(user input function) et de la saisie ou des données utilisateur.
• Fichiers ou projets JavaScript minifiés.

Soumission d’un visuel Power BI pour certification

Vous êtes maintenant prêt à soumettre une demande de certification de votre visuel Power BI par l’équipe Power BI.

Pour demander la certification Power BI :

1. Connectez-vous à l’Espace partenaires.
2. Sur la page Vue d’ensemble, choisissez votre visuel Power BI, puis accédez à la page de configuration du produit.
3. Cochez la case Demander la certification Power BI.
4. Sur la page Vérifier et publier, dans la zone de texte Remarques pour la certification, fournissez un lien vers le code source et les informations d'identification requises pour y accéder.

Processus d’envoi du référentiel privé

Si vous utilisez un référentiel privé tel que GitHub pour envoyer votre élément visuel Power BI pour certification, suivez les instructions de cette section.

1. Créez un nouveau compte pour l’équipe de validation.
2. Configurez l’authentification à deux facteurs pour votre compte.
3. Générez un nouvel ensemble de codes de récupération.
4. Quand vous soumettez votre visuel Power BI, veillez à fournir les détails suivants :
   • un lien web vers le référentiel
   • Identifiants de connexion (y compris un mot de passe)
   • des codes de récupération
   • des autorisations en lecture seule sur notre compte (pbicvsupport)

Badges visuels Power BI certifiés

Quand un visuel Power BI est certifié, il obtient un badge désigné qui indique qu’il est certifié.

Visuels Power BI certifiés dans AppSource

• Lorsque quelqu’un recherche en ligne des visuels Power BI dans AppSource, un petit badge jaune sur la carte du visuel indique qu’il s’agit d’un visuel Power BI certifié.

  

• Après avoir cliqué sur la carte du visuel Power BI dans AppSource, un badge jaune intitulé Certifié PBI indique que ce visuel Power BI est certifié.

  

Visuels Power BI certifiés dans l’interface Power BI

• Lorsque vous importez un visuel Power BI à partir de Power BI (Desktop ou service), un badge bleu indique que le visuel Power BI est certifié.

  

• Vous pouvez afficher uniquement les visuels Power BI certifiés, en sélectionnant l’option de filtre Certifié Power BI.

Chronologie de la publication

Le processus de déploiement vers AppSource peut prendre du temps. Votre visuel Power BI sera disponible au téléchargement à partir d’AppSource une fois ce processus terminé.

Quand les utilisateurs pourront-ils télécharger mon visuel ?

• Si vous avez envoyé un nouveau visuel Power BI, les utilisateurs peuvent le télécharger quelques heures après que vous avez reçu un e-mail d’AppSource.

• Si vous avez envoyé une mise à jour à un visuel Power BI existant, les utilisateurs peuvent la télécharger dans un délai d’un mois.

  Notes

  Le champ Version dans AppSource est mis à jour à la date où votre visuel Power BI a été approuvé par AppSource, soit environ une semaine après son envoi. Les utilisateurs peuvent télécharger le visuel mis à jour, mais les fonctionnalités mises à jour ne prendront pas effet. Les nouvelles fonctionnalités de votre visuel affectent les rapports de l’utilisateur au bout d’environ deux semaines.

Quand mon visuel Power BI affichera-t-il un badge de certification ?

Le badge de certification devrait être visible dans les trois semaines suivant l’approbation de votre soumission.

Contenu connexe

• Questions fréquentes sur les visuels certifiés.
• Instructions pour la publication de visuels Power BI

D’autres questions ? Essayez la communauté Power BI.