Verwenden von R-gestützten, benutzerdefinierten Visualisierungen in Power BIUse R-powered custom visuals in Power BI

In Power BI Desktop und im Power BI-Dienst können Sie R-gestützte benutzerdefinierte Visuals erstellen, ganz ohne Kenntnisse in R und ohne Skripts in R zu verfassen.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. Dadurch können Sie die analytischen Möglichkeiten von R-Visualisierungen und R-Skripten nutzen, ohne R erlernen oder in R programmieren zu müssen.This enables you to harness the analytic and visual power of R visuals, and R scripts, without learning R or doing any programming yourself.

Um R-gestützte benutzerdefinierte Visuals zu verwenden, wählen Sie das gewünschte benutzerdefinierte R-Visual im AppSource-Katalog der benutzerdefinierten Visuals für Power BI aus, und laden Sie es herunter.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.

In den folgenden Abschnitten wird beschrieben, wie Sie R-gestützte Visualisierungen in Power BI Desktop auswählen, laden und verwenden können.The following sections describe how to select, load, and use R-powered visuals in Power BI Desktop.

Verwenden benutzerdefinierter R-VisualsUse R custom visuals

Um R-gestützte, benutzerdefinierte Visualisierungen zu verwenden, müssen die einzelnen Visualisierungen aus der Bibliothek Custom visuals (Benutzerdefinierte visuelle Elemente) heruntergeladen werden. Dann können Sie die Visualisierung wie jede andere in Power BI Desktop verwenden.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. Es gibt zwei Möglichkeiten, benutzerdefinierte Visuals zu erhalten: Sie können sie von der AppSource-Website herunterladen, oder Sie können sie in Power BI Desktop suchen und importieren.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.

Herunterladen benutzerdefinierter Visuals aus AppSourceGet custom visuals from AppSource

Führen Sie die folgenden Schritte aus, um benutzerdefinierte Visuals auf der AppSource-Website zu suchen und auszuwählen:Here are the steps to browse and select visuals from the online AppSource site:

  1. Navigieren Sie in https://appsource.microsoft.com zum Power BI-Visualkatalog. Aktivieren Sie unter Suche einschränken (Produkt) das Kontrollkästchen Power BI-Apps, und wählen Sie dann den Link Alle anzeigen aus.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. Wählen Sie in der Liste der Add-Ins im linken Bereich Power BI-Visuals aus.Select Power BI visuals from the list of Add-ins in the left pane.

  1. Wählen Sie im Katalog das Visual aus, das Sie verwenden möchten. Anschließend wird eine Seite mit einer Beschreibung des Visuals geöffnet.Select the visual you're interested in using from the gallery, and you're taken to a page that describes the visual. Klicken Sie auf die Schaltfläche Jetzt holen, um das Visual herunterzuladen.Select the Get it now button to download.

    Hinweis

    Für die Erstellung in Power BI Desktop muss R auf Ihrem lokalen Rechner installiert sein.For authoring in Power BI Desktop, you need to have R installed on your local machine. Wenn ein Benutzer eine R-gestützte Visualisierung im Power BI-Dienst betrachten möchte, ist allerdings keine lokale Installation von R erforderlich.But when users want to view an R-powered visual in the Power BI service they do not need R installed locally.

    Um R-gestützte, benutzerdefinierte Visualisierungen im Power BI-Dienst zu verwenden, brauchen Sie R nicht zu installieren. Wenn Sie R-gestützte, benutzerdefinierte Visualisierungen hingegen in Power BI Desktop verwenden möchten, müssen Sie R auf dem lokalen Computer installieren.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. Hier können Sie R herunterladen:You can download R from the following locations:

  2. Sobald das Visual (wie jede andere Datei über den Browser) heruntergeladen wurde, wechseln Sie zu Power BI Desktop, klicken Sie im Bereich Visualisierungen mit der rechten Maustaste auf die Auslassungspunkte (...), und wählen Sie Aus Datei importieren aus.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. Sie erhalten eine Warnmeldung zum Importieren benutzerdefinierter Visualisierungen hingewiesen wie in der folgenden Abbildung:You're cautioned about importing a custom visuals, as shown in the following image:

  4. Navigieren Sie zum Speicherort der Visualisierungsdatei, und wählen Sie diese aus.Navigate to where the visual file was saved, then select the file. In Power BI Desktop verfügen benutzerdefinierte Visualisierungen über die Dateierweiterung „.pbiviz“.Power BI Desktop custom visualizations have the .pbiviz extension.

  5. Wenn Sie zu Power BI Desktop zurückkehren, sehen Sie den neuen Visualtyp im Bereich Visualisierungen.When you return to Power BI Desktop, you can see the new visual type in the Visualizations pane.

  6. Wenn Sie die neue Visualisierung importieren (oder einen Bericht mit einer R-gestützten, benutzerdefinierten Visualisierung öffnen), werden die erforderlichen R-Pakete von Power BI Desktop automatisch installiert.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.

Danach können Sie dieser wie jeder anderen Visualisierung in Power BI Desktop Daten hinzufügen.From there, you can add data to the visual just as you would any other Power BI Desktop visual. Nach Abschluss des Vorgangs sehen Sie die fertige Visualisierung auf der Zeichenfläche.When complete, you can see your finished visual on the canvas. In der folgenden Visualisierung wurde die R-gestützte Visualisierung Forecasting mit Daten aus den UN-Prognosen zur Geburtenrate (linke Visualisierung) verwendet.In the following visual, the Forecasting R-powered visual was used with United Nations (UN) birth rate projections (the visual on the left).

Wie jede andere Visualisierung in Power BI Desktop können Sie diesen R-gestützten visualisierten Bericht im Power BI-Dienst veröffentlichen und für andere freigeben.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.

Es lohnt sich, die Bibliothek häufiger zu besuchen, da regelmäßig neue Visuals hinzugefügt werden.Check the library often, since new visuals are being added all the time.

Importieren benutzerdefinierter Visuals in Power BI Desktop Get custom visuals from within Power BI Desktop

Sie können benutzerdefinierte Visuals auch in Power BI Desktop importieren.You can also get custom visuals from within Power BI Desktop. Klicken Sie in Power BI Desktop mit der rechten Maustaste auf die Auslassungspunkte (...) im Bereich Visualisierungen, und wählen Sie Aus Store importieren aus.In Power BI Desktop right-click the ellipsis (the ...) in the Visualizations pane, and select Import from store.

Anschließend wird das Dialogfeld Benutzerdefinierte Power BI-Visuals angezeigt, in dem Sie durch die verfügbaren benutzerdefinierten Visuals scrollen und das gewünschte Visual auswählen können.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. Sie können anhand des Namens suchen, eine Kategorie auswählen oder einfach durch die verfügbaren Visuals scrollen.You can search by name, select a catagory, or just scroll through the available visuals. Wenn Sie Ihre Auswahl getroffen haben, wählen Sie einfach Hinzufügen aus, um das benutzerdefinierte Visual zu Power BI Desktop hinzuzufügen.When you're ready, just select Add to add the custom visual to Power BI Desktop.

Beisteuern R-gestützter benutzerdefinierter VisualsContribute R-powered custom visuals

Wenn Sie für Ihre Berichte eigene R-Visualisierungen erstellen, können Sie diese für Benutzer auf der ganzen Welt über den Katalog mit benutzerdefinierten Visualisierungen freigeben.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. Beiträge werden über GitHub eingereicht. Dieser Vorgang wird hier beschrieben:Contributions are made through GitHub, and the process is outlined in the following location:

Problembehandlung für R-gestützte benutzerdefinierte VisualsTroubleshoot R-powered custom visuals

R-gestützte benutzerdefinierte Visualisierungen weisen bestimmte Abhängigkeiten auf, die berücksichtigt werden müssen, damit die Visualisierungen ordnungsgemäß ausgeführt werden.R-powered custom visuals have certain dependencies that must be met for the visuals to work properly. Wenn R-gestützte benutzerdefinierte Visualisierungen nicht ordnungsgemäß ausgeführt oder geladen werden, hat das Problem in der Regel eine der folgenden Ursachen:When R-powered custom visuals don't run or load properly, the problem is usually one of the following:

  • Das R-Modul fehlt.The R engine is missing
  • Fehler im R-Skript, auf dem die Visualisierung basiert.Errors in the R script on which the visual is based
  • R-Pakete fehlen oder sind veraltet.R packages are missing or out of date

Im folgenden Abschnitt werden die Schritte beschrieben, mit denen Sie ggf. auftretende Probleme beheben können.The following section describes troubleshooting steps you can take to help address trouble you run into.

Fehlende oder veraltete R-PaketeMissing or outdated R packages

Beim Installieren einer R-gestützten benutzerdefinierten Visualisierung können Fehler auftreten, wenn R-Pakete fehlen oder veraltet sind. Dies hat i. d. R. eine der folgenden Ursachen: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:

  • Die R-Installation ist mit dem R-Paket nicht kompatibel.The R installation is incompatible with the R package,
  • Eine Firewall, Antivirensoftware oder Proxyeinstellungen verhindern die Verbindung von R mit dem Internet.A firewall, anti-virus software, or proxy settings are preventing R from connecting to the Internet
  • Die Internetverbindung ist langsam, oder es besteht ein Problem bei der Internetverbindung.The Internet connection is slow, or there's an Internet connection problem

Das Power BI-Team arbeitet daran, diese Probleme zu beheben, bevor sie bei Ihnen auftreten, und die nächste Version von Power BI Desktop enthält Updates zum Beheben dieser Probleme.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. Bis dahin können Sie einen oder mehrere der folgenden Schritte ausführen, um die Probleme zu entschärfen:Until then, you can take one or more of the following steps to mitigate the issues:

  1. Entfernen Sie die benutzerdefinierte Visualisierung, und installieren Sie sie dann erneut.Remove the custom visual, then install it again. Hierdurch wird eine erneute Installation der R-Pakete initiiert.This initiates a re-installation of the R packages.
  2. Wenn die Installation von R nicht aktuell ist, führen Sie ein Upgrade der R-Installation durch. Entfernen Sie dann die benutzerdefinierte Visualisierung, und installieren Sie sie erneut, wie im vorherigen Schritt beschrieben.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.

    • In der Beschreibung jeder R-gestützten benutzerdefinierten Visualisierung werden die unterstützten R-Versionen aufgeführt, wie in der folgenden Abbildung dargestellt.Supported R versions are listed in the description of each R-powered custom visual, as shown in the following image. > [!NOTE] > Sie können die ursprüngliche R-Installation beibehalten und Power BI Desktop lediglich der aktuellen Version zuordnen, die Sie installieren.You can keep the original R installation, and only associate Power BI Desktop with the current version you install. Wählen Sie „Datei“ > „Optionen und Einstellungen“ -> „Optionen“ > „R-Skripterstellung“ aus.Go to File > Options and settings > Options > R scripting.
  3. Installieren Sie R-Pakete mit einer beliebigen R-Konsole manuell.Install R packages manually, using any R console. Die Schritte dieser Vorgehensweise lauten wie folgt:The steps for this approach are the following:

    a.a. Laden Sie das Installationsskript für die R-gestützte Visualisierung herunter, und speichern Sie die Datei auf einem lokalen Laufwerk.Download the R-powered visual installation script, and save that file to a local drive.

    b.b. Führen Sie in der R-Konsole den folgenden Befehl aus:From the R console, run the following:

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

    Typische Standardinstallationspfade lauten wie folgt: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. Wenn das Problem durch die vorherigen Schritte nicht behoben wird, versuchen Sie Folgendes:If the previous steps don't work, try the following:

    a.a. Verwenden Sie R Studio, und führen Sie den oben in 3.b.Use R Studio and follow the step outlined in 3.b. beschriebenen Schritt aus (die Skriptzeile in der R-Konsole ausführen).above (run the script line from the R console).

    b.b. Wenn das Problem durch den vorherigen Schritt nicht behoben wird, wählen Sie in R Studio die Option Tools > Global Options > Packages (Extras > Globale Optionen > Pakete) aus, aktivieren Sie das Kontrollkästchen Use Internet Explorer library/proxy for HTTP (Internet Explorer-Bibliothek/-Proxy für HTTP verwenden), und wiederholen Sie dann Schritt 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. aus den oben genannten Schritten.from the above steps.

Nächste SchritteNext steps

Betrachten Sie die folgenden zusätzlichen Informationen über R in Power BI.Take a look at the following additional information about R in Power BI.