Monte seus próprios painéis no Power BI

O Power BI é a ferramenta de relatórios da Microsoft. O Kaam360 dá à sua organização um feed de dados próprio que o Power BI lê, para que você monte o painel que quiser com os dados de projetos, tarefas, horas, dinheiro, vendas e suporte. O feed é somente leitura: ele nunca pode alterar nada no Kaam360. Isso faz parte do pacote Business.

Como ele continua seguro

• O Power BI nunca se conecta ao banco de dados do Kaam360. Ele pede os dados ao Kaam360 por um endereço https seguro, e o Kaam360 responde apenas com os dados da sua própria organização.
• Cada chave de feed lê apenas as partes que você marcar, e pode ser revogada a qualquer momento. O Kaam360 guarda apenas uma cópia embaralhada da chave, então ninguém consegue lê-la de volta.
• Endereços de e-mail e números de telefone ficam de fora, a menos que você os permita para aquela chave.

Passo 1: crie uma chave de feed (administradores)

Quem tem a permissão "Gerenciar integrações" pode fazer isso.

1. Abra Configurações e escolha Power BI.
2. Em Criar uma chave de feed, dê um Nome à chave, por exemplo "Painel da diretoria".
3. Em O que ela pode ler, marque os dados de que o relatório precisa. Pressione Selecionar tudo para marcar tudo, ou Limpar tudo para recomeçar.
4. Marque Incluir endereços de e-mail e números de telefone só se o relatório precisar deles.
5. Pressione Criar chave de feed.
6. Pressione Copiar ao lado da nova chave e guarde-a em um lugar seguro. Ela é mostrada só uma vez. Se você a perder, crie uma nova e revogue a antiga.

Passo 2: conecte o Power BI Desktop

1. Na página Power BI, pressione Copiar ao lado do Endereço do feed. Ele se parece com https://seu-endereco-do-kaam360/odata/.
2. Abra o Power BI Desktop. Na guia Página Inicial (Home), escolha Obter dados (Get data) e depois Feed OData (OData feed). (Se não aparecer, escolha Mais... (More...), depois Outro (Other) e então Feed OData.)
3. Deixe Básico (Basic) selecionado no topo da janela, cole o endereço do feed em URL e pressione OK.
4. O Power BI pergunta como entrar. Escolha Básico (Basic) à esquerda. Digite powerbi como Nome de usuário (User name) e cole a sua chave de feed como Senha (Password). No nível ao qual aplicar essas configurações, escolha o endereço do feed. Pressione Conectar (Connect).
5. O Navegador (Navigator) lista as tabelas que a sua chave pode ler, como Projects, Tasks e Invoices. Marque as tabelas que quiser. Clique em uma tabela para ver uma prévia.
6. Pressione Carregar (Load). O Power BI lê todas as linhas. Tabelas grandes chegam em páginas de 1.000 linhas; o Power BI busca as páginas seguintes sozinho.

Passo 3: monte um relatório

1. Abra a exibição Modelo (Model). O Power BI pode já ter ligado algumas tabelas. Confira as ligações listadas em Um relatório de exemplo abaixo e arraste uma coluna sobre outra para adicionar as que faltarem.
2. Volte para a exibição Relatório (Report). Escolha um visual, por exemplo um gráfico de barras, e arraste campos para ele: por exemplo Projects › Name e Tasks › LoggedHours.
3. Use Health, Status ou CompanyId como segmentações para filtrar a página inteira.
4. Salve o arquivo.

Passo 4: publique e atualize em um horário programado

1. No Power BI Desktop, na guia Página Inicial (Home), escolha Publicar (Publish) e escolha um workspace no serviço do Power BI.
2. Abra o serviço do Power BI (app.powerbi.com), vá até o workspace e encontre o modelo semântico (semantic model, o conjunto de dados) com o nome do relatório.
3. Abra as Configurações (Settings) dele. Em Credenciais da fonte de dados (Data source credentials), escolha Editar credenciais (Edit credentials) ao lado do endereço OData.
4. Escolha Básico (Basic) como Método de autenticação (Authentication method). Digite powerbi como Nome de usuário e cole a chave de feed como Senha. Escolha um Nível de privacidade (Privacy level), por exemplo Organizacional (Organizational), e pressione Entrar (Sign in).
5. Abra Atualização agendada (Scheduled refresh), ative-a, escolha com que frequência e em quais horários, e pressione Aplicar (Apply).

Não é preciso gateway: o serviço do Power BI lê o feed diretamente pela internet.

Um relatório de exemplo

Um painel simples de projetos usa estas tabelas e ligações (cada ligação une a coluna de id à esquerda ao Id da tabela à direita):

• Tasks: ProjectId com Projects, OwnerId com Users, PhaseId com Phases.
• TimeLogs: ProjectId com Projects, TaskId com Tasks, UserId com Users.
• Projects: CustomerId com Customers, CompanyId com Companies.
• Invoices: CustomerId com Customers, ProjectId com Projects. InvoiceLines: InvoiceId com Invoices.
• Payments: ProjectId com Projects. Deals: CustomerId com Customers. Contacts: CustomerId com Customers. Tickets: CustomerId com Customers.

Bons primeiros visuais: uma tabela de Projects com Health, PercentDone, TasksOverdue e EndDate; um gráfico de barras de TimeLogs › Hours por Users › Team; um gráfico de colunas de Invoices › Total por mês de IssueDate; um funil de Deals › Amount por Stage.

Bom saber

• As datas são datas simples (por exemplo 2026-10-31). Os horários estão em UTC.
• Valores em dinheiro estão sempre ao lado da sua Currency. Faturas, orçamentos e despesas também têm ExchangeRate: quantas unidades da sua moeda principal valia uma unidade da moeda do documento na data dele. Multiplique por ela para somar valores em moedas diferentes.
• CompanyId diz a qual das suas próprias empresas um projeto ou documento pertence, se você tiver várias (veja Configurações › Empresas).
• Projects › Health é calculado exatamente como nos painéis: On track (no rumo certo), At risk (em risco), Off track (fora do rumo) ou Not planned (não planejado). Fica vazio para projetos arquivados, concluídos e cancelados.
• Todas as tabelas têm ModifiedAt. Para atualizar só as mudanças recentes em uma organização grande, configure a atualização incremental (incremental refresh) em ModifiedAt no Power BI Desktop.
• Cada chave pode fazer até 300 solicitações por minuto. Se uma atualização pedir mais, o Power BI espera e tenta de novo sozinho.
• Para mudar o que uma chave pode ler, pressione Alterar ao lado dela. A chave continua a mesma, então o Power BI continua funcionando e lê a nova escolha na próxima atualização.
• Pressione Revogar (duas vezes) para bloquear uma chave. Os relatórios que a usam param de atualizar.
• O Registro de atividades (Configurações › Registro de atividades) mostra quando cada chave foi criada, alterada e revogada, e uma linha para cada dia em que foi usada.
• Outras ferramentas de relatório que leem feeds OData, como o Excel (Dados › Obter Dados › De Outras Fontes › Do Feed OData), funcionam com o mesmo endereço e a mesma chave.

Se algo der errado

• "We couldn't authenticate with the credentials provided" (não foi possível autenticar com as credenciais fornecidas): confira se você escolheu Básico e colou a chave inteira como senha, e se a chave não foi revogada. Para digitar a chave de novo no Power BI Desktop, escolha Arquivo › Opções e configurações › Configurações da fonte de dados, escolha o endereço e pressione Editar Permissões.
• "Access to the resource is forbidden" (o acesso ao recurso é proibido): a chave não pode ler aquela tabela. Marque-a em Alterar na página Power BI.
• O Power BI não aparece em Configurações: talvez o seu pacote não o inclua (ele faz parte do Business), ou a sua função não tenha a permissão "Gerenciar integrações".