Utiliser des visuels personnalisés optimisés pour R dans Power BIUse R-powered custom visuals in Power BI

Dans Power BI Desktop et dans le service Power BI, vous pouvez utiliser des visuels personnalisés optimisés pour R sans connaître R ni utiliser de script R.In Power BI Desktop and the Power BI service, you can use R-powered custom visuals without any knowledge of R, and without any R scripting. Cela vous permet d’exploiter la puissance d’analyse et visuelle des visuels R et des scripts R sans connaître R ni effectuer de programmation.This enables you to harness the analytic and visual power of R visuals, and R scripts, without learning R or doing any programming yourself.

Pour utiliser les visuels personnalisés optimisés pour R, il suffit de sélectionner préalablement le visuel personnalisé R qui vous intéresse à partir de la galerie AppSource de visuels personnalisés pour Power BI.To use R-powered custom visuals, you first select and download the R custom visual you're interested in using from the AppSource gallery of custom visuals for Power BI.

Les sections suivantes expliquent comment sélectionner, charger et utiliser les visuels optimisés pour R dans Power BI Desktop.The following sections describe how to select, load, and use R-powered visuals in Power BI Desktop.

Utiliser des visuels personnalisés RUse R custom visuals

Pour utiliser les visuels optimisés pour R, vous devez télécharger chaque visuel depuis la bibliothèque de visuels personnalisés, puis vous pouvez utiliser le visuel comme n’importe quel autre type de visuel dans Power BI Desktop.To use R-powered custom visuals, you need to download each visual from the custom visuals library, then you can use the visual like any other type of visual in Power BI Desktop. Il existe deux façons d’obtenir des visuels personnalisés : vous pouvez les télécharger à partir du site en ligne AppSource ou les parcourir et les obtenir à partir de Power BI Desktop.There are two ways to get custom visuals - you can download them from the online AppSource site, or you browse and get them from within Power BI Desktop.

Se procurer des visuels personnalisés à partir d’AppSourceGet custom visuals from AppSource

Voici les étapes pour parcourir et sélectionner des visuels à partir du site en ligne AppSource :Here are the steps to browse and select visuals from the online AppSource site:

  1. Accédez à la bibliothèque des visuels Power BI à l’adresse https://appsource.microsoft.com. Sélectionnez la case à cocher Applications Power BI sous Affiner par produit, puis sélectionnez le lien Afficher tout.Navigate to the Power BI visuals library, found at https://appsource.microsoft.com. Select the Power BI apps checkbox under Refine by product, then select the See all link.

  2. Sélectionnez Visuels Power BI dans la liste des compléments dans le volet gauche.Select Power BI visuals from the list of Add-ins in the left pane.

  1. Sélectionnez le visuel qui vous intéresse dans la galerie. La fenêtre qui s’affiche décrit le visuel.Select the visual you're interested in using from the gallery, and you're taken to a page that describes the visual. Sélectionnez le bouton Obtenir maintenant pour effectuer le téléchargement.Select the Get it now button to download.

    Note

    Pour créer des scripts dans Power BI Desktop, il est nécessaire que R soit installé sur votre ordinateur local.For authoring in Power BI Desktop, you need to have R installed on your local machine. Mais lorsque les utilisateurs souhaitent afficher un visuel optimisé pour R dans le service Power BI, il n’est pas nécessaire que R soit installé localement.But when users want to view an R-powered visual in the Power BI service they do not need R installed locally.

    Vous n’avez pas besoin d’installer R pour utiliser des visuels personnalisés optimisés pour R dans le service Power BI. Toutefois, si vous souhaitez utiliser des visuels personnalisés optimisés pour R dans Power BI Desktop, vous devez installer R sur l’ordinateur local.You do not need to install R to use R-powered custom visuals in the Power BI service, however, if you want to use R-powered custom visuals in Power BI Desktop you must install R on the local machine. Vous pouvez télécharger R à partir des emplacements suivants :You can download R from the following locations:

  2. Une fois le visuel téléchargé (comme n’importe quel fichier depuis le navigateur), accédez à Power BI Desktop et cliquez avec le bouton droit sur les points de suspension (...) dans le volet Visualisations, puis sélectionnez Importer à partir du fichier.Once the visual is downloaded (which is like downloading any file from your browser), go to Power BI Desktop and right-click the ellipsis (the ...) in the Visualizations pane, and select Import from file.

  3. Un message vous met en garde sur l’importation d’un visuel personnalisé, comme dans l’image suivante :You're cautioned about importing a custom visuals, as shown in the following image:

  4. Accédez à l’emplacement dans lequel le visuel a été enregistré, puis sélectionnez le fichier correspondant.Navigate to where the visual file was saved, then select the file. Les visualisations Power BI Desktop personnalisées ont l’extension .pbiviz.Power BI Desktop custom visualizations have the .pbiviz extension.

  5. De retour dans Power BI Desktop, vous pouvez constater que le nouveau type de visuel figure dans le volet Visualisations.When you return to Power BI Desktop, you can see the new visual type in the Visualizations pane.

  6. Lorsque vous importez le nouveau visuel (ou que vous ouvrez un rapport qui contient un visuel personnalisé optimisé pour R), Power BI Desktop installe les packages R requis.When you import the new visual (or open a report that contains a R-powered custom visual), Power BI Desktop installs the required R packages.

Vous pouvez alors ajouter des données au visuel comme vous le feriez pour n’importe quel autre visuel Power BI Desktop.From there, you can add data to the visual just as you would any other Power BI Desktop visual. Lorsque vous avez terminé, votre visuel généré s’affiche sur le canevas.When complete, you can see your finished visual on the canvas. Dans l’élément visuel suivant, le visuel Prévision optimisé pour R a été utilisé dans les projections de natalité des Nations Unies (visuel sur la gauche).In the following visual, the Forecasting R-powered visual was used with United Nations (UN) birth rate projections (the visual on the left).

Comme pour n’importe quel autre visuel Power BI Desktop, vous pouvez publier ce rapport avec ses visuels optimisés pour R dans le service Power BI et le partager avec d’autres utilisateurs.Like any other Power BI Desktop visual, you can publish this report with its R-powered visuals to the Power BI service and share it with others.

Visitez souvent la bibliothèque, car elle est continuellement mise à jour avec de nouveaux visuels.Check the library often, since new visuals are being added all the time.

Obtenir des visuels personnalisés à partir de Power BI DesktopGet custom visuals from within Power BI Desktop

Vous pouvez également obtenir des visuels personnalisés à partir de Power BI Desktop.You can also get custom visuals from within Power BI Desktop. Dans Power BI Desktop, cliquez sur les points de suspension (...) dans le volet Visualisations et sélectionnez Importer du Store.In Power BI Desktop right-click the ellipsis (the ...) in the Visualizations pane, and select Import from store.

Lorsque vous procédez ainsi, la boîte de dialogue Visuels personnalisés Power BI apparaît. Vous pouvez y faire défiler les visuels personnalisés disponibles et sélectionner ceux qui vous intéressent.When you do so, the Power BI Custom Visuals dialog appears, where you can scroll through the available custom visuals and select what you would like. Vous pouvez effectuer une recherche par nom, sélectionner une catégorie ou simplement parcourir les visuels disponibles.You can search by name, select a catagory, or just scroll through the available visuals. Lorsque vous êtes prêt, sélectionnez simplement ajouter pour ajouter le visuel personnalisé à Power BI Desktop.When you're ready, just select Add to add the custom visual to Power BI Desktop.

Contribuer aux visuels personnalisés optimisés pour RContribute R-powered custom visuals

Si vous créez vos propres visuels R pour les utiliser dans vos rapports, vous pouvez les partager de façon publique en les ajoutant à la galerie de visuels personnalisés.If you create your own R visuals for use in your reports, you can share those visual with the world by contributing your custom visual to the custom visuals gallery. Le processus de contribution réalisé par le biais de GitHub est décrit ici :Contributions are made through GitHub, and the process is outlined in the following location:

Résoudre les problèmes liés aux visuels personnalisés optimisés pour RTroubleshoot R-powered custom visuals

Pour qu’ils fonctionnent correctement, les visuels personnalisés optimisés pour R doivent avoir certaines dépendances.R-powered custom visuals have certain dependencies that must be met for the visuals to work properly. Quand les visuels personnalisés optimisés pour R ne s’exécutent pas ou ne se chargent pas correctement, le problème est généralement l’un des suivants :When R-powered custom visuals don't run or load properly, the problem is usually one of the following:

  • Le moteur R est manquant.The R engine is missing
  • Il existe des erreurs dans les scripts R sur lesquels repose le visuel.Errors in the R script on which the visual is based
  • Les packages R sont manquants ou obsolètes.R packages are missing or out of date

La section suivante décrit les étapes de dépannage possibles pour aider à répondre aux difficultés que vous rencontrez.The following section describes troubleshooting steps you can take to help address trouble you run into.

Packages R manquants ou obsolètesMissing or outdated R packages

Quand vous tentez d’installer un visuel personnalisé optimisé pour R, vous pouvez rencontrer des erreurs lorsque des packages R sont obsolètes ou manquants. Cela est généralement dû à une des raisons suivantes :When attempting to install an R-powered custom visual, you can run into errors when there are missing or outdated R packages; this is usually due to one of the following reasons:

  • L’installation de R n’est pas compatible avec le package R.The R installation is incompatible with the R package,
  • Des paramètres de proxy, un logiciel antivirus ou un pare-feu empêchent R de se connecter à Internet.A firewall, anti-virus software, or proxy settings are preventing R from connecting to the Internet
  • La connexion Internet est lente ou il y a un problème de connexion.The Internet connection is slow, or there's an Internet connection problem

L’équipe Power BI travaille activement à atténuer ces problèmes en amont. La prochaine version de Power BI Desktop intègrera des mises à jour qui permettront de les résoudre.The Power BI team is actively working on mitigating these issues before they reach you, and the next Power BI Desktop will incorporate updates to address these problems. En attendant, vous pouvez effectuer une ou plusieurs des étapes suivantes pour atténuer les problèmes :Until then, you can take one or more of the following steps to mitigate the issues:

  1. Supprimez le visuel personnalisé, puis réinstallez-le.Remove the custom visual, then install it again. Cela lance une nouvelle installation des packages R.This initiates a re-installation of the R packages.
  2. Si votre installation de R n’est pas à jour, mettez-la à niveau, puis supprimez/réinstallez le visuel personnalisé comme décrit à l’étape précédente.If your installation of R is not current, upgrade your R installation, then remove/re-install the custom visual as described in the previous step.

    • Les versions prises en charge de R sont répertoriées dans la description de chaque visuel personnalisé optimisé pour R, comme illustré dans l’image suivante.Supported R versions are listed in the description of each R-powered custom visual, as shown in the following image. > [!NOTE] > Vous pouvez conserver l’installation R d’origine et associer uniquement Power BI Desktop avec la version actuelle que vous installez.You can keep the original R installation, and only associate Power BI Desktop with the current version you install. Accédez à Fichier -> Options et paramètres -> Options > Script R.Go to File > Options and settings > Options > R scripting.
  3. Installez les packages R manuellement à l’aide d’une console R.Install R packages manually, using any R console. Les étapes de cette approche sont les suivantes :The steps for this approach are the following:

    a.a. Téléchargez le script d’installation des visuels optimisés pour R et enregistrez ce fichier sur un lecteur local.Download the R-powered visual installation script, and save that file to a local drive.

    b.b. Dans la console R, exécutez la commande suivante :From the R console, run the following:

    > source(“C:/Users/david/Downloads/ScriptInstallPackagesForForecastWithWorkarounds.R”)    
    

    Les emplacements d’installation par défaut sont les suivants :Typical default installation locations are the following:

    c:\Program Files\R\R-3.3.x\bin\x64\Rterm.exe (for CRAN-R)
    c:\Program Files\R\R-3.3.x\bin\x64\Rgui.exe (for CRAN-R)
    c:\Program Files\R\R-3.3.x\bin\R.exe (for CRAN-R)
    c:\Program Files\Microsoft\MRO-3.3.x\bin\R.exe (for MRO)
    c:\Program Files\Microsoft\MRO-3.3.x\bin\x64\Rgui.exe (for MRO)
    c:\Program Files\RStudio\bin\rstudio.exe (for RStudio)
    
  4. Si les étapes précédentes ne fonctionnent pas, essayez ce qui suit :If the previous steps don't work, try the following:

    a.a. Utilisez R Studio et suivez les étapes décrites dans la section 3.b.Use R Studio and follow the step outlined in 3.b. ci-dessus (exécuter la ligne de script à partir de la console R).above (run the script line from the R console).

    b.b. Si l’étape précédente ne fonctionne pas, modifiez Outils > Options globales > Packages dans R Studio, activez la case à cocher Utiliser la bibliothèque/le proxy Internet Explorer pour HTTP, puis répétez l’étape 3.b.If the previous step doesn't work, change Tools > Global Options > Packages in R Studio, and enable the checkbox for Use Internet Explorer library/proxy for HTTP, then repeat step 3.b. décrite ci-dessus.from the above steps.

Étapes suivantesNext steps

Consultez les informations supplémentaires suivantes sur R dans Power BI.Take a look at the following additional information about R in Power BI.