Selecione a opção abaixo:

• Overview
• Configurando serviço PowerBI Embbeded
• Configurações do Portal de Relatórios
• Login
• Esqueci Senha
• Alterar Senha
• Tela Inicial
• Barra de Navegação
• Indicadores
• Administrar - Usuários
• Administrar - Grupos
• Administrar - Relatórios
• Administrar - Permissões
• Visualizar - Meu Usuário
• Visualizar - Log

É a primeira tela do Portal após o Usuário se logar

Essa tela exibe seu nome para saber que você está identificado e exibe algumas informações em forma de overview de como navegar no Portal

O Portal de Relatórios é um sistema WEB com o objetivo de centralizar em um único local os relatórios desenvolvidos em PowerBI para que de forma fácil e centralizada possam ser acessados.

Os relatórios são exibidos dentro do próprio Portal de acordo com as regras e perfil do úsuário que está logado.

O resumo abaixo mostra as telas que fazem parte do Portal e quem pode acessar.

Cada uma das opções abaixo tem seu documento de ajuda e pode ser acessado clicando aqui.

Tela	Perfil Admin	Perfil Normal
Login	Sim	Sim
Esqueci Senha	Sim	Sim
Alterar Senha	Sim	Sim
Tela Inicial	Sim	Sim
Barra de navegação	Sim	Sim
Relatórios	Sim	Sim
Administrar - Usuários	Sim	Não
Administrar - Grupos	Sim	Não
Administrar - Relatórios	Sim	Não
Administrar - Permissões	Sim	Não
Visualizar - Meu Usuário	Sim	Sim
Visualizar - Log	Sim	Não

Para o desenvolvimento do Portal de Relatórios, foram utilizados as seguintes técnologias:
    - Microsoft .NET Core (Framework)
    - C# (linguagem)
    - MVC (Design Pattern)
    - Entity Framework Core na camada de acesso a dados
    - Razor e Bootstrap na camada de visualização
    - Banco de Dados Azure SQL     - PowerBI Embedded

Login é a primeira tela do Portal. Sem passar por essa tela, não tem como navegar pelos recursos que o Portal oferece, pois somente após o login é possível identificar quem é o usuário que está se logando e quais são suas permissões.

Na tela de Login é solicitado duas informações:
  - E-mail
  - Senha

Após preencher essas informações, clique no botão "Entrar" então será validado as seguintes informações:
  - E-mail está preenchido ?
  - E-mail é válido dentro do sistema ?
  - A senha está preenchida ?
  - A senha é valida ?

Se todas as informações acima estiverem preenchidas corretamnente, você será logado no Portal e direcionado para a Tela Inicial.

No primeiro login do usuário no Portal utilizando a senha temporária que foi enviada por e-mail, você será direcionado para alterar a senha.

Caso tenha esquecido sua senha, clique no botão Equeci Senha para que uma nova senha seja gerada.

Caso tenha esquecido sua senha, clique no botão Esqueci Senha na tela de Login e você será direcionado para conforme imagem abaixo.

Após preencher seu e-mail e o mesmo for validado, você receberá um e-mail com uma nova senha temporária conforme imagem abaixo:

No próximo login você deverá utilizar a senha que recebeu por e-mail, então nesse momento será solicitado para que você insira uma nova senha

Existem duas formas de acessar essa tela:
  - Ao clicar no Botão "Esqueci Senha" da tela de Login
  - Ao clicar no Botão "Alterar Senha" localizado na página "Meu Usuário"

Aqui será explicado a primeira forma, a segunda forma pode ser visualizado no documento de Ajuda Visualizar - Meu Usuário

As seguintes regras deverão ser obedecidas no preenchimento da nova senha:

Campo	Descrição	Obrigatório	Regras
E-mail	Digite seu e-mail	Sim	-
Senha Atual	Senha temporária recebida por e-mail	Sim	-
Nova senha	Digite a nova senha	Sim	Ser diferente da senha temporária recebida por e-mail Mínimo 5 caracteres Deverá conter pelo menos 1 número Deverá conter pelo menos 1 letra maiúscula
Repetir Nova senha	Digite a nova senha	Sim	Deverá ser igual a Nova Senha

Se tudo for preenchido de forma correta, sua senha será alterada e você será redirecionado para a tela de login onde deverá usar a nova senha que acabou de ser cadastrada.

Após ser feito o Login, no Menu Superior aparecerá a Barra de Navegação com as devidas opções conforme imagem abaixo:

Podemos dividir essa Barra de Navegação em 5 partes:

• Parte 1 - Logo e Nome:
      Logo e Nome do Portal de acordo com a Empresa e Nome


• Parte 2 - Título da Página Corrente:
      Esse Título irá variar de acordo com a página que você estiver, por exemplo, se estiver na página do Login irá aparecer o "Login" no título e assim por diante


• Parte 3 - Menu de Opções:
      As opções variam de acordo com o perfil do usuário. Para usuários com:
           Perfil Administrador: Relatórios, Administrar - Usuários, Administrar - Grupos, Administrar - Relatórios,
                                               Administrar - Permissões, Visualizar - Meu Usuário e Visualizar - Log
          Perfil Normal: Relatórios e Visualizar - Meu Usuário


• Parte 4 - Ajuda do Portal:
      Ao clicar nesse ícone, a Ajuda do Sistema é aberta. Dependendo da página que você estiver, a ajuda já abre no tópico relacionado a página que você está navegando


• Parte 5 - Sair do Portal:
      Ao clicar nesse ícone, é exibido uma mensagem (conforme imagem abaixo) perguntando se deseja realmente sair do Portal. Caso confirme, é feito o Log-out do usuário e o Portal é redirecionado para a tela de login novamente

Essa é tela onde é possível ver os indicadores.
Todas as opções disponíveis para seu usuário, foram previamente configurados pelo administrador do Portal, portanto caso esteja falatando algum indicador, verifique com o administrador do Portal se você está com permissão.
Para visualizar os indicadores, são necessários dois passos:
    - Selecionar Grupo
    - Selecionar Permissão

Selecionar Grupo

Selecione um dos Grupos disponíveis para seu usuário.
Obs: Grupos correspondem aos WorksSpaces do PowerBI

Selecionar Permissão

Ao selecionar um Grupo, serão disponibilizados as permissões que fazem parte do Grupo e que o usuário logado possue acesso.

Ao selecionar o Relatório, as informações serão apresentadas na tela:

Com a Administração de Usuários é possível:
   - Cadastrar novo usuário
   - Alterar usuários existentes
   - Excluir usuários existentes

Listagem de Usuários

Ao entrar na Administração de Usuários, a primeira tela é a de Listagem dos usuários cadastrados no sistema. Nessa tela pode-se:
   - Ordenar registros de usuários por qualquer coluna clicando na seta cima/baixo no nome da coluna
   - Paginar o retorno da listagem de usuários
   - Criar novos registros de usuários clicando no botão "Novo Usuário"
   - Alterar registros de usuários clicando no primeiro ícone da última coluna
   - Excluir registros de usuários clicando no segundo ícone da útlima coluna. Obs: Não é possível excluir seu próprio usuário, nesse caso o icone não aparecerá

Criar novo Usuário

Clicando no botão "Novo Usuário", é aberto a tela para cadastrar um novo usuário.
As seguintes regras deverão ser obedecidas no preenchimento:

Campo	Descrição	Obrigatório	Regras
Nome	Nome do Usuário	Sim	-
CPF	Cadastro de Pessoas Físicas do usuário que está sendo cadatrado	Sim	Ser um CPF válido Não estar em uso Caso seja usuário [email protected] o CPF não será validado, apenas terá que ser preenchido
Matrícula	Nome de matrícula do Usuário	Não	Não é obrigatório, mas caso preenchido, não pode haver repetição
E-mail	E-mail do usuário que está sendo cadastrado	Sim	Ser um E-mail válido Não estar em uso
Repetir Nova senha	Digite a nova senha	Sim	Deverá ser igual a Nova Senha
Senha	Senha do Usuário	Sim	A senha inicial é gerada automáticamente e enviada por e-mail
Ativo	Flag indicando se o usuário está ativo	Sim	No momento do cadastro, sempre o usuário ficará com status de ativo
Administrado	Flag indicando se o usuário possui o perfil de administrado	Sim	-

Ao clicar em Salvar, se tudo estiver preenchido corretamente, o Portal voltará automaticamente para a listagem de usuários e o usuário que acabou de ser cadastrado, irá receber um e-mail com as informações para fazer o primeiro login no Portal

Alterar Usuário

Clicando no primeiro ícone da última coluna na tela de listagem, é possível editar o registro 

As regras de alteração são as mesmas do cadastro, porem nesse momento pode-se:
   - Nome: Pode ser alterado
   - CPF: Não pode ser alterado
   - Matrícula: Pode ser alterado
   - E-mail: Não pode ser alterado
   - Ativo: Pode ser alterado
   - Alterar Senha: Caso seja marcado "Sim", no próximo login o usuário terá que trocar sua senha e a senha temporária será enviada por e-mail
   - Administrador: Pode ser alterado

Excluir Usuário

Clicando no segundo ícone da última coluna na tela de listagem, é possível excluir o registro 
Obs:Esse ícone não estará disponível para o próprio registro do usuário que está logado
Ao clicar no botão de excluir é aberto uma tela para que seja confirmado a exclusão Clicando em "Excluir Registro", o mesmo é excluído

Com a Administração de Grupos é possível:
   - Cadastrar novo grupo
   - Alterar grupos existentes
   - Excluir grupos existentes

Listagem de Grupos

Ao entrar na Administração de Grupos, a primeira tela é a de Listagem dos grupos cadastrados no sistema. Nessa tela pode-se:
   - Ordenar registros de grupos por qualquer coluna clicando na seta cima/baixo no nome da coluna
   - Paginar o retorno da listagem de grupos
   - Criar novos registros de grupos clicando no botão "Novo Grupo"
   - Alterar registros de grupos clicando no primeiro ícone da última coluna
   - Excluir registros de grupos clicando no segundo ícone da útlima coluna
   - Listar usuários que fazem parte do Grupo sem precisar entrar no registro

Criar novo Grupo

Clicando no botão "Novo Grupo", é aberto a tela para cadastrar um novo grupo.
As seguintes regras deverão ser obedecidas no preenchimento:

Campo	Descrição	Obrigatório	Regras
Nome	Nome do Grupo	Sim	Não pode ser utilizado nome de grupo que já exista
Usuários	Usuários que pertencerão a um grupo	Sim	Para selecionar mais de um usuário, mantenha a tecla CTRL pressionada

Ao clicar em Salvar, se tudo estiver preenchido corretamente, o Portal voltará automaticamente para a listagem de grupos

Alterar Grupo

Clicando no primeiro ícone da última coluna na tela de listagem, é possível editar o registro 

As regras de alteração são as mesmas do cadastro, porem nesse momento pode-se:
   - Nome: Pode ser alterado
   - Usuário: Pode ser alterado

Excluir Grupo

Clicando no segundo ícone da última coluna na tela de listagem, é possível excluir o registro 
Ao clicar no botão de excluir é aberto uma tela para que seja confirmado a exclusão Clicando em "Excluir Registro", o mesmo é excluído

Listar Usuários do Grupo

Clicando no ícone da segunda coluna, será aberto uma janela com a lista dos usuários que fazem parte do grupo. Com isso não é necessário editar o registros caso queria somente ver os usuários que fazem parte do grupo 

Com a Administração de Relatórios é possível:
   - Cadastrar novo relatório
   - Alterar relatórios existentes
   - Excluir relatórios existentes

Listagem de Relatórios

Ao entrar na Administração de Relatórios, a primeira tela é a de Listagem dos relatórios cadastrados no sistema. Nessa tela pode-se:
   - Ordenar registros de relatórios por qualquer coluna clicando na seta cima/baixo no nome da coluna
   - Paginar o retorno da listagem de relatórios
   - Criar novos registros de relatório clicando no botão "Novo cadastro de relatório"
   - Alterar registros de relatórios clicando no primeiro ícone da última coluna
   - Excluir registros de relatórios clicando no segundo ícone da útlima coluna

Criar novo Relatório

Clicando no botão "Novo cadastro de relatório", é aberto a tela para cadastrar um novo relatório.
O último item desse documento, mostra como buscar os valores para cada um dos campos do cadastro de relatórios.
As seguintes regras deverão ser obedecidas no preenchimento:

Campo	Descrição	Obrigatório	Regras
Nome	Nome do Relatório	Sim	Não pode ser utilizado nome de relatório que já exista
Subscription Id	Identificação de sua subscrição na Azure	Sim	-
Group Id	Identificação do Group Id a qual pertence o relatório	Sim	-
Report Id Id	Identificação do relatório	Sim	-

Nesse cadastro clicando no botão "+" é possível incluir, excluir RLS's relacionadas ao relatório. Caso seja incluido uma nova RLS, o campo será de preenchimento obrigatório e não é permitido ter mais de uma RLS do mesmo relatório com o memso nome
Ao clicar em Salvar, se tudo estiver preenchido corretamente, o Portal voltará automaticamente para a listagem de relatórios

Alterar Relatório

Clicando no primeiro ícone da última coluna na tela de listagem, é possível editar o registro 

As regras de alteração são as mesmas do cadastro

Excluir Relatório

Clicando no segundo ícone da última coluna na tela de listagem, é possível excluir o registro 
Ao clicar no botão de excluir é aberto uma tela para que seja confirmado a exclusão Clicando em "Excluir Registro", o mesmo é excluído

Como buscar valores para preencher o cadastro

Subscription Id:
  É o Tenant Id. Para localiza-lo:
    1. Entre no Portal Azure
    2. Entre no AAD
    3. Na página que será aberta (Overview), é possível localizar o número do Tenant Id (que é o Subscription Id)

Group Id:
  É a identificação do Grupo (Workspace). Para localiza-lo:
    1. Entre no Portal PowerBI ( https://app.powerbi.com/ )
    2. Localiza a Workspace (que estiver configurada como Embbeded)
    3. Localize o relatório a ser "embedado"
    4. Abra o relatório
    5. Na URL da aba que o relatório está aberto, copie o GUID depois de groups


Report Id:
  É a identificação do Relatório. Para localiza-lo:
    1. Entre no Portal PowerBI ( https://app.powerbi.com/ )
    2. Localiza a Workspace (que estiver configurada como Embbeded)
    3. Localize o relatório a ser "embedado"
    4. Abra o relatório
    5. Na URL da aba que o relatório está aberto, copie o GUID depois de reports

Com a Administração de Permissões é possível:
   - Cadastrar nova permissão
   - Alterar permissões existentes
   - Excluir permissões existentes
   - Listar usuários que fazem parte da permissões
   - Listar grupos que fazem parte da permissões
   - Listar RLS's' que fazem parte da permissões
De forma geral, pode-se dizer que a Permissão é a parte mais importante a ser cadastrada, pois sem ela o Portal não tem como saber o que deve fazer ao carregar o relatório.

Listagem de Permissões

Ao entrar na Administração de Permissões, a primeira tela é a de Listagem das permissões cadastrados no sistema. Nessa tela pode-se:
   - Ordenar registros de permissões por qualquer coluna clicando na seta cima/baixo no nome da coluna
   - Paginar o retorno da listagem de permissões
   - Criar novos registros de permissões clicando no botão "Nova Permissão"
   - Alterar registros de permissão clicando no primeiro ícone da última coluna
   - Excluir registros de permissão clicando no segundo ícone da útlima coluna
   - Visualizar usuários da Permissão
   - Visualizar grupos da Permissão
   - Visualizar RLS's' da Permissão

Criar novo Permissão

Clicando no botão "Nova Permissão", é aberto a tela para cadastrar um nova permissão.
As seguintes regras deverão ser obedecidas no preenchimento:

Campo	Descrição	Obrigatório	Regras
Nome da Permissão	Nome da Permissão	Sim	Não pode ser utilizado nome de permissão que já exista
Relatório	Selecione o relatório que deseja dar uma nova permissão	Sim	-
RLS's	Ao selecionar o relatório no campo anterior, é listado todas as RLS's que pertencem ao relatório. Caso deseje selecionar uma ou mais RLS's, é nesse campo que deverá ser selecionada.	Não	-
Usuários	Lista de usuários que podem fazer parte da permissão	Sim	Deve-se selecionar Usuário e/ou Grupos
Grupos	Lista de grupos que podem fazer parte da permissão	Sim	Deve-se selecionar Usuário e/ou Grupos

Ao clicar em Salvar, se tudo estiver preenchido corretamente, o Portal voltará automaticamente para a listagem de permissões

Alterar Permissão

Clicando no primeiro ícone da última coluna na tela de permissões, é possível editar o registro 

As regras de alteração são as mesmas do cadastro

Excluir Permissão

Clicando no segundo ícone da última coluna na tela de listagem, é possível excluir o registro 
Ao clicar no botão de excluir é aberto uma tela para que seja confirmado a exclusão Clicando em "Excluir Registro", o mesmo é excluído

Listar Usuários da Permissão

Clicando no ícone da coluna "Usuários", será aberto uma janela com a lista dos usuários que fazem parte da permissão. Com isso não é necessário editar o registros caso queria somente ver os usuários que fazem parte da permissão 

Listar Grupos da Permissão

Clicando no ícone da coluna "Grupos", será aberto uma janela com a lista dos grupos que fazem parte da permissão. Com isso não é necessário editar o registros caso queria somente ver os grupos que fazem parte da permissão 

Listar RLS's da Permissão

Clicando no ícone da coluna "RLS's'", será aberto uma janela com a lista das RLS's que fazem parte da permissão. Com isso não é necessário editar o registros caso queria somente ver as RLS's que fazem parte da permissão 

Através dessa tela é possível visualizar informações do seu usuário, porem nenhuma informação poderá ser alterada

A única ação que é possível fazer nesse momento, é alterar sua senha clicando em "Alterar Senha". Fica a observação que essa é a segunda forma de alterar senha conforme página de ajuda do Alterar Senha
Diferentemente do que acontece quando é clicado no botão "Alterar Senha" localizado na tela de login, nesse momento a senha já será trocada sem precisar do processo de receber por e-mail uma senha temporária.
As regras da nova senha são as mesmas de quando é clicado no botão "Alterar Senha", ou seja:

• Ser diferente da senha atual
• Mínimo 5 caracteres
• Deverá conter pelo menos 1 número
• Deverá conter pelo menos 1 letra maiúscula

Através dessa tela é possível visualizar todos os eventos que aconteceram no sistema como:
   - Primeiro Login do Usuário
   - Novos cadastros
   - Alteração de cadastros

Para que o Portal de Relatórios funcione corretamente, é necessário que você possua o Serviço Embedded do Power BI. Os próximos passos detalham como configurar esse serviço e deixar seu ambiente pronto para que os relatórios sejam exibidos dentro do Portal de Relatórios.

Passo 01-Pré requisitos

Antes de configurar o serviço do PowerBI Embedded, é necessário alguns pré-requisitos:
    - Possuir subscrição Azure ativa
    - Pelo menos 1 usuário possuir serviço Power BI Pró

Passo 02-Criar serviço PowerBI Embedded

Os passos para criar o serviço PowerBI Embedded são:
   1 - Como administrador Azure, entre em https://portal.azure.com
   2 - Passe o mouse em "Power BI Embedded" e na caixa que irá se abrir, clique em "Create" Preencha as informações conforme sua empresa e crie o serviço. Para mais detalhes de como criar o serviço PowerBI Embedded, consulte a documentação oficial da Microsoft clicando AQUI

Passo 03-Criar Workspace associados ao serviço PowerBI Embedded

Com um usuário que possua licança Pró de PowerBI, entre em https://app.powerbi.com/ e siga os passos:
   1 - Localize os Workspaces
   2 - Clique em "Create a workspace". Obs: Não esqueça de deixar o serviço PowerBI Embedded criado no passo anterior ativado (iniciado)
   3 - Preencha as informações normalmente, porem se atente na parte Advanced, onde deverá ser selecionado o serviço PowerBI Embedded que foi criado no tópico anterior
   4 - Se tudo der certo, o Workspace que foi criado ficará com uma marca de um diamente (conforme imagem abaixo). Essa marca de diamente significa que o Workspace está "atrelado" ao serviço do PowerBI Embedded que foi criado

Passo 04-Dar acesso ao Service Principal

Uma das vantagens de utilizar o serviço do PowerBI Embedded é que precisamos apenas de uma licença Pró (para criar o Workspace atrelado ao PowerBI Embedded), porem os demias usuários podem consumir o relatório sem ter licença.
Mas para isso funcionar, precisamos criar um usuário de serviço que ficará "encarregado" de buscar as informações do relatório e exibir dentro do Portal.
Esse usuário de serviço é o chamado Service Principal
Esse tipo de usuário é como se fosse um aplicativo que faz o "meio de campo" entre o Portal e o relatório utilizando o serviço do PowerBI Embedded
Para criar e dar acesso, siga os passos:
   1 - Entre no site https://app.powerbi.com/apps
   2 - Se autentique (no passo 1 da tela que irá se abrir)
   3 - Preencha os campos conforme tabela abaixo

Campo	Valor
Application Name	Crie um nome lógico para esse Service Principal
Application Type	Server-side web application (for web apps or web APIs)
Home Page URL	URL do seu Portal de Relatórios
Redirect URL	Mesmo valor do campo anterior
API access	Selecione todas

   4 - Clique em Register

   5 - Ao final será apresentado duas informações: Application ID e Application secret, onde o primeiro é como se fosse um usuário e o segundo a senha do usuário. Copie e guarde essas informações, pois sem elas o Portal de Relatórios não funciona.

Passo 05-Verificar se o APP (passo 4) criado está realmente com acesso na Azure

É bom e necessário verificar se o o APP (passo 4) realmente está com acesso dentro do serviço Azure. Para isso siga os passos:
   1 - Entre no site portal.azure.com
   2 - Vá em Azure Active Directory
   3 - Clique em App registrations
   4 - Clique na aba All applications e localize o APP criado no Passo 4

   5 - Clique no APP localizado
   6 - Clique na opção Authentication do lado esquerdo
   7 - Na tela que irá se abrir do lado direito verifique se a opção ID tokens (used for implicit and hybrid flows) está selecionada
   8 - Você poderá decidir quem poderá acessar o Portal e consumir seu serviço PowerBI Embedded. Recomenda-se deicar marcado a opção Accounts in this organizational directory only

   9 - Clique em Save para que as alterações sejam efetivadas
   10 - Clique em API permissions
   11 - Na tela que irá se abrir, clique em Grant admin consent for

Pronto ! Seu serviço PowerBI Embedded está configurado e pronto para ser consumido

Para que o Portal de Relatórios funcione sem nenhum problema, é necessário que ele esteja rodando preferencialmente dentro do Serviço App Service (WEB APPS) da Azure.
Ao todo o Sistema possui 7 configurações que podem ser alteradas.
A seguir será demonstrado como alterar essas configurações tendo como cenário que o Portal está rodando dentro do Serviço App Service da Azure.

Acessando Configurações

Para alterar as configurações os passos são:
   1 - Entrar no Portal Azure clicando AQUI
   2 - Localize o serviço (App Service) aonde está hospedado o Portal de Relatórios
   3 - Clique em Configuration e depois em Application settings
   4 - Será exibida uma lista de valores. Essa lista contêm os seguintes parâmetros que podem ser alterados:
      --> SmtpConfigurations__Host : Endereço do serviço SMTP
      --> SmtpConfigurations__Port : Porta do serviço SMTP
      --> SmtpConfigurations__Sender : E-mail do usuário que será o "SENDER" no disparo dos e-mails da aplicação
      --> SmtpConfigurations__Password : Senha do E-mal do usuário que será o "SENDER" no disparo dos e-mails da aplicação
      --> Embbeded__ClientId : ID do Service Principal do PowerBI Embedded
      --> Embbeded__ClienteSecretId : ID da senha do Service Principal do PowerBI Embedded
      --> ConnectionStrings__DefaultConnection : String de conexão para acessar o Banco de Dados

OBS: No caso do seu servidor ser Windows, ao invés do "__" deverá ser utilizado ":". Exemplo: A chave "SmtpConfigurations__Host" no caso do App Service ser Windows, ficaria "SmtpConfigurations:Host"

   5 - Altere os valores necessários e depois clique em "SAVE"
   6 - Para guarantir que as alterações sejam efetivadas, clique em "REFRESH" para que a aplicação seja atualizada com os novos valores