Packager un visuel Power BI

Pour pouvoir charger votre visuel personnalisé dans Power BI Desktop ou le partager avec la communauté dans la Galerie d’éléments visuels de Power BI, vous devez l’empaqueter. À l’aide de ce tutoriel, vous allez :

• Fournir des valeurs de propriété et des métadonnées pour le visuel.
• Mettre à jour l’icône.
• Empaqueter le visuel personnalisé.

Entrez des valeurs de propriété

1. Dans PowerShell, arrêtez le visuel s’il est en cours d’exécution.

2. Dans VS Code, accédez au dossier racine de votre projet de visuel et ouvrez le fichier pbiviz.json.

3. Dans l’objet visual, définissez la valeur displayName sur le nom d’affichage que vous voulez attribuer à votre visuel.

   

   Le nom d’affichage du visuel apparaît dans le volet Visualisations de Power BI lorsque vous pointez le curseur sur l’icône du visuel.

4. Renseignez ou modifiez les champs suivants dans le fichier pbiviz.json :

   • visualClassName
   • description

   visualClassName est facultatif, mais description doit être renseigné pour que la commande de package s’exécute.

5. Renseignez supportUrl et gitHubUrl avec les URL qu’un utilisateur peut visiter pour obtenir de l’aide et afficher le projet GitHub de votre visuel.

   Le code suivant montre des exemples de supportUrl et gitHubUrl :

   {
       "supportUrl": "https://community.powerbi.com",
       "gitHubUrl": "https://github.com/microsoft/PowerBI-visuals-circlecard"
   }
   

6. Entrez votre nom et votre e-mail dans l’objet author.

7. Enregistrez le fichier pbiviz.json.

Mettez à jour l’icône (facultatif).

1. Dans le fichier pbiviz.json, notez que le document définit un chemin d’accès à une icône dans l’objet assets. L’icône est l’image qui apparaît dans le volet Visualisations dans Power BI. Ce doit être un fichier au format PNG de 20 x 20 pixels.

2. Dans l’Explorateur Windows, copiez le fichier icon.png que vous voulez utiliser, puis collez-le pour remplacer le fichier icon.png par défaut qui se trouve dans le dossier assets.

3. Dans VS Code, dans le volet Explorateur, développez le dossier assets, puis sélectionnez le fichier icon.png.

4. Vérifiez l’icône.

   

Empaqueter le visuel

1. Dans VS Code, vérifiez que tous les fichiers sont enregistrés.

2. Dans PowerShell, entrez la commande suivante pour générer un fichier pbiviz :

   pbiviz package
   

   Cette commande crée un fichier pbiviz dans le répertoire /dist/ de votre projet de visuel, et remplace tout fichier pbiviz précédent susceptible d’exister.

   

Le package est produit dans le dossier /dist/ du projet. Le package contient tous les éléments requis pour importer le visuel personnalisé dans le service Power BI ou dans un rapport Power BI Desktop. Vous avez empaqueté le visuel personnalisé qui est désormais prêt à l’usage.

Étapes suivantes

Publier des visuels Power BI sur l’Espace partenaires

Importer un objet visuel personnalisé