gaxweb-agent: Terminais, Tarefas e Uploads
Aplica-se a: GaxWeb 5.0.0 (alpha) — update 27.08.2026
O gaxweb-agent é o programa instalado num computador seu que envia arquivos ao GaxWeb sozinho — típico de quem tem PDV ou uma pasta onde os XMLs se acumulam.
Em Aplicativos › gaxweb-agent há três telas, e elas contam a mesma história em três níveis: quem envia (Terminais), o que roda (Tarefas) e o que chegou (Uploads).
Terminais: os computadores
Cada linha é um computador com o agent instalado.
| Coluna | O que mostra |
|---|---|
| Nome / App Key | Como você chamou o terminal e a chave dele. |
| HWID | 🔑 A identificação da máquina. É o que amarra a licença àquele computador. |
| Versão | A versão do agent instalada. |
| Atividade | Quando o terminal falou com o GaxWeb pela última vez. |
| Último IP | De onde ele acessou. |
Botões: Novo terminal e o menu Terminal.
O botão direito traz ações que não existem na barra:
| Ação | O que faz |
|---|---|
| Instalador pré-configurado | 📦 Baixa o instalador já com as credenciais daquele terminal — não precisa configurar na mão. |
| Destravar HWID | 🔓 Solta a amarração com a máquina. |
| Logs | Mostra o que o agent registrou. É o primeiro lugar quando algo não funciona. |
| Hardware | Dados da máquina. |
💻 Trocou o computador? O HWID muda, e o terminal para. Use Destravar HWID para soltar a amarração e instalar na máquina nova.
📦 Instalando pela primeira vez? Use o Instalador pré-configurado: ele já vem com as credenciais e evita erro de digitação.
Tarefas: o que roda, e quando
Cada linha é uma rotina agendada num terminal.
| Coluna | O que mostra |
|---|---|
| Terminal | Em qual computador roda. |
| Tipo / Nome | O que a tarefa faz. |
| Cron | ⏰ A programação — de quanto em quanto tempo roda. |
| Última exec. | Quando rodou pela última vez. |
| Resultado | Como terminou. |
| Execs / Falhas | 📊 Quantas vezes rodou e quantas falharam. |
Botões: Nova tarefa e o menu Tarefa.
📊 A coluna Falhas é o alarme. Execuções subindo e falhas subindo junto significa tarefa quebrada — veja os Logs do terminal.
Uploads: o que chegou
Cada linha é um lote de arquivos enviado.
| Coluna | O que mostra |
|---|---|
| Terminal | Quem enviou. |
| Lote | Identificação do lote. |
| Docs | Quantos documentos vieram. |
| Tamanho | O tamanho do lote. |
| Tent. | Quantas tentativas de envio. |
| Recebido em / Processado em | Quando chegou e quando foi processado. |
| Info | 💬 A mensagem sobre o lote — onde aparece o motivo de uma falha. |
Botão direito: Baixar zip e Reprocessar.
🔁 Lote com erro? Leia a coluna Info, e use Reprocessar — não é preciso reenviar do computador.
⏱️ Recebido mas sem "Processado em"? Ainda está na fila. Ligue o Reload de 30s para acompanhar.
🔎 Nas telas de Tarefas e Uploads há um ícone a mais no topo: Filtrar pelo ID do terminal. É o atalho para ver tudo de um computador só.
A tela por partes
As telas de Administração seguem o mesmo desenho das listas de documentos, com um ícone a mais.
Os ícones do canto superior direito
| Ícone | O que faz |
|---|---|
| 📗 Exportar resultado para Excel | Baixa em Excel o que está na tela, com os filtros aplicados. |
| 🔄 Recarregar toda a tabela | Busca os dados de novo no servidor. |
| ☷ Exibir/Ocultar colunas | Escolhe quais colunas aparecem. Resolve "essa coluna sumiu". |
| 🧹 Vacuum (compactar tabela) | Compacta a tabela no banco. Só existe nas telas de Administração. |
| ☰ Mais filtros | Abre e fecha o painel Outros filtros, à direita. |
🧹 Tela bagunçada? Há também Reiniciar storage local. O GaxWeb guarda no seu navegador a largura e a ordem das colunas; se a tela ficou torta ou uma coluna sumiu e não volta, esse botão devolve o padrão. Mexe só no seu navegador, não altera dado nenhum.
Reload, Registros e páginas
No topo: Reload (Desativado · 15s · 30s · 60s) atualiza a lista sozinha, e Registros (10 · 50 · 100 · 500 · 1000) define quantas linhas por página. As páginas ficam no rodapé.
⚠️ A seleção por caixinha vale só na página aberta. Marcou itens e virou a página? A marcação anterior se perde. Aumente Registros antes de marcar.
A lista rola para o lado
As colunas passam da largura da tela. Role para a direita antes de concluir que uma informação não existe — ou esconda as colunas que não usa.
Como filtrar
1. Filtro por coluna — a caixinha abaixo do título. Nem toda coluna tem. 2. Painel "Outros filtros" — à direita, pelo ícone ☰. 3. Ordenação — clique no título da coluna.
Os três se somam.
🔍 "Sumiu da lista". O painel já vem com Situação = 1:Ativo: registros inativos ficam ocultos por padrão. Clique no X ao lado do campo Situação para ver todos. É a causa nº 1 de "meu cadastro desapareceu".
O painel tem duas seções
Repare que Situação aparece duas vezes: uma na seção do Perfil e outra na do registro que você está vendo. São filtros diferentes — o primeiro restringe pelo perfil, o segundo pelo próprio cadastro.
Abrir, editar e o histórico
Botão direito sobre a linha:
| Ação | O que faz |
|---|---|
| Editar | Abre o cadastro. |
| Alterações | 🕓 Mostra quem mudou o quê, e quando. Existe em toda a Administração e só aparece aqui. |
| Recarregar item | Atualiza só aquela linha. |
⏱️ "Quem alterou isso?" — use Alterações. É o histórico do registro, e resolve discussão sem precisar abrir chamado.
🖱️ Duplo clique não faz nada. Para abrir, use o botão direito → Editar.
Ao salvar, a janela não fecha
Ela passa a se chamar "Editando <nome> (ID nn)" e continua aberta. Se apareceu o ID no título, gravou. Pode fechar.
Roteiro: "o terminal parou de enviar"
- Terminais → a coluna Atividade é recente? Se não, o computador pode estar desligado, sem internet, ou o serviço parado.
- Status "Sem Diretório"? A pasta configurada não existe mais no computador.
- Tarefas → a coluna Falhas está subindo?
- Botão direito no terminal → Logs — a resposta costuma estar aí.
- Uploads → chegou algum lote hoje? Leia a coluna Info.