Passo a passo
Como instalar e usar o HubCount Sync Agent
Instale o HubCount Sync Agent, entre com a conta HubCount, configure as conexões, agende cada cubo e acompanhe os envios no painel e no histórico.
Ao fim desta página o HubCount Sync Agent está instalado, entra na sua conta, tem as conexões dos cubos configuradas e atualiza cada cubo no horário que você definir, mesmo sem o HubCount BI Studio aberto. Os cubos, os campos e as consultas continuam sendo criados no HubCount BI Studio. O agente cuida de conectar, agendar e publicar.
Antes de começar
- Defina o cubo para atualizar neste computador. Na aba de sincronização do cubo, no HubCount BI Studio, a opção Atualizar automaticamente deve estar ligada e Onde sincronizar deve estar em Neste computador. O agente não executa cubos em Nuvem HubCount. Veja Neste computador ou Nuvem HubCount.
- Tenha o cubo pronto. Ele precisa ter campos mapeados e um projeto com empresas vinculadas.
- Use um computador que fique ligado e que alcance a fonte de dados, por exemplo o servidor onde está o banco.
- Tenha uma conta HubCount com acesso aos projetos.
Instalar
O agente tem instaladores para Windows (64 bits), macOS e Linux. Os passos abaixo usam o Windows.
- Peça à HubCount o instalador do HubCount Sync Agent. O arquivo para Windows tem o nome hubcount-sync-agent, a versão e a palavra windows.
- Execute o instalador. Ele instala só para o seu usuário e deixa você escolher a pasta.
- Abra o HubCount Sync Agent pelo atalho. O painel abre em uma janela própria. O ícone também aparece na bandeja do sistema, perto do relógio.
O Sync Agent e o HubCount BI Studio podem ficar instalados na mesma máquina. Cada um usa login, configurações e atualização próprios.
Entrar
- Na tela de entrada, clique em Login. O navegador abre a página de login da HubCount.
- Entre com a mesma conta que você usa no portal da HubCount.
- Volte para o agente. Ele recebe a sessão sozinho e carrega os seus projetos e cubos.
O topo do painel mostra o seu nome, o botão Sair e uma etiqueta com a quantidade de cubos ativos. Sem nenhum cubo ativo, a etiqueta mostra Aguardando configuração. A senha não fica no agente. O que fica guardado no cofre de credenciais do sistema é a sessão.
Conhecer o painel
O painel tem três abas.
| Aba | Para que serve |
|---|---|
| Sincronização | Lista os cubos de todos os seus projetos. Aqui você liga o agendamento, define a periodicidade e sincroniza na hora. |
| Conexões | Guarda as conexões deste computador, com as credenciais das fontes de dados. |
| Histórico | Mostra os envios manuais e agendados feitos por este agente. |
Configurar as conexões
Cada cubo usa uma conexão. As credenciais de uma conexão salva só neste computador ficam só nele. Um cubo cuja conexão não existe aqui aparece como Pendente.
- Na aba Sincronização, procure o cubo com a coluna Conexão em Pendente.
- Na coluna Ações, clique em Configurar. O agente abre a aba Conexões com o nome e o tipo da conexão já preenchidos.
- Preencha os dados da fonte: servidor, porta, usuário e senha, ou a URL e a autenticação, conforme o tipo.
- Salve. A conexão é criada com o mesmo identificador que o cubo espera, então o vínculo é automático.
- Na linha da conexão, clique em Testar Autenticação para conferir.
Também dá para criar a conexão antes, em Adicionar nova conexão, na aba Conexões. A tela da conexão é a mesma do HubCount BI Studio. Os tipos, o campo Armazenamento e a diferença entre Local e Nuvem estão em Fontes de dados do HubCount BI Studio.
A aba Conexões tem estes controles:
| Controle | O que faz |
|---|---|
| Adicionar nova conexão | Cria uma conexão. |
| Botão amarelo com a quantidade de perfis ausentes | Abre a janela Perfis de Conexão Ausentes, que lista os perfis que os cubos esperam e não existem aqui. Cada item tem o botão Configurar Perfil. |
| Incluir ODBC Configurações | Mostra as fontes ODBC (DSN) deste computador na escolha do banco. |
| Colunas Tipo de Conexão, Nome da conexão e URL | O tipo, o nome e o endereço da conexão. O ícone ao lado do nome mostra se ela é deste computador ou da nuvem. |
| Testar Autenticação, Editar e Excluir | Testa, edita ou exclui a conexão. O teste não existe para webhook. |
| Importar JSON | Traz conexões de um arquivo JSON, por exemplo de outro computador. |
Agendar um cubo
- Na aba Sincronização, localize o cubo. Use o filtro “Projeto ou cubo” ou ligue Mostrar apenas agendados.
- Na coluna Ações, clique em Periodicidade.
- Escolha se a frequência vale para todas as empresas do projeto (Definir uma frequência de atualização para todas as empresas do projeto) ou para cada empresa (Definir uma frequência de atualização para cada empresa do projeto).
- Defina a frequência: A cada hora, dia, semana, mês ou ano, e os horários. O intervalo mínimo é de 1 hora.
- Clique em Salvar. O agente mostra “Periodicidade salva.”.
- Ligue o interruptor da coluna Agendamento local.
O interruptor só liga quando o cubo tem periodicidade, a conexão está Configurada e há campos mapeados. Passe o mouse sobre ele para ver o que falta.
Colunas da aba Sincronização
| Coluna | O que mostra |
|---|---|
| Conexão | Configurada ou Pendente. |
| Agendamento local | O interruptor deste computador. Em cubos da nuvem, mostra a etiqueta “Nuvem HubCount” e nenhum interruptor. |
| Nome do Projeto e Nome do Cubo | O projeto e o cubo. |
| Frequência | A frequência em texto, uma linha por empresa. |
| Próxima execução (estimativa) | Uma estimativa, feita com o relógio deste computador e a frequência do cubo. |
| Ações | Configurar (só com conexão pendente), Periodicidade e Sincronizar agora. |
O agendamento de cada cubo fica só neste computador. Se você ligar o mesmo cubo em outro computador, os dois enviam. Evite isso e evite ligar o mesmo cubo no HubCount BI Studio e no agente da mesma máquina.
Sincronizar agora
Na coluna Ações, clique em Sincronizar agora. O agente busca os dados na fonte e publica na nuvem HubCount. Ao fim, mostra “Sincronização concluída com sucesso.” ou o erro. O botão fica desativado se a conexão está pendente, se o cubo não tem campos mapeados ou se já há um envio em andamento.
Acompanhar no histórico
A aba Histórico mostra os envios feitos por este agente neste computador.
| Coluna | O que mostra |
|---|---|
| Nome do Cubo | O cubo enviado. |
| Nome da Empresa | A empresa, pelo CNPJ ou pelo identificador. |
| Tipo | Manual para Sincronizar agora e Agendado para o agendamento. |
| Data/Hora | Quando o envio terminou. |
| Status | Sucesso ou Erro. |
| Detalhes | O texto do resultado. Em sucesso, “Envio concluído com sucesso.”. Em erro, a causa. O botão Ver abre o texto inteiro. |
Use Período para ver as últimas 24 horas ou os últimos 7 dias, e Somente falhas para ver só falhas. Limpar Logs apaga o histórico deste computador, depois de uma confirmação. Os envios feitos pela nuvem não aparecem aqui. Eles ficam na aba de sincronização do cubo, no HubCount BI Studio.
Deixar o agente rodando
O agendamento só roda com o agente aberto. Ele pode ficar minimizado na bandeja.
| Situação | O que acontece |
|---|---|
| Você clica no X da janela | O painel some e o agente continua na bandeja. |
| Você clica no ícone da bandeja | O painel abre. |
| Menu da bandeja | Abrir painel, Ver logs de sync (abre o histórico) e Sair. Só Sair encerra o agente. |
| O computador volta de suspensão | O agente recarrega os agendamentos. |
| O computador está desligado ou o agente fechado na hora agendada | Aquele horário não é executado, e nada o recupera depois. Vale a próxima execução do cubo. |
| Você abre o atalho de novo | Só roda uma cópia. O painel já aberto é que aparece. |
Para o agente voltar sozinho depois de reiniciar o Windows, deixe ligado o interruptor Iniciar com o Windows, no alto do painel. Se ele estiver desligado, aparece um aviso amarelo com o botão Habilitar agora. O agente abre direto na bandeja, sem mostrar o painel. Ao abrir, o agente liga essa opção sozinho se ela estiver desligada.
Os dados do agente (conexões deste computador, agendamentos e histórico) ficam na pasta do seu usuário do Windows, em %APPDATA%\HubCount Sync Agent. Em servidor, o usuário que roda o agente precisa poder gravar nessa pasta. O instalador não apaga essa pasta ao desinstalar.
Atualizar o agente
O painel do Sync Agent não tem tela de atualização. Quando a HubCount publicar uma versão nova, peça o instalador e instale por cima. As conexões e o histórico ficam, porque estão na pasta do usuário.
Exemplo: o servidor da Padaria Exemplo
A Contabilidade Exemplo cuida do BI da Padaria Exemplo. O banco do ERP da padaria só existe na rede interna dela.
- No HubCount BI Studio, o cubo “Vendas” do projeto “BI Comercial 2026” fica com Atualizar automaticamente ligado e Onde sincronizar em Neste computador.
- A Contabilidade Exemplo instala o Sync Agent no servidor da padaria e entra com a conta do escritório.
- O cubo “Vendas” aparece como Pendente. Ela clica em Configurar e cria a conexão “ERP Padaria” com o endereço do SQL Server local.
- Em Periodicidade, define “A cada dia às 06:00” para todas as empresas do projeto, e liga o interruptor Agendamento local.
- Faz o mesmo no cubo “Estoque”, com uma frequência semanal.
- Deixa Iniciar com o Windows ligado.
Na manhã seguinte, a aba Histórico mostra os envios como Agendado com Sucesso, e o dashboard da Padaria Exemplo no HubCount BI Web tem os dados do dia.
Problemas comuns
- O cubo não aparece na lista. O agente mostra os cubos dos seus projetos. Sem nenhum, ele avisa que é preciso criar cubos no HubCount BI Studio. Atualize o painel e confira o acesso ao projeto.
- O interruptor de agendamento não liga. Falta periodicidade, conexão ou campo mapeado.
- O cubo está como Nuvem HubCount. O agente não o agenda. Mude a opção no cubo.
- O horário passou e nada foi enviado. O agente estava fechado ou o computador desligado.
- Mensagens de erro. Veja Problemas de sincronização.