Usar objetos visuales personalizados con tecnología R en Power BIUse R-powered custom visuals in Power BI

En Power BI Desktop y el servicio Power BI, puede usar objetos visuales personalizados con tecnología R sin tener que aprender a usar R ni crear scripts.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. Esto le permite aprovechar el poder analítico y visual de objetos visuales y scripts de R sin que tenga que aprender a usar R ni a programarlo.This enables you to harness the analytic and visual power of R visuals, and R scripts, without learning R or doing any programming yourself.

Para usar elementos visuales personalizados con tecnología de R, primero seleccione y descargue los objetos visuales personalizados de R que quiere usar desde la galería de AppSource de objetos visuales personalizados para 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.

Las secciones siguientes describen cómo seleccionar, cargar y usar elementos visuales con tecnología de R en Power BI Desktop.The following sections describe how to select, load, and use R-powered visuals in Power BI Desktop.

Uso de objetos visuales personalizadosUse R custom visuals

Para usar objetos visuales personalizados con tecnología de R, necesita descargar cada objeto visual de la biblioteca de objetos visuales personalizados y, después, puede usar el objeto visual como cualquier otro tipo de objeto visual en 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. Hay dos maneras de obtener objetos visuales personalizados: puede descargarlos desde el sitio de AppSource en línea o puede buscarlos en 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.

Obtener objetos visuales personalizados desde AppSourceGet custom visuals from AppSource

Estos son los pasos para buscar y seleccionar objetos visuales en el sitio de AppSource en línea:Here are the steps to browse and select visuals from the online AppSource site:

  1. Vaya a la biblioteca Power BI visuals (objetos visuales de Power BI), que se encuentra en https://appsource.microsoft.com. Seleccione la casilla Power BI apps (Aplicaciones de Power BI) en Restringir por producto y, a continuación, seleccione el vínculo Ver todo.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. Seleccione Power BI visuals (objetos visuales de Power BI) en la lista de complementos en el panel izquierdo.Select Power BI visuals from the list of Add-ins in the left pane.

  1. En la galería, seleccione el objeto visual que desea usar y se abrirá la página con la descripción del objeto visual.Select the visual you're interested in using from the gallery, and you're taken to a page that describes the visual. Seleccione el botón Obtenerla ahora para descargarlo.Select the Get it now button to download.

    Nota

    Para crear Power BI Desktop, necesita tener R instalado en su equipo local.For authoring in Power BI Desktop, you need to have R installed on your local machine. Pero cuando los usuarios quieren ver un objeto visual con tecnología R en el servicio Power BI no necesitan tener instalado R localmente.But when users want to view an R-powered visual in the Power BI service they do not need R installed locally.

    No es necesario que instale R para usar objetos visuales personalizados con tecnología R en el servicio Power BI. Sin embargo, si quiere usar objetos visuales personalizados con tecnología R en Power BI Desktop, debe instalar R en la máquina 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. Puede descargar R en las siguientes ubicaciones:You can download R from the following locations:

  2. Una vez descargado el objeto visual (que es como descargar un archivo desde el explorador), vaya a Power BI Desktop, haga clic con el botón derecho en los puntos suspensivos (...) en el panel Visualizaciones y seleccione Importar desde archivo.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. Se le advierte de la importación de objetos visuales personalizados, como se muestra en la siguiente imagen:You're cautioned about importing a custom visuals, as shown in the following image:

  4. Vaya al lugar en que guardó el archivo de objetos visuales y, después, seleccione el archivo.Navigate to where the visual file was saved, then select the file. Las visualizaciones personalizadas de Power BI Desktop tienen la extensión .pbiviz.Power BI Desktop custom visualizations have the .pbiviz extension.

  5. Cuando vuelva a Power BI Desktop, podrá ver el nuevo tipo de objeto visual en el panel Visualizaciones.When you return to Power BI Desktop, you can see the new visual type in the Visualizations pane.

  6. Cuando se importa un nuevo objeto visual o se abre un informe que contiene un objeto visual personalizado con tecnología R, Power BI Desktop instala los paquetes de R necesarios.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.

En ese momento puede agregar datos al objeto visual igual que haría con cualquier otro objeto visual de Power BI Desktop.From there, you can add data to the visual just as you would any other Power BI Desktop visual. Cuando haya finalizado, podrá ver el objeto visual terminado en el lienzo.When complete, you can see your finished visual on the canvas. En el siguiente objeto visual, el objeto visual con tecnología de R Previsión se usó con proyecciones de la tasa de natalidad de las Naciones Unidas (ONU) (objeto visual de la izquierda).In the following visual, the Forecasting R-powered visual was used with United Nations (UN) birth rate projections (the visual on the left).

Como cualquier otro objeto visual de Power BI Desktop, puede publicar este informe con sus objetos visuales con tecnología R en el servicio Power BI y compartirlo con otros usuarios.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.

Consulte la biblioteca con frecuencia, ya que se agregan nuevos objetos visuales constantemente.Check the library often, since new visuals are being added all the time.

Obtenga objetos visuales personalizados desde Power BI DesktopGet custom visuals from within Power BI Desktop

También puede obtener objetos visuales personalizados desde Power BI Desktop.You can also get custom visuals from within Power BI Desktop. En Power BI Desktop haga clic con el botón derecho en el botón de puntos suspensivos (...), en el panel Visualizaciones, y seleccione Importar del almacén.In Power BI Desktop right-click the ellipsis (the ...) in the Visualizations pane, and select Import from store.

Al hacerlo, aparece el cuadro de diálogo Objetos visuales personalizados de Power BI, donde puede ver los objetos visuales personalizados disponibles y seleccionar el que desee.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. Puede buscar por nombre, seleccionar una categoría o, simplemente, desplazarse por los objetos visuales disponibles.You can search by name, select a catagory, or just scroll through the available visuals. Cuando esté listo, seleccione Agregar para agregar el objeto visual personalizado a Power BI Desktop.When you're ready, just select Add to add the custom visual to Power BI Desktop.

Contribuir con objetos visuales personalizados con tecnología RContribute R-powered custom visuals

Si crea sus propios objetos visuales de R para usarlos en informes, puede compartilos con otros usuarios contribuyendo con estos en la galería de objetos visuales personalizados.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. Las contribuciones se realizan a través de GitHub y el proceso se describe en la siguiente ubicación:Contributions are made through GitHub, and the process is outlined in the following location:

Solución de problemas de objetos visuales personalizados con tecnología RTroubleshoot R-powered custom visuals

Los objetos visuales personalizados con tecnología R tienen ciertas dependencias que deben cumplirse para que los objetos visuales funcionen correctamente.R-powered custom visuals have certain dependencies that must be met for the visuals to work properly. Cuando los objetos visuales personalizados con tecnología R no se ejecutan o se cargan correctamente, suele deberse a uno de los siguientes problemas:When R-powered custom visuals don't run or load properly, the problem is usually one of the following:

  • Falta el motor de R.The R engine is missing
  • Hay errores en el script de R en el que se basa el objeto visual.Errors in the R script on which the visual is based
  • Faltan paquetes de R o no están actualizados.R packages are missing or out of date

En la sección siguiente se describen los pasos que puede llevar a cabo para solucionar los problemas que surjan.The following section describes troubleshooting steps you can take to help address trouble you run into.

Faltan paquetes de R o no están actualizadosMissing or outdated R packages

Al intentar instalar un objeto visual personalizado con tecnología R, pueden producirse errores si faltan paquetes de R o están obsoletos. Esto suele deberse a uno de los siguientes motivos: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:

  • La instalación de R es incompatible con el paquete de R.The R installation is incompatible with the R package,
  • La configuración de un firewall, software antivirus o proxy impide que R se conecte a Internet.A firewall, anti-virus software, or proxy settings are preventing R from connecting to the Internet
  • La conexión a Internet es lenta o hay un problema de conexión a Internet.The Internet connection is slow, or there's an Internet connection problem

El equipo de Power BI está trabajando activamente para mitigar estos problemas de modo que no le afecten, y en la siguiente versión de Power BI Desktop se incorporarán actualizaciones para resolverlos.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. Hasta entonces, puede llevar a cabo uno o varios de los pasos siguientes para mitigar los problemas:Until then, you can take one or more of the following steps to mitigate the issues:

  1. Quite el objeto visual personalizado e instálelo de nuevo.Remove the custom visual, then install it again. De este modo, se inicia una reinstalación de los paquetes de R.This initiates a re-installation of the R packages.
  2. Si la instalación de R no es actual, actualícela y, después, quite y reinstale el objeto visual personalizado como se describe en el paso anterior.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.

    • Las versiones de R admitidas se muestran en la descripción de cada objeto visual personalizado con tecnología R, como se muestra en la imagen siguiente.Supported R versions are listed in the description of each R-powered custom visual, as shown in the following image. > [!NOTE] > Puede conservar la instalación de R original y asociar únicamente Power BI Desktop con la versión actual que instale.You can keep the original R installation, and only associate Power BI Desktop with the current version you install. Vaya a Archivo > Opciones y configuración > Opciones > Scripting de R.Go to File > Options and settings > Options > R scripting.
  3. Instale los paquetes de R manualmente mediante cualquier consola de R.Install R packages manually, using any R console. Los pasos de este enfoque son los siguientes:The steps for this approach are the following:

    a.a. Descargue el script de instalación de objeto visual con tecnología R y guarde el archivo en una unidad local.Download the R-powered visual installation script, and save that file to a local drive.

    b.b. Desde la consola de R, ejecute lo siguiente:From the R console, run the following:

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

    Las típicas ubicaciones de instalación predeterminadas son las siguientes: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 los pasos anteriores no funcionan, pruebe lo siguiente:If the previous steps don't work, try the following:

    a.a. Use R Studio y siga el paso que se describe en el punto 3.b.Use R Studio and follow the step outlined in 3.b. anterior (ejecute la línea de script desde la consola de R).above (run the script line from the R console).

    b.b. Si el paso anterior no funciona, cambie Herramientas > Opciones globales > Paquetes en R Studio y active la casilla Use Internet Explorer library/proxy for HTTP (Usar la biblioteca/proxy de Internet Explorer para HTTP). Después, repita el proceso el paso 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. anterior.from the above steps.

Pasos siguientesNext steps

Eche un vistazo a la siguiente información adicional sobre R en Power BI.Take a look at the following additional information about R in Power BI.