Como utilizar uma consulta do módulo Análises no Power BI?

Antes de prosseguirmos para o Power BI, precisamos localizar algumas informações importante no Qualiex.

Como encontrar o “un-alias” da minha empresa?

Essa informação é fundamental para localizar as informações registradas na minha empresa. Sem ela a conexão não pode ser realizada.

• Abra o Qualiex > painel dos módulos > “configurações clássicos“

• Na barra de URL do site, está localizado o “un-alias” da sua empresa, que sempre será o mesmo. Reserve essa informação que vamos usar depois.
  Exemplo da foto: “apps3.qualiex.com/empresathais/common/us”

Como encontrar o “identifier” da consulta do módulo Análises?

Essa informação é necessária para que seja possível localizar a consulta que enviará as informações para o aplicativo de BI.

• Abra o Qualiex > painel dos módulos > “Análises“

• Dentro do módulo escolha a consulta que você vai utilizar, como exemplo utilizei a consulta padrão do módulo “Auditorias“

• Na barra de URL do site está localizado o “identifier” da consulta escolhida, é único para cada consulta. Reserve essa informação que vamos usar depois.

Exemplo da foto: “//apps4.qualiex.com/common/empresathais/analysis/v/AxX5rQZc/%5BAuditorias%5D-CONSULTA-PADRÃO-QUALIEX-%7C-Auditorias-atrasadas-%5Bportuguês%5D”

Como conseguir gerar o token de acesso ao Qualiex via API?

Passo 1

• Inicialmente instale o Postman e faça login. Sem esse aplicativo você não terá acesso às informações necessárias para gerar o token de acesso.
  – Segue o link para download: https://www.postman.com/downloads/
• Após a instalação, entre e faça login no aplicativo;
  

Passo 2:

1. Selecione o método “POST“;
2. Insira a URL: https://login-api.qualiex.com/api/users/login
3. Por fim, envie as informações, em “SEND” ;

Passo 3:

Em seguida precisamos das propriedades de acesso, para isso acesse a página de Login do Qualiex, e com a opção inspecionar do navegador aberto, deverá realizar o login com a senha incorreta, que irá dar erro na requisição retornando as propriedades:

• Entre no navegador e abra o Qualiex;

• Faça login com seu e-mail correto e uma senha incorreta;

• Abra o inspecionar (clique com o botão direito do mouse na tela, e escolha a opção inspecionar elemento):
• Após abrir o inspecionar, você será direcionado para uma guia:
  1. Entre na aba “Network“;
  2. “Payload“;
  3. Copie as suas propriedades de login (“Request Payload“)

Passo 4:

Após conseguir as suas propriedades, voltamos para o Postman

1. Na aba “Body” insira as informações:
   • Na linha 7 “password” insira sua senha correta (suas credenciais precisam estar corretas para gerar o token);
2. Entre na aba “raw“;
3. O código precisa estar em formato “JSON“;

Depois disso, precisamos fazer algumas alterações adicionais antes de gerar o token:

1. Na linha “response_type” altere o seu valor por “token id_token“;
2. Adicione mais uma linha com “expires_in” e insira o tempo de expiração da API em segundos;

Por fim, clique em “SEND” e envie suas informações. O token será gerado na linha “access_token”

(Valores iguais a “Resultado” são exemplos).

Reserve a informação do resultado do “acess token”, ela que iremos usar para a conexão acontecer, e vamos para o Power BI.

Como conectar uma API no Power BI?

Passo 1:

• Inicialmente, instale o Power BI no seu computador!
  – Segue o link para download: https://apps.microsoft.com/store/detail/power-bi/9NBLGGGZLXN1?hl=pt-br&gl=br&rtc=1

• Depois, faça login no aplicativo!

1° Parte

2° Parte

Passo 2:

• Clique em “Obter dados“

E em seguida pesquise por “Web“, e selecione a opção “Web”:

• Selecione a opção “Avançadas“:
  

• Em seguida adicione a URL da API (abaixo) com o “identifier” da consulta criada dentro do Análises no campo “Partes de URL“:
  • URL da API: https://common-v4-api.qualiex.com/api/common/v1/analysis/queryresult/ + identifier da sua consulta
    Exemplo: https://common-v4-api.qualiex.com/api/common/v1/analysis/queryresult/FobD4YyY

Em “Parâmetros do Cabeçalho”, insira o valor “authorization” e no campo à direita insira a informação do acess token que reservou anteriormente e a informação “Bearer“.

Ex: Seu acess token = 0123456, inserir no campo à direita = Bearer 0123456

Em seguida, clique em “Adicionar cabeçalho” e insira o valor “un-alias” e no campo à direita informe o alias da sua unidade, que reservou anteriormente.

Exemplo:

Concluindo esses passos é só clicar em “OK” para as informações da consulta escolhida serem disponibilizadas no Power BI de forma automatizada.

Boas Práticas para a Conexão

• Ter um usuário específico para a conexão: toda alteração feita no cadastro impactará na consulta. Sendo um usuário específico mitigamos muitos impactos, por exemplo permissões e desligamento.
• Utilizar consultas específicas para a conexão: qualquer mudança na consulta vai impactar na consulta, por exemplo filtros aplicados.
• Utilizar expiração do token para 1 ano ou mais: o exemplo de “3153600” são os segundos equivalentes a 365 dias