Usar elementos visuais personalizados baseados em R no Power BIUse R-powered custom visuals in Power BI

No Power BI Desktop e no serviço do Power BI, você pode usar visuais personalizados baseados em R sem nenhum conhecimento do R e sem nenhum script do 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. Isso permite que você aproveite o poder analítico e visual de elementos visuais e dos scripts do R, sem a necessidade de aprender ou fazer programação em R.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 visuais personalizados baseados em R, primeiro, selecione e baixe o elemento visual personalizado R em que está interessado na galeria AppSource de visuais personalizados do 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.

As seções a seguir descrevem como selecionar, carregar e usar elementos visuais baseados em R no Power BI Desktop.The following sections describe how to select, load, and use R-powered visuals in Power BI Desktop.

Uso visuais personalizados do RUse R custom visuals

Para usar elementos visuais personalizados baseados em R, você precisa baixar cada elemento visual da biblioteca de elementos visuais personalizados, depois, usar o elemento visual como qualquer outro tipo de elemento visual no 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. Há duas maneiras de obter visuais personalizados – você pode baixá-los do site AppSource online ou procurar e obtê-los no 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.

Obter visuais personalizados do AppSourceGet custom visuals from AppSource

Aqui estão as etapas para procurar e selecionar visuais no site AppSource online:Here are the steps to browse and select visuals from the online AppSource site:

  1. Navegue até a biblioteca dos visuais do Power BI, encontrada em https://appsource.microsoft.com. Selecione a caixa de seleção de aplicativos do Power BI em Refinar por produto e, em seguida, selecione o link Ver todos.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. Selecione visuais do Power BI da lista de Suplementos no painel esquerdo.Select Power BI visuals from the list of Add-ins in the left pane.

  1. Selecione o visual que desejar usar da galeria e você será levado para uma página que descreve o visual.Select the visual you're interested in using from the gallery, and you're taken to a page that describes the visual. Selecione o botão Obtê-lo agora para baixar.Select the Get it now button to download.

    Observação

    Para criar no Power BI Desktop, você precisa ter o R instalado no computador local.For authoring in Power BI Desktop, you need to have R installed on your local machine. Mas quando os usuários desejarem exibir um elemento visual baseado em R no serviço do Power BI eles não precisam ter o R instalado localmente.But when users want to view an R-powered visual in the Power BI service they do not need R installed locally.

    Você não precisa instalar o R para usar elementos visuais personalizados baseados em R no serviço do Power BI, no entanto, se você quiser usar elementos visuais personalizados baseados em R no Power BI Desktop, instale o R no computador 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. Você pode baixar o R nos seguintes locais:You can download R from the following locations:

  2. Depois que visual é baixado (que é como baixar de qualquer arquivo do seu navegador), vá para Power BI Desktop e clique com o botão direito do mouse nas reticências (...) no painel de Visualizações e selecione Importar do arquivo.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. Você sabe como importar um elemento visual personalizado, conforme mostrado na imagem a seguir:You're cautioned about importing a custom visuals, as shown in the following image:

  4. Navegue para onde o arquivo do elemento visual foi salvo, depois, selecione o arquivo.Navigate to where the visual file was saved, then select the file. Visualizações personalizadas do Power BI Desktop têm a extensão .pbiviz.Power BI Desktop custom visualizations have the .pbiviz extension.

  5. Quando você retorna ao Power BI Desktop, é possível ver o novo tipo de elemento visual no painel de Visualizações.When you return to Power BI Desktop, you can see the new visual type in the Visualizations pane.

  6. Quando você importar o novo visual (ou abrir um relatório que contém um elemento visual personalizado baseado em R), o Power BI Desktop instala os pacotes do R necessários.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.

A partir daí, você pode adicionar dados para o elemento visual assim como faria com qualquer outro elemento visual do Power BI Desktop.From there, you can add data to the visual just as you would any other Power BI Desktop visual. Ao concluir, é possível ver seu elemento visual concluído na tela.When complete, you can see your finished visual on the canvas. No elemento visual a seguir, o elemento visual baseado em R de Previsão foi usado com projeções de taxa de nascimento das Nações Unidas (NU) (elemento visual à esquerda).In the following visual, the Forecasting R-powered visual was used with United Nations (UN) birth rate projections (the visual on the left).

Como qualquer outro elemento visual do Power BI Desktop, você pode publicar esse relatório com seus elementos visuais baseados em R no serviço do Power BI e compartilhá-lo com outras pessoas.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.

Verifique a biblioteca com frequência, pois novos visuais estão sendo adicionados o tempo todo.Check the library often, since new visuals are being added all the time.

Importar visuais personalizados do Power BI DesktopGet custom visuals from within Power BI Desktop

Você também pode importar visuais personalizados do Power BI Desktop.You can also get custom visuals from within Power BI Desktop. No Power BI Desktop, clique com o botão direito do mouse na reticências (...) no painel Visualizações e selecione Importar do repositório.In Power BI Desktop right-click the ellipsis (the ...) in the Visualizations pane, and select Import from store.

Quando você faz isso, a caixa de diálogo Visuais Personalizados do Power BI é exibida, na qual você pode percorrer os visuais personalizados disponíveis e selecionar o que você deseja.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. Você pode pesquisar por nome, selecione uma categoria ou apenas percorrer os visuais disponíveis.You can search by name, select a catagory, or just scroll through the available visuals. Quando você estiver pronto, basta selecionar Adicionar para adicionar o visual personalizado para Power BI Desktop.When you're ready, just select Add to add the custom visual to Power BI Desktop.

Contribuição de visuais personalizados baseados em RContribute R-powered custom visuals

Se você criar elementos visuais do R para uso em seus relatórios, poderá compartilhar esses elementos visuais com o mundo colocando o seu elemento visual personalizado na galeria de elementos visuais 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. Contribuições são feitas por meio do GitHub e o processo é descrito nas seguintes localizações:Contributions are made through GitHub, and the process is outlined in the following location:

Solução de problemas de visuais personalizados baseados em RTroubleshoot R-powered custom visuals

Os elementos visuais personalizados baseados em R têm determinadas dependências que devem ser atendidas para que os elementos visuais funcionem corretamente.R-powered custom visuals have certain dependencies that must be met for the visuals to work properly. Quando os elementos visuais personalizados baseados em R não executam ou não carregam corretamente, o problema é geralmente um dos seguintes:When R-powered custom visuals don't run or load properly, the problem is usually one of the following:

  • O mecanismo de R está ausenteThe R engine is missing
  • Erros no script de R no qual o elemento visual se baseiaErrors in the R script on which the visual is based
  • Os pacotes de R estão ausentes ou desatualizadosR packages are missing or out of date

A seção a seguir descreve as etapas de solução de problemas que podem ser seguidas para ajudar a resolver os problemas que você encontrar.The following section describes troubleshooting steps you can take to help address trouble you run into.

Pacotes de R ausentes ou desatualizadosMissing or outdated R packages

Ao tentar instalar um elemento visual personalizado baseado em R, você pode encontrar erros quando houver pacotes de R ausentes ou desatualizados; isso costuma ocorrer devido a um dos seguintes 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:

  • A instalação do R é incompatível com o pacote do R,The R installation is incompatible with the R package,
  • Configurações de proxy, software antivírus ou um firewall estão impedindo o R de conectar-se com a InternetA firewall, anti-virus software, or proxy settings are preventing R from connecting to the Internet
  • A conexão com a Internet está lenta ou há um problema de conexão com a InternetThe Internet connection is slow, or there's an Internet connection problem

A equipe do Power BI está trabalhando ativamente para atenuar esses problemas antes que eles cheguem a você e o próximo Power BI Desktop incorporará atualizações para resolver esses problemas.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. Até lá, você pode executar uma ou mais das etapas a seguir para atenuar os problemas:Until then, you can take one or more of the following steps to mitigate the issues:

  1. Remova o elemento visual personalizado e instale-o novamente.Remove the custom visual, then install it again. Isso iniciará uma reinstalação dos pacotes de R.This initiates a re-installation of the R packages.
  2. Se sua instalação do R não estiver atualizada, atualize sua instalação do R e, em seguida, remova/reinstale o elemento visual personalizado conforme descrito na etapa 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.

    • As versões de R com suporte estão listadas na descrição de cada elemento visual personalizado baseado em R, conforme mostrado na imagem a seguir.Supported R versions are listed in the description of each R-powered custom visual, as shown in the following image. > [!NOTE] > Mantenha a instalação original do R e associe apenas o Power BI Desktop com a versão atual que instalar.You can keep the original R installation, and only associate Power BI Desktop with the current version you install. Vá para Arquivo > Opções e configurações > Opções > Script de R.Go to File > Options and settings > Options > R scripting.
  3. Instale os pacotes de R manualmente, usando qualquer console do R.Install R packages manually, using any R console. As etapas desta abordagem são as seguintes:The steps for this approach are the following:

    a.a. Baixe o script de instalação do elemento visual baseado em R e salve esse arquivo em uma unidade local.Download the R-powered visual installation script, and save that file to a local drive.

    b.b. No console do R, execute o seguinte:From the R console, run the following:

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

    Os locais típicos de instalação padrão são os seguintes: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. Se as etapas anteriores não funcionarem, tente o seguinte:If the previous steps don't work, try the following:

    a.a. Use o R Studio e siga a etapa descrita acima em 3.b.Use R Studio and follow the step outlined in 3.b. (executar a linha de script do console do R).above (run the script line from the R console).

    b.b. Se a etapa anterior não funcionar, altere Ferramentas > Opções globais > Pacotes no R Studio e habilite a caixa de seleção Usar a biblioteca/proxy do Internet Explorer para HTTP e, em seguida, repita a etapa 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. das etapas acima.from the above steps.

Próximas etapasNext steps

Analise as informações adicionais a seguir sobre o R no Power BI.Take a look at the following additional information about R in Power BI.