Para criar relatórios utilizando a ferramenta Power BI, é necessário ter uma conta na página do Power BI Online e instalar a versão desktop do Power BI. O acesso à fonte de dados a partir do Power BI, onde estão os dados do produto Valuekeep, é feito através de pedidos REST à WebAPI, usando uma ligação a dados externos Web.
Para criar um relatório no Power BI e aceder ao mesmo no produto Valuekeep, devem ser executados os seguintes passos:
- Aceder ao Power BI Desktop e criar um novo relatório;
- Aceder à opção “Base > Dados Externos > Obter Dados > Web”;
- No ecrã apresentado “Da Web”, selecionar a opção “Básico”, colocar no campo “URL” o url do pedido REST à WebAPI conforme descrito na documentação da WebAPI e selecionar “OK”;
- Exemplo de pedido REST:
http://{servidor}/Valuekeep_WebAPI/api/{tenant}/{organization}/maintenancemanagementcore/assetfamilies
- De seguida é apresentado o ecrã de acesso ao conteúdo Web onde será feita a autenticação na WebAPI. Neste ecrã deve ser selecionada a opção “Básica” e introduzidas as credenciais de login usadas no produto Valuekeep. Selecionar “Ligar”;
- De seguida é apresentado o “Editor de Consultas” para configuração e transformação das consultas. Para configuração das consultas devem ser executados os seguintes passos:
- Selecionar a consulta que se pretende transformar;
- Selecionar a opção “Ferramentas de Lista > Transformar > Converter > Para Tabela”. No ecrã apresentado selecionar as opções pretendidas e de seguida a opção “OK”;
- Na grelha de valores que é apresentada, selecionar a coluna exibida e escolher a opção “Transformar > Coluna Estruturada > Expandir”;
- No ecrã apresentado para expandir a coluna, selecionar as colunas a expandir e, caso pretendido, definir o prefixo para as mesmas. Selecionar a opção “OK”;
- É apresentada a tabela com os dados resultantes do pedido REST feito à WebAPI.
- Para cada consulta resultante de um pedido REST à WebAPI que seja usada no relatório, devem ser executados os passos anteriores;
- Após configuradas todas as consultas às origens de dados, selecionar a opção “Base > Fechar > Fechar e Aplicar”.
- De seguida são executadas todas as consultas e são apresentados os campos das mesmas para utilização no relatório;
- Selecionar os campos pretendidos e criar o relatório;
- Após criar e gravar o relatório, é necessário publicar o mesmo no Power BI Online. Para isso selecionar a opção “Base > Partilhar > Publicar”;
- É necessário fazer a autenticação com os dados de acesso ao Power BI Online e publicar;
- É apresentado o ecrã de publicação no Power BI com êxito. Seguir o link apresentado para abrir o relatório no Power BI;
- Para colocar este relatório acessível no produto Valuekeep é necessário publicar o relatório na Web. No Power BI Online selecionar a opção “Ficheiro > Publicar na Web”, escolher “Criar código de incorporação” e de seguida “Publicar”;
- É apresentado um link de acesso ao relatório (“Ligação que pode enviar por e-mail”), que deve ser guardado para utilização posterior.
Após os passos anteriores é necessário configurar no produto Valuekeep a disponibilização do relatório criado aos utilizadores. Para isso devem ser executados os seguintes passos:
- Aceder ao produto Valuekeep com um utilizador que tenha acesso à criação ou edição de dashboards;
- Criar um novo dashboard ou editar um existente onde será possível aceder ao relatório criado no Power BI;
- Adicionar uma parte do tipo Navegador e selecionar Novo para criar uma nova configuração;
- Preencher o Nome e Descrição da configuração e selecionar a opção “Adicionar Link Externo”;
- Nos campos de configuração do Link Externo preencher o campo Legenda para o link e no campo URL colocar o link gerado na publicação do relatório no Power BI Online (último ponto dos anteriores passos de criação do relatório). Selecionar “Aceitar” e “Guardar”. De seguida, selecionar “Aceitar” para aplicar à parte a configuração criada;
- Após terminar a edição, “Guardar e partilhar” o dashboard e selecionar os perfis que devem ter acesso ao mesmo.