Utiliser un IDE R externe avec Power BIUse an external R IDE with Power BI

Avec Power BI Desktop, vous pouvez utiliser un IDE (environnement de développement intégré) R externe pour créer et affiner les scripts R, puis utiliser ces scripts dans Power BI.With Power BI Desktop, you can use your external R IDE (Integrated Development Environment) to create and refine R scripts, then use those scripts in Power BI.

Activer un IDE R externeEnable an external R IDE

Auparavant, vous deviez utiliser l’éditeur de script R dans Power BI Desktop pour créer et exécuter des scripts R.Previously, you had to use the R script editor in Power BI Desktop to create and run R scripts. Avec cette version, vous pouvez lancer votre IDE R externe à partir de Power BI Desktop et importer et afficher vos données automatiquement dans l’IDE R.With this release, you can launch your external R IDE from Power BI Desktop and have your data automatically imported and displayed in the R IDE. À partir de là, vous pouvez modifier le script dans cet IDE R externe, puis le coller dans Power BI Desktop pour créer des rapports et des éléments visuels Power BI.From there, you can modify the script in that external R IDE, then paste it back into Power BI Desktop to create Power BI visuals and reports.

À partir de la version de septembre 2016 de Power BI Desktop (version 2.39.4526.362), vous pouvez spécifier l’IDE R que vous souhaitez utiliser et le lancer automatiquement à partir de Power BI Desktop.Beginning with the September 2016 release of Power BI Desktop (version 2.39.4526.362), you can specify which R IDE you would like to use, and have it launch automatically from within Power BI Desktop.

Configuration requiseRequirements

Pour utiliser cette fonctionnalité, vous devez installer un IDE R sur votre ordinateur local.To use this feature, you need to install an R IDE on your local computer. Power BI Desktop n’inclut pas, ne déploie pas ni n’installe le moteur R. Vous devez donc installer R séparément sur votre ordinateur local.Power BI Desktop does not include, deploy or install the R engine, so you must separately install R on your local computer. Vous pouvez choisir l’IDE R à utiliser avec les options suivantes :You can choose which R IDE to use, with the following options:

  • Vous pouvez installer votre IDE R favori (nombre des IDE R étant disponibles gratuitement), tel que Revolution Open et CRAN Repository.You can install your favorite R IDE, many of which are available for free, such as the Revolution Open download page, and the CRAN Repository.
  • Power BI Desktop prend également en charge R Studio et Visual Studio 2015 avec les éditeurs Outils R pour Visual Studio.Power BI Desktop also supports R Studio and Visual Studio 2015 with R Tools for Visual Studio editors.
  • Vous pouvez également installer un autre IDE R et configurer Power BI Desktop pour lancer cet IDE R en effectuant l’une des opérations suivantes :You can also install a different R IDE and have Power BI Desktop launch that R IDE by doing one of the following:

    • Vous pouvez associer des fichiers .R à l’IDE externe que vous souhaitez lancer à l’aide de Power BI Desktop.You can associate .R files with the external IDE you want Power BI Desktop to launch.
    • Vous pouvez spécifier l’exécutable que Power BI Desktop doit lancer en sélectionnant Autres à partir de la section Options de script R de la boîte de dialogue Options.You can specify the .exe that Power BI Desktop should launch by selecting Other from the R Script Options section of the Options dialog. Pour ouvrir la boîte de dialogue Options, accédez à Fichier > Options et paramètres > Options.You can bring up the Options dialog by going to File > Options and settings > Options.

Si vous avez plusieurs IDE R installés, vous pouvez spécifier lequel lancer en le sélectionnant à partir de la liste déroulante IDE R détectés dans la boîte de dialogue Options.If you have multiple R IDEs installed, you can specify which will be launched by selecting it from the Detected R IDEs drop-down in the Options dialog.

Par défaut, Power BI Desktop lance R Studio en tant qu’IDE R externe s’il est installé sur votre ordinateur local ; si R Studio n’est pas installé et que vous avez Visual Studio 2015 avec les Outils R pour Visual Studio, ces derniers seront lancés à la place.By default, Power BI Desktop will launch R Studio as the external R IDE if it's installed on your local computer; if R Studio is not installed and you have Visual Studio 2015 with R Tools for Visual Studio, that will be launched instead. Si aucun de ces IDE R n’est installé, l’application associée aux fichiers .R est lancée.If neither of those R IDEs is installed, the application associated with .R files is launched.

Si aucune association au fichier .R n’existe, il est possible de spécifier un chemin d’accès à un IDE personnalisé dans la section Accédez à votre IDE R préféré de la boîte de dialogue Options.And if no .R file association exists, it's possible to specify a path to a custom IDE in the Browse to your preferred R IDE section of the Options dialog. Vous pouvez également lancer un autre IDE R en sélectionnant l’icône en forme d’engrenage Paramètres en regard de l’icône représentant une flèche Lancer un IDE R, dans Power BI Desktop.You can also launch a different R IDE by selecting the Settings gear icon beside the Launch R IDE arrow icon, in Power BI Desktop.

Lancer un IDE R à partir de Power BI DesktopLaunch an R IDE from Power BI Desktop

Pour lancer un IDE R à partir de Power BI Desktop, procédez comme suit.To launch an R IDE from Power BI Desktop, take the following steps.

  1. Chargez des données dans Power BI Desktop.Load data into Power BI Desktop.
  2. Sélectionnez quelques champs que vous souhaitez utiliser dans le volet Champs.Select some fields from the Fields pane that you want to work with. Si vous n’avez pas encore activé les éléments visuels de script, vous êtes invité à le faire.If you haven't enabled script visuals yet, you'll be prompted to do so.

  3. Lorsque les éléments visuels de script sont activés, vous pouvez sélectionner un élément visuel R à partir du volet Visualisations, qui crée un élément visuel R vide qui est prêt à afficher les résultats de votre script.When script visuals are enabled, you can select an R visual from the Visualizations pane, which creates a blank R visual that's ready to display the results of your script. Le volet Éditeur de script R s’affiche également.The R script editor pane also appears.

  4. Vous pouvez maintenant sélectionner les champs que vous souhaitez utiliser dans votre script R.Now you can select the fields you want to use in your R script. Lorsque vous sélectionnez un champ, le champ Éditeur de script R crée automatiquement un code de script basé sur le ou les champs que vous sélectionnez.When you select a field, the R script editor field automatically creates script code based on the field or fields you select. Vous pouvez créer (ou coller) votre script R directement dans le volet Éditeur de script R ou vous pouvez le laisser vide.You can either create (or paste) your R script directly in the R script editor pane, your you can leave it empty.

    Note

    Le type d’agrégation par défaut pour les éléments visuels R est Ne pas résumer.The default aggregation type for R visuals is do not summarize.

  5. Vous pouvez maintenant lancer votre IDE R directement à partir de Power BI Desktop.You can now launch your R IDE directly from Power BI Desktop. Sélectionnez le bouton Lancer l’IDE R qui se trouve à droite de la barre de titre Éditeur de script R, comme indiqué ci-dessous.Select the Launch R IDE button, found on the right side of the R script editor title bar, as shown below.

  6. L’IDE R spécifié est lancé par Power BI Desktop, comme illustré dans l’image suivante où RStudio est l’IDE R par défaut.Your specified R IDE is launched by Power BI Desktop, as shown in the following image (in this image, RStudio is the default R IDE).

    Note

    Power BI Desktop ajoute les trois premières lignes du script afin qu’il puisse importer vos données à partir de Power BI Desktop une fois que vous exécutez le script.Power BI Desktop adds the first three lines of the script so it can import your data from Power BI Desktop once you run the script.

  7. Les scripts que vous avez créés dans le volet Éditeur de script R de Power BI Desktop apparaissent à partir de la ligne 4 de votre IDE R.Any script you created in the R script editor pane of Power BI Desktop appears starting in line 4 in your R IDE. À ce stade, vous pouvez créer votre script R dans l’IDE R.At this point you can create your R script in the R IDE. Une fois que votre script R est terminé dans votre IDE R, vous devez le copier et le coller dans le volet Éditeur de script R de Power BI Desktop, à l’exclusion des trois premières lignes du script générées automatiquement par Power BI Desktop.Once your R script is complete in your R IDE, you need to copy and paste it back into the R script editor pane in Power BI Desktop, excluding the first three lines of the script that Power BI Desktop automatically generated. Ne recopiez pas les trois premières lignes du script dans Power BI Desktop. Celles-ci ont été utilisées uniquement pour importer vos données dans votre IDE R à partir de Power BI Desktop.Do not copy the first three lines of script back into Power BI Desktop, those lines were only used to import your data to your R IDE from Power BI Desktop.

Limites connuesKnown limitations

Le lancement de l’IDE R directement à partir de Power BI Desktop présente quelques limitations :Launching an R IDE directly from Power BI Desktop has a few limitations:

  • L’exportation automatique de votre script de l’IDE R vers Power BI Desktop n’est pas prise en charge.Automatically exporting your script from your R IDE into Power BI Desktop is not supported.
  • L’éditeur R Client (RGui.exe) n’est pas pris en charge, car l’éditeur lui-même ne prend pas en charge l’ouverture de fichiers.R Client editor (RGui.exe) is not supported, because the editor itself does not support opening files.

É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.