Criar um aplicativo de modelo no Power BI
Este artigo contém instruções passo a passo para a criação de um aplicativo de modelo do Power BI. Os aplicativos de modelo do Power BI permitem que os parceiros do Power BI criem aplicativos com pouca ou nenhuma codificação e os implantem para qualquer cliente do Power BI.
Se você conseguir criar relatórios e dashboards do Power BI, poderá se tornar um construtor de aplicativo de modelo e criar e empacotar o conteúdo analítico em um aplicativo. Depois será possível implantar seu aplicativo em outros locatários do Power BI por meio de todas as plataformas disponíveis, como o AppSource ou um serviço Web próprio. Caso esteja distribuindo seu aplicativo de modelo por meio de um serviço Web próprio, você poderá automatizar parte do processo de instalação a fim de facilitá-lo para seus clientes.
Os administradores do Power BI controlam e administram quem, nas organizações, pode criar aplicativos de modelo e quem pode instalá-los. Os usuários autorizados podem instalar o aplicativo de modelo e modificá-lo e distribuí-lo para os consumidores do Power BI em suas organizações.
Pré-requisitos
Estes são os requisitos para a criação de um aplicativo de modelo:
- Uma licença do Power BI Pro
- Power BI Desktop (opcional)
- Familiaridade com os conceitos básicos do Power BI
- Permissões para compartilhar um aplicativo de modelo publicamente, conforme mostrado em Configurações de locatário do aplicativo de Modelo
Criar o workspace de modelo
Para criar um aplicativo de modelo que você pode distribuir para outros locatários do Power BI, você precisa criá-lo em um workspace.
No serviço do Power BI, crie um workspace conforme descrito em Criar um workspace no Power BI. Na seção Avançado, selecione Desenvolver um aplicativo de modelo.
Importante
A capacidade à qual o workspace do construtor de aplicativos é atribuído não determina a atribuição de capacidade de workspaces em que os instaladores de aplicativos instalam o aplicativo. Isso significa que um aplicativo desenvolvido em um workspace de capacidade premium não será necessariamente instalado em um workspace de capacidade premium. Portanto, não é recomendável usar a capacidade premium para o workspace do construtor, pois os workspaces do instalador podem não ser de capacidade premium e a funcionalidade que depende dessa capacidade não vai funcionar, a menos que o instalador reatribua manualmente o workspace instalado para a capacidade premium.
Importante
A opção Desenvolver um aplicativo de modelo só pode ser selecionada ao criar o espaço de trabalho do construtor de aplicativos. Depois que um workspace é definido como um workspace do App Builder, a funcionalidade do App Builder nunca pode ser removida do workspace.
Quando terminar de criar o workspace, selecione Salvar.
Observação
Você precisa de permissões de administrador do Power BI para promover aplicativos de modelo.
Adicionar o conteúdo ao workspace do aplicativo de modelo
Assim como ocorre com um workspace do Power BI comum, a próxima etapa será adicionar conteúdo ao workspace. Caso esteja usando parâmetros no Power Query, verifique se eles têm tipos bem definidos, como Text. Não há suporte para os tipos Any e Binary.
Para sugestões a serem consideradas ao criar relatórios e dashboards para seu aplicativo de modelo, confira Dicas para criar aplicativos de modelo no Power BI.
Definir as propriedades do aplicativo de modelo
Agora que há algum conteúdo no workspace, você pode empacotá-lo em um aplicativo de modelo. A primeira etapa é criar um aplicativo de modelo de teste, acessível somente na organização do locatário.
No workspace do aplicativo de modelo, selecione Criar aplicativo.
Em seguida, preencha mais opções para seu aplicativo de modelo em seis guias.
Na guia Identidade visual, preencha os seguintes campos:
- Nome do aplicativo
- Descrição
- Site de suporte. O link de suporte aparece nas informações do aplicativo depois que você redistribui o aplicativo de modelo como um aplicativo organizacional.
- Logotipo do aplicativo. O logotipo tem um limite de tamanho de arquivo de 45K, deve ter uma taxa de proporção 1:1 e estar em um formato de arquivo .png, .jpg ou .jpeg.
- Cores do tema de aplicativo
Na guia Navegação, ative Novo construtor de navegação para definir o painel de navegação do aplicativo.
Se você não ativar Novo construtor de navegação, poderá selecionar uma página de aterrissagem de aplicativo. Defina um relatório ou um dashboard para ser a página de aterrissagem do aplicativo. Use uma página de aterrissagem que dê a impressão desejada.
Na guia Controle, defina os limites e restrições dos usuários do aplicativo no conteúdo do aplicativo. Você pode usar esse controle para proteger propriedade intelectual no seu aplicativo.
Observação
Se você quiser proteger seus dados, desabilite a opção Baixar o relatório para o arquivo e configure as outras duas opções conforme desejado.
Por quê:
Os controles para exibir, editar e exportar nessa guia aplicam-se somente ao serviço do Power BI. Depois de baixar o arquivo .pbix, ele não estará mais no serviço. Ele coloca uma cópia desprotegida dos seus dados em um local escolhido pelo usuário. Você não terá mais controle sobre o que o usuário pode fazer com eles.
Se você quiser limitar o acesso às suas consultas e medidas enquanto ainda permite que os usuários adicionem suas próprias fontes de dados, considere marcar apenas as opções Exportar os dados ou conectar-se a eles externamente. Isso permite que os usuários adicionem fontes de dados próprias, sem a capacidade de editar seu modelo semântico. Para obter mais informações, confira Usar modelos compostos no Power BI Desktop.
Os parâmetros são criados no arquivo .pbix original (saiba mais sobre como criar parâmetros de consulta). Você usará as funcionalidades dessa guia para ajudar o instalador do aplicativo a configurar o aplicativo após a instalação quando os usuários se conectarem aos respectivos dados.
Cada parâmetro tem um nome proveniente da consulta e um campo de Valor. Há três opções para obter um valor para o parâmetro durante a instalação:
Você pode exigir que o usuário que instala o aplicativo insira um valor.
Nesse caso, você fornece um exemplo que o usuário substitui. Para configurar um parâmetro dessa forma, selecione Obrigatório e dê um exemplo na caixa de texto que mostre ao usuário que tipo de valor é esperado, como mostra o exemplo a seguir.
Forneça um valor previamente preenchido que não poderá ser alterado pelo usuário que instalar o aplicativo.
Um parâmetro configurado dessa maneira é ocultado do usuário que instala o aplicativo. Use esse método apenas se tiver certeza de que o valor preenchido é válido para todos os usuários. Caso contrário, use o primeiro método que requer entrada de usuário.
Para configurar um parâmetro dessa forma, insira o valor na caixa de texto Valor e selecione o ícone de bloqueio para que o valor não possa ser alterado. O seguinte exemplo mostra esta opção:
Forneça um valor padrão que poderá ser alterado pelo usuário durante a instalação.
Para configurar um parâmetro dessa forma, insira o valor padrão desejado na caixa de texto Valor e mantenha o ícone de cadeado aberto, como no seguinte exemplo:
Nessa guia, você também fornecerá um link para a documentação do aplicativo.
Na guia Autenticação, selecione o método de autenticação a ser usado. As opções disponíveis dependem dos tipos de fontes de dados que estão sendo usados.
O nível de privacidade é configurado automaticamente:
- Uma só fonte de dados é configurada automaticamente como privada.
- Uma fonte de dados múltipla anônima é configurada automaticamente como pública.
Na fase de teste, na guia Acesso, decida quais outras pessoas da sua organização podem instalar e testar o aplicativo. Você vai voltar e alterar essas configurações mais tarde. A configuração não afeta o acesso do aplicativo de modelo distribuído.
Selecione Criar aplicativo.
Você verá uma mensagem indicando que o aplicativo de teste está pronto, com um link para copiar e compartilhar com os testadores do aplicativo.
Você também realizou a primeira etapa do processo de Gerenciamento de versão seguir.
Gerenciar a versão do aplicativo de modelo
Antes de liberar o aplicativo de modelo publicamente, é recomendável verificar se ele está pronto. No painel de gerenciamento de versão do Power BI, você pode seguir e inspecionar o caminho completo da versão do aplicativo. Você também pode disparar a transição de um estágio a outro. Os estágios comuns são:
- Gerar um aplicativo de teste para testar apenas na sua organização.
- Promover o pacote de teste à fase de pré-produção e testar fora de sua organização.
- Promova o pacote de pré-produção para a versão de produção em Produção.
- Exclua qualquer pacote ou recomece na fase anterior.
O URL não muda quando você se move entre os estágios de lançamento. A promoção não afeta a URL em si.
Para passar pelos estágios de lançamento:
No workspace de modelo, selecione Gerenciamento de Versão.
Se você seguiu as etapas neste artigo para criar o aplicativo de teste, o ponto ao lado de Teste já estará preenchido. Selecione Obter link.
Se você ainda não criou o aplicativo, selecione Criar aplicativo para iniciar o processo de criação do aplicativo de modelo.
Para testar a experiência de instalação do aplicativo, copie o link da janela e cole-o em uma nova janela do navegador.
Aqui, você seguirá o mesmo procedimento que os instaladores de aplicativo seguirão. Para mais informações, confira Instalar e distribuir aplicativos de modelo em sua organização.
Na caixa de diálogo, selecione Instalar.
Depois que a instalação for bem-sucedida, selecione o aplicativo na lista Aplicativos para abri-lo.
Verifique se o aplicativo de teste tem os dados de exemplo. Para fazer alterações, volte ao aplicativo no workspace original. Atualize o aplicativo de teste até ficar satisfeito.
Quando estiver pronto para promover o aplicativo à pré-produção para testes adicionais fora do locatário, volte ao painel Gerenciamento de versão e selecione Promover aplicativo.
Observação
Quando você promove o aplicativo, ele se torna disponível publicamente fora da sua organização.
Se a opção Promover aplicativo não for exibida, contate o administrador do Power BI para que ele conceda permissões de desenvolvimento de aplicativo de modelo no portal de administração.
Na caixa de diálogo, selecione Promover.
Copie a nova URL para compartilhamento fora do locatário para teste. Esse link também é aquele que você enviará para iniciar o processo de distribuição do aplicativo no AppSource ao criar uma oferta da Central de Parceiros.
Envie somente links de pré-produção para a Central de Parceiros. Depois que o aplicativo for aprovado e receber notificação de que está publicado no AppSource, você poderá promover esse pacote para produção no Power BI.
Quando o aplicativo estiver pronto para produção ou compartilhamento por meio do AppSource, volte ao painel Gerenciamento de Versão e selecione Promover aplicativo ao lado de Pré-produção.
Selecione Promover.
Agora o aplicativo está em produção e pronto para distribuição.
Para disponibilizar o aplicativo amplamente para usuários do Power BI no mundo todo, envie-p ao AppSource. Para obter mais informações, confira a oferta Criar um aplicativo do Power BI.
Como automatizar uma configuração de parâmetros durante a instalação
Se você for um fornecedor independente de software e estiver distribuindo seu aplicativo de modelo por meio de um serviço Web, será possível criar um tipo de automação que configurará parâmetros do aplicativo de modelo de modo automático quando os clientes instalarem o aplicativo no Power BI. A configuração automática facilita o processo para seus clientes e aumentará a probabilidade de uma instalação ser bem-sucedida porque os clientes não precisarão fornecer detalhes que talvez não saibam. Para obter mais informações, confira Configuração automatizada de uma instalação de aplicativo de modelo.
Conteúdo relacionado
- Para saber como os clientes interagem com o aplicativo de modelo, confira Instalar, personalizar e distribuir aplicativos de modelo em sua organização.
- Para obter detalhes sobre como distribuir seu aplicativo, confira a oferta Criar um aplicativo do Power BI.