Partager via

Empaqueter un visuel Power BI

Avant de pouvoir charger votre visuel personnalisé dans Power BI Desktop ou le partager avec la communauté dans Power BI Visual Gallery, vous devez le empaqueter. À l’aide de ce tutoriel, vous allez :

Entrer 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 visuel et ouvrez le fichier pbiviz.json .

  3. Dans l’objet visual , définissez la displayName valeur sur ce que vous souhaitez être le nom d’affichage de votre visuel.

    Capture d’écran de VS Code, qui montre que la valeur du nom d’affichage est définie sur Circle Card.

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

  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 du support et pour consulter le projet GitHub de votre visuel.

    Le code suivant montre des exemples supportUrl et gitHubUrl.

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

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

  7. Enregistrez le fichier pbiviz.json .

Mettre à 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. Il doit s’agir d’un fichier de format PNG et de 20 x 20 pixels.

  2. Dans l’Explorateur Windows, copiez le fichier icon.png que vous souhaitez utiliser, puis collez-le pour remplacer le fichier icon.png par défaut situé dans le dossier ressources .

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

  4. Passez en revue 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 visuel et remplace tout fichier pbiviz précédent qui peut exister.

    Capture d’écran de l’Explorateur Windows, qui montre la hiérarchie de dossiers du projet visuel Power BI. Le dossier dist est mis en surbrillance.

Le package sort dans le dossier /dist/ du projet. Le package contient tout ce qui est nécessaire pour importer le visuel personnalisé dans le service Power BI ou dans un rapport Power BI Desktop. Vous avez empaqueté le visuel personnalisé et il est prêt à être utilisé.

Contenu connexe

  • Last updated on