Como incorporar relatórios do Microsoft Power BI em aplicativos Umbraco?

Visão geral

Guia para incorporar relatórios e painéis do Power BI em Umbraco. Integre o Microsoft Power BI com o Umbraco usando o miniOrange Power BI Integrador plugin. Este guia de configuração guiará você pelas etapas para incorporar relatórios, painéis, blocos, conjuntos de dados ou modelos semânticos do Power BI em suas páginas e postagens do Umbraco, permitindo que os usuários visualizem artefatos interativos do Power BI diretamente do site do Umbraco. Você também pode habilitar a Segurança em Nível de Linha (RLS) para uma visualização granular e personalizada dos gráficos do Power BI no Umbraco.

Baixar

Planos de preços

Pré-requisitos: Download e instalação

O integrador miniOrange Umbraco requer:

Um aplicativo Umbraco em execução na versão 9 a 15.

O aplicativo deve ser conectado a um MS SQL Server. (Caso contrário, podemos sugerir a versão apropriada com base no seu banco de dados.)

Se o seu aplicativo não usa um banco de dados, também podemos fornecer uma versão que funcione sem um banco de dados.

A Microsoft Power BI conta.

Adicionando miniOrange ao aplicativo Umbraco

Instale o Pacote NuGet do Integrador PowerBI miniOrange usando o Gerenciador de Pacotes Nuget ou CLI.

Pacote NuGet

CLI .NET

PM> NuGet\Install-Package miniOrange.Umbraco.PowerBI.Integrator

Uma vez instalado, basta construir o aplicativo para adicionar visualizações e arquivos estáticos do miniOrange.

Adicione os seguintes detalhes em seu programa.cs arquivo.

                
                      using miniOrange.Umbraco.PowerBI;
                    
                     using Umbraco_PowerBI_Integrator;

                      using Umbraco_PowerBI_Integrator.RouteObserver;
                    
                      WebApplicationBuilder builder =  WebApplication.CreateBuilder(args);

  builder.Services.AddMiniOrangeServices(builder.Configuration);

                      builder.CreateUmbracoBuilder()
                    
.AddBackOffice()

.AddWebsite()

.AddDeliveryApi()

.AddComposers()

.Build()

  WebApplication app =  builder.Build();

  await app.BootUmbracoAsync();

  app.UseStaticFiles();

  app.UseUmbraco()

.WithMiddleware(u =>

{

              u.UseBackOffice();

              u.UseWebsite();

              u.AppBuilder.UseminiOrangeUmbracoPowerBIMiddleware();

})

.WithEndpoints(u =>

{

              u.UseInstallerEndpoints();

              u.UseBackOfficeEndpoints();

              u.UseWebsiteEndpoints();

});

  await app.RunAsync();

Crie e execute o aplicativo.

Configurar o Azure AD para integração com o PowerBI

Faremos algumas configurações do PowerBI dentro do painel do miniOrange

1. Configurar o registro do aplicativo do Azure AD

Faça o login no azuread portal como administrador.

Será apresentada a tela inicial do Azure Active Directory.

Na seção de serviços do Azure, selecione ID de entrada da Microsoft.

Na aba esquerda, na seção gerenciar, selecione Registros de aplicativos.

Azure Active Directory - Registros de Aplicativos

Clique em novo registro.

Azure Active Directory - Novos Registros

Atribuir o Nome visível no campo de nome e escolha o tipo de conta.

De acordo com o relatório URI de redirecionamento campo, forneça o URL base do seu Sítio Umbraco e clique no Registrar-se botão.

Azure Active Directory - Registrar um aplicativo

Após o registro de um aplicativo, o Azure AD atribui um único ID do aplicativo ao seu aplicativo.

Navegue até a Guia Visão geral, no painel esquerdo.

Copie o ID do aplicativo e ID do diretório, este será seu ID do cliente e ID do inquilino.

Azure Active Directory - ID exclusivo do aplicativo

No painel de navegação esquerdo, navegue até Certificados e segredos aba.

Clique em um novo segredo do cliente. Insira a descrição e o prazo de validade e clique em ADD opção.

Azure Active Directory - Certificados e Segredos

Copie o valor de Chave Secreta. Este será seu Chave secreta do cliente.

2. Adicione permissões de API ao seu aplicativo do Azure AD:

Acesse Permissões de API no painel de navegação esquerdo e clique em adicionar uma permissão opção.

Azure Active Directory - Permissões de API

Selecionar Microsoft Graph sob a APIs da Microsoft aba.

Selecionar Permissões do aplicativo e pesquise pelo Utilizador.

Debaixo Utilizador selecionar Usuário. Ler e Usuário.Ler.Tudo permissões e clique em Adicionar permissões botão.(microsoft graph)

Permissões de leitura de todos os usuários

Clique em adicionar permissão, role para baixo e selecione Serviço do Power BI sob solicitação de opção de permissão de API.

Selecionar Permissão de Delegado e pesquise pelo Relatório .

Debaixo Relatórios selecionar Relatar.Ler.Tudo permissão e clique em Adicionar permissão botão. (Power BI)

Agora você pode ver todas as permissões no permissão de API seção

Clique em conceder consentimento administrativo para o diretório padrão e clique em Sim na confirmação do consentimento do administrador da concessão.

Consentimento administrativo da concessão

Você configurou com sucesso o aplicativo do Azure AD.

3. Configurar as configurações do grupo de segurança do Azure AD

Na página inicial do diretório ativo do Azure, navegue até Grupos do painel esquerdo.

Clique em Novo Grupo para adicionar um novo grupo de segurança.

Selecione os Tipo de grupo as Total no menu suspenso e digite o Nome do grupo as Permitir APIs de administração do Power BI.

Depois de inserir os detalhes, clique em Botão Criar para criar um novo grupo de segurança.

Pesquise e selecione grupos de segurança recém-criados (Permitir APIs de administração do Power BI).

Azure Active Directory - Novos Grupos de Segurança Criados

Navegue até a Membros guia no painel esquerdo e clique em Adicionar membros.

Azure Active Directory - Adicionar membros

Agora procure o nome do aplicativo que você configurou anteriormente e clique no selecionar botão.

Você configurou com sucesso o Aplicativo do Azure AD para obter sincronização de usuário e integração do Power BI no seu aplicativo Umbraco.

Configurar o PowerBI para integração.

Vou ao Power BI painel e faça login como administrador.

Você será representado pela tela inicial do Power BI.

No canto superior direito, clique em ícone de configurações como mostrado abaixo.

Sob o governança e insights clique no portal de administração opção.

De acordo com o relatório Portal de administração seção, sob o configurações do locatário, role para baixo até o configurações do desenvolvedor.

Clique em Permitir que os principais serviços criem e usem perfis.

permitir que o alternancia e depois clique em Inscreva-se.

PowerBI - Configurações do locatário do portal de administração

Desloque-se até o Configurações da API de administração, ative a alternância e escolha a opção de grupos de segurança específicos.

Procurar por Grupo de usuários do Umbraco Power BI então clique em Inscreva-se.

Navegue de volta para a página inicial. Selecione o Espaços de trabalho guia no painel esquerdo e selecione seu espaço de trabalho na lista.

Navegue até a Gerenciar acesso aba.

De acordo com o relatório Gerenciar acesso seção, clique em adicionar Adicionar pessoas ou grupos.

Procure o aplicativo que você configurou anteriormente. No menu suspenso, selecione o Espectador e clique em Adicione botão para atribuir este aplicativo do Azure AD ao seu Espaço de trabalho do Power BI.

Selecione os que você deseja incorporar no Página ou postagem de Umbraco.

Em seguida, copie o ID do espaço de trabalho e ID do relatório da URL mostrada na imagem abaixo e mantenha-a à mão, pois você precisará dela no futuro.

Configurar o plugin miniOrange com a configuração do PowerBI

Acesse o aplicativo Umbraco.

Na URL base do seu aplicativo, adicione o /?ação=config parâmetro de consulta.(/?ação=config)

Você será mostrado com o Formulário de Cadastro, preencha e clique em Botão de registro.

Após o registro, você verá o Painel de Administração do miniOrange.

Vou ao Configurações de autenticação aba e entre ID do cliente, segredo do cliente e ID do locatário do seu aplicativo do Azure AD e clique em salvar.

Agora vá para o Configurações do Power BI guia e digite o Nome do relatório, Workspace_ID e ID do relatório do seu relatório.

O script será gerado e mostrará ID do espaço de trabalho e ID do relatório de sua Relatório do Power BI.

Entre na sua conta do Umbraco BackOffice.

Na aba conteúdo -> Clique na opção Relatórios do PowerBI.

Na versão de teste do miniOrange, você só poderá acessar o relatório após efetuar login com a conta Entra ID. Clique no botão "Entrar" e faça login com a conta Entra ID.

O relatório do PowerBI será exibido assim que você fizer login.

Contato

Entre em contato conosco em umbracosupport@xecurify.com, e nossa equipe ajudará você a configurar a integração do Power BI no Umbraco. Também ajudaremos você a escolher a solução ou plano mais adequado com base nas suas necessidades.

conteúdo