Documentação - Insoft Readers App

Gilberto Júnior

Guia do Usuário — Insoft Readers App

Para quem é este guia?
Este guia foi escrito para qualquer pessoa, mesmo sem experiência com tecnologia. Não é preciso saber nada de informática avançada para usar o Insoft Readers App.

1. BOAS-VINDAS

O que é o Insoft Readers App?

O Insoft Readers App é um programa para computador Windows que permite usar um leitor de cartões de proximidade (aquele aparelho que você aproxima o cartão ou crachá para fazer a leitura).

Quando você aproxima um cartão do leitor, o programa automaticamente digita o número do cartão no campo de texto que estiver aberto no seu computador — como se fosse um teclado invisível!

O que ele faz por você?

Lê cartões automaticamente — Basta aproximar o cartão do leitor
️ Digita o código por você — O número é inserido automaticamente onde você estiver digitando
Mostra quem passou — Exibe o histórico de todos os cartões lidos
️ Deixa você personalizar — É possível configurar como o código do cartão aparece

Para que serve no dia a dia?

Imagine que você usa um sistema de ponto eletrônico, controle de acesso ou cadastro de pessoas. Em vez de digitar o número do crachá manualmente, basta aproximar o crachá do leitor e o número aparece sozinho no campo correto!

2. PRIMEIROS PASSOS

Como abrir o programa

Procure o atalho "Insoft Readers App" na área de trabalho (desktop) ou no menu Iniciar do Windows
Clique duas vezes no atalho para abrir
Aguarde alguns segundos — o programa irá iniciar automaticamente

Dica: Na primeira vez que abrir, o programa pode demorar um pouco mais (até 10 segundos). Isso é normal! Ele está preparando tudo para funcionar.

A janela principal

Quando o programa abre, você verá uma tela escura com um menu no lado esquerdo. Essa é a tela principal, onde você pode ver tudo o que está acontecendo com seus leitores de cartão.

O ícone na barra de tarefas

Mesmo quando você minimiza ou fecha a janela, o programa continua funcionando em segundo plano. Você pode identificar isso pelo ícone do Insoft Readers que aparece na parte inferior direita da tela, na bandeja do sistema (perto do relógio do Windows).

Isso é importante! O programa precisa estar rodando para que os cartões sejam lidos. O ícone na bandeja indica que ele está ativo.

🧭 3. VISÃO GERAL DO SISTEMA

A barra lateral (menu de navegação)

No lado esquerdo da tela há um menu com 5 opções. Clique em cada uma para navegar entre as telas:

Ícone	Nome	O que você encontra lá
	Dashboard	Resumo geral: quantos leitores estão ativos, último cartão lido e status do sistema
	Readers	Gerenciar os leitores físicos: conectar, desconectar, iniciar e parar
	Card Monitoring	Ver ao vivo cada cartão que é aproximado do leitor em tempo real
	Device Logs	Histórico de atividades e possíveis mensagens de erro
️	Settings	Configurar como o número do cartão deve aparecer

A barra superior

Na parte de cima da tela você verá:

O nome da tela atual (à esquerda)
Um indicador mostrando quantos leitores estão conectados
Botões de janela (minimizar, maximizar, fechar) — no canto superior direito

Fechar a janela não encerra o programa

Quando você clica no X para fechar a janela, o programa não encerra — ele fica ativo em segundo plano, continuando a ler cartões. Para encerrar completamente, use o menu do ícone na bandeja do sistema.

️ 4. COMO USAR AS PRINCIPAIS FUNCIONALIDADES

Dashboard — Painel Inicial

O que é:

A tela inicial com um resumo de tudo. É como o "painel de controle" do sistema.

O que você encontra:

Active Readers — Quantos leitores estão conectados e funcionando
Cards Read Today — Quantos cartões foram lidos hoje
Last Card UID — O número do último cartão que foi lido
System Status — Se o sistema está funcionando ("Healthy") ou com problema ("Offline")
Tabela de leitores — Lista com o nome e status de cada leitor conectado
Ações rápidas — Botões de atalho para ir direto à monitoração ou configurações

Dica: Se o "System Status" mostrar "Offline", é sinal de que nenhum leitor está conectado. Vá para a tela Readers para conectar.

Readers — Gerenciar Leitores

O que é:

A tela onde você controla os leitores físicos de cartão. É aqui que você "liga" e "desliga" o leitor.

️ Como conectar um leitor (passo a passo):

Clique em "Readers" no menu lateral
Na caixa cinza "Leitor selecionado", clique na lista suspensa e selecione o leitor (ex: Digicon DG-710)
Clique no botão verde "Conectar"
Após conectar, clique no botão azul "Iniciar leitura"
O leitor agora está ativo! O card do leitor mostrará o status "Connected" e "Listening"

️ Como parar um leitor:

Selecione o leitor na lista
Clique em "Parar leitura" (botão roxo) para pausar sem desconectar
Ou clique em "Desconectar" (botão laranja) para desconectar completamente

️ O que significam os status do leitor:

Status	O que significa
🟢 Connected	O leitor está fisicamente conectado e reconhecido pelo programa
Disconnected	O leitor não está conectado (verifique o cabo USB)
Listening	O leitor está ativo e aguardando cartões
Stopped	O leitor está conectado, mas não está lendo cartões no momento

Dicas úteis:

Se o leitor aparecer como "Disconnected", verifique se o cabo USB está bem encaixado e clique em "Conectar" novamente
O programa tenta reconectar automaticamente a cada 1,5 segundos — às vezes, basta aguardar alguns instantes
Use o botão "Atualizar" para forçar a atualização do status

Como o cartão é lido automaticamente

O que é:

Esta é a funcionalidade principal do programa: quando você aproxima um cartão do leitor, o número do cartão é inserido automaticamente no campo de texto que está aberto.

️ Como usar no dia a dia:

Abra o programa ou sistema onde você precisa inserir o número do cartão (ex: sistema de ponto, planilha, formulário)
Clique no campo onde o número deve aparecer para ativá-lo
Minimize ou coloque a janela do Insoft Readers App em segundo plano (não precisa fechar — só não pode estar na frente)
Aproxime o cartão do leitor
O número do cartão aparecerá automaticamente no campo!

️ Atenção: Se a janela do Insoft Readers App estiver aberta na frente de outras janelas, o número não será colado no campo externo — em vez disso, uma notificação aparecerá dentro do programa. Minimize a janela para usar o auto-paste.

Dica sobre "Nova Linha":

Nas configurações, você pode ativar a opção "Append New Line". Com ela ativada, após inserir o número do cartão, o programa também pressiona a tecla Enter automaticamente. Muito útil em cadastros onde você precisa confirmar depois de cada leitura!

Card Monitoring — Monitoração ao Vivo

O que é:

Uma tela que mostra em tempo real cada cartão que é lido, como um "feed" ao vivo de leituras.

️ Como usar:

Clique em "Card Monitoring" no menu lateral
A tela mostrará automaticamente cada novo cartão lido
No topo, você vê estatísticas rápidas:
- Total Reads — Total de leituras feitas nesta sessão
- Unique Cards — Quantos cartões diferentes foram lidos
- Active Readers — Quantos leitores estão ativos
Na lista abaixo, cada linha representa uma leitura com: número do cartão, nome do leitor e horário

Dica:

Esta tela é excelente para verificar se o leitor está funcionando: aproxime um cartão de teste e veja se o número aparece na lista!

Device Logs — Histórico de Atividades

O que é:

Um registro de tudo que aconteceu: leituras de cartão, conexões e possíveis erros. Útil para verificar o histórico ou investigar um problema.

️ Como usar:

Clique em "Device Logs" no menu lateral
Você verá uma lista de registros com cores diferentes:
- 🟢 Verde — Tudo certo (leitor conectado, leitura bem-sucedida)
- 🟡 Amarelo — Aviso (leitor desconectado)
- Vermelho — Erro (algo deu errado)
- Azul — Informação (cartão detectado)
Use a barra de pesquisa para filtrar por texto específico
Use os botões de filtro (All, Info, Warning, Error, Success) para ver apenas um tipo de registro

Dica para suporte:

Se precisar acionar o suporte técnico, acesse esta tela primeiro e note quais mensagens de erro aparecem em vermelho — isso ajuda a diagnosticar o problema mais rapidamente.

Settings — Configurações

O que é:

A tela onde você personaliza como o sistema funciona: como o número do cartão aparece, com que frequência o leitor verifica se há cartões, etc.

️ Como acessar as configurações:

Clique em "Settings" no menu lateral
Você verá o formulário "Reader Configuration"

️ O que cada configuração faz:

Configuração	Para que serve	Exemplo
Prefix (Prefixo)	Texto adicionado antes do número do cartão	Colocar `"ID:"` → resultado: `"ID:12345678"`
Suffix (Sufixo)	Texto adicionado depois do número do cartão	Colocar `"-A"` → resultado: `"12345678-A"`
Interval (ms)	Com que frequência o leitor verifica cartões (em milissegundos)	`350` = verifica a cada 0,35 segundos
Append New Line	Se ativado, pressiona Enter automaticamente após ler o cartão	Útil em formulários
Continuous Read	Se ativado, continua lendo enquanto o cartão estiver próximo	Cuidado: pode gerar leituras duplicadas

️ Como salvar as configurações (passo a passo):

Clique em "Settings" no menu lateral
Altere os campos desejados
Clique no botão "Save" (Salvar)
Uma mensagem verde confirma: "Configurações aplicadas em tempo de execução."
As mudanças entram em vigor imediatamente, sem precisar reiniciar o programa!

Dicas sobre as configurações:

Se o número do cartão precisa aparecer exatamente como está no seu sistema, deixe Prefix e Suffix em branco
Para a maioria dos casos, o Interval de 350ms a 1000ms funciona bem
Se o cartão está sendo lido mais de uma vez ao aproximar, desative o Continuous Read
Se usar o Append New Line, o Enter será pressionado após cada leitura — ideal para formulários que avançam automaticamente

Ícone na Bandeja do Sistema (System Tray)

O que é:

O pequeno ícone do programa que fica no canto inferior direito da tela do Windows, perto do relógio. Ele permite controlar o programa sem precisar abrir a janela.

️ Como usar:

Procure o ícone do Insoft Readers na bandeja do sistema (canto inferior direito da tela)
Clique com o botão direito sobre o ícone para ver o menu:
- Abrir interface — Abre a janela principal do programa
- Reconectar leitores — Reconecta todos os leitores de uma vez (útil quando o leitor para de funcionar)
- Sair — Encerra o programa completamente
Clique duas vezes no ícone para abrir a janela principal rapidamente

Notificações

O que é:

Pequenos avisos que aparecem na tela para informar sobre leituras de cartão e outras atividades.

Como as notificações aparecem:

Quando a janela do programa está minimizada ou em segundo plano e um cartão é lido, um pequeno aviso aparece no canto da tela com o número do cartão
As notificações desaparecem automaticamente após alguns segundos
Elas são apenas informativas — o cartão já foi processado quando a notificação aparece

5. FLUXOS COMUNS DO DIA A DIA

Fluxo 1: Iniciar o trabalho do dia

Objetivo: Deixar o sistema pronto para ler cartões.

️ Passo a passo:

Abra o Insoft Readers App (atalho na área de trabalho)
Aguarde a tela inicial carregar (alguns segundos)
Clique em "Readers" no menu lateral
Verifique se o leitor aparece com status "Connected" e "Listening"
Se não estiver conectado: selecione o leitor na lista e clique em "Conectar", depois "Iniciar leitura"
Pronto! O sistema está funcionando

O programa tenta conectar os leitores automaticamente. Na maioria dos dias, você apenas abre o programa e ele já estará funcionando.

Fluxo 2: Registrar um cartão em outro sistema

Objetivo: Inserir o número de um cartão em um campo de texto de qualquer programa (sistema de ponto, formulário, planilha, etc.).

️ Passo a passo:

Abra o programa onde precisa inserir o número do cartão
Clique no campo de texto onde o número deve ser inserido
Certifique-se de que a janela do Insoft Readers App está minimizada ou em segundo plano
Aproxime o cartão do leitor
O número do cartão aparecerá automaticamente no campo!

Por que minimizar? Quando a janela do Insoft Readers App está na frente, o número vai para dentro do programa (como um aviso na tela). Minimizando, o número vai direto para o campo do outro sistema que você está usando.

Fluxo 3: Verificar se um cartão está sendo lido corretamente

Objetivo: Testar se o leitor está funcionando e se o número do cartão está correto.

️ Passo a passo:

Clique em "Card Monitoring" no menu lateral
Aproxime o cartão do leitor
O número do cartão deve aparecer instantaneamente na lista da tela
Verifique se o número está correto
Se o número tiver um prefixo ou sufixo indesejado (ex: "ID:12345678"), acesse "Settings" e limpe os campos Prefix e Suffix

Fluxo 4: Reconectar um leitor que parou de funcionar

Objetivo: Reativar um leitor que deixou de responder.

️ Passo a passo — Opção 1 (pela janela):

Clique em "Readers" no menu lateral
Selecione o leitor com problema na lista
Clique em "Desconectar"
Aguarde 2 segundos
Clique em "Conectar"
Clique em "Iniciar leitura"

️ Passo a passo — Opção 2 (pelo ícone da bandeja):

Clique com o botão direito no ícone do programa na bandeja do sistema
Clique em "Reconectar leitores"
Aguarde alguns segundos
Verifique se o status voltou para "Connected" e "Listening"

Se nenhuma das opções funcionar, verifique se o cabo USB do leitor está bem conectado ao computador. Tente desconectar e reconectar o cabo.

Fluxo 5: Configurar prefixo ou sufixo no número do cartão

Objetivo: Fazer o número do cartão aparecer com algum texto antes ou depois (por exemplo, seu sistema pode exigir que o número venha acompanhado de um código específico).

️ Passo a passo:

Clique em "Settings" no menu lateral
No campo "Prefix", digite o texto que deve aparecer antes do número (deixe em branco se não precisar)
No campo "Suffix", digite o texto que deve aparecer depois do número (deixe em branco se não precisar)
Clique em "Save"
Teste aproximando um cartão — o número deve aparecer com o prefixo/sufixo configurado

Exemplo:

Prefix: FUNC- e Suffix: (vazio) → cartão 12345678 aparece como FUNC-12345678
Prefix: (vazio) e Suffix: -RH → cartão 12345678 aparece como 12345678-RH

Fluxo 6: Encerrar o programa ao final do dia

Objetivo: Fechar completamente o programa.

️ Passo a passo:

Clique com o botão direito no ícone do programa na bandeja do sistema
Clique em "Sair"
O programa será encerrado completamente

️ Atenção: Clicar no X da janela não encerra o programa — ele continua rodando em segundo plano. Para encerrar de verdade, use sempre o menu da bandeja.

️ 6. ERROS COMUNS E COMO RESOLVER

O programa abriu mas o leitor não aparece ou está "Disconnected"

Possível causa:
O leitor de cartão pode não estar conectado corretamente ao computador, ou o programa está inicializando.

Como resolver:

Verifique se o cabo USB do leitor está bem encaixado na porta do computador
Tente desconectar e reconectar o cabo USB
Aguarde 5 segundos e clique em "Atualizar" na tela Readers
Se ainda não aparecer: clique com o botão direito no ícone da bandeja e escolha "Reconectar leitores"

Aproximei o cartão mas nada aconteceu

Possíveis causas:

O leitor não está em modo "Listening"
A janela do Insoft Readers está na frente (o número foi para dentro do programa, não para o campo externo)
O leitor se desconectou

Como resolver:

Acesse "Readers" e confirme que o status está como "Listening"
Se não estiver: clique em "Iniciar leitura"
Verifique se a janela do Insoft Readers está minimizada quando tentar ler o cartão
Teste na tela "Card Monitoring" para verificar se o leitor está respondendo

O número do cartão está aparecendo com letras ou caracteres extras

Possível causa:
Existe um prefixo ou sufixo configurado nas Settings.

Como resolver:

Acesse "Settings" no menu lateral
Verifique os campos Prefix e Suffix
Apague o conteúdo desses campos se não precisar deles
Clique em "Save"
Teste novamente

O mesmo cartão está sendo lido várias vezes quando eu o aproximo

Possível causa:
A opção "Continuous Read" está ativada, fazendo o sistema ler repetidamente enquanto o cartão está próximo.

Como resolver:

Acesse "Settings"
Desative a opção "Continuous Read" (deixe sem marcação)
Clique em "Save"

O número do cartão aparece no programa mas não é colado no meu sistema

Possível causa:
A janela do Insoft Readers App está aberta na frente das outras janelas. Quando isso acontece, o número vai para dentro do programa (como um aviso), não para o campo externo.

Como resolver:

Minimize a janela do Insoft Readers App antes de aproximar o cartão
Ou clique em outra janela para colocar o Insoft Readers em segundo plano
Coloque o cursor no campo desejado no seu outro sistema
Aproxime o cartão — agora ele será colado corretamente

A janela do programa não abre ao dar dois cliques no ícone da bandeja

Possível causa:
A janela pode estar minimizada ou atrás de outras janelas.

Como resolver:

Clique com o botão direito no ícone da bandeja
Clique em "Abrir interface"
Se ainda não aparecer, verifique na barra de tarefas do Windows se o programa está listado

A tela está toda em branco ou aparece uma mensagem de erro

Possível causa:
O programa interno (que processa as leituras) pode estar demorando para iniciar.

Como resolver:

Aguarde 15 a 20 segundos e tente atualizar clicando em "Atualizar" (onde disponível)
Feche o programa completamente pelo ícone da bandeja (botão direito → "Sair")
Abra o programa novamente
Se o problema persistir, entre em contato com o suporte técnico

7. PERGUNTAS FREQUENTES (FAQ)

Preciso deixar o programa aberto o dia todo?

Sim! Para que os cartões sejam lidos automaticamente, o programa precisa estar em execução. Mas ele funciona em segundo plano (você nem precisa ver a janela aberta) — basta não encerrar pelo menu da bandeja.

O programa funciona sem internet?

Sim! O Insoft Readers App funciona completamente offline. Ele não precisa de internet para ler cartões.

Posso usar mais de um leitor ao mesmo tempo?

O programa suporta múltiplos leitores. Eles aparecerão listados na tela Readers e você poderá gerenciar cada um separadamente.

Os dados dos cartões ficam salvos em algum lugar?

O programa mantém um histórico dos últimos 50 cartões lidos na memória enquanto estiver aberto. Ao fechar o programa, esse histórico é apagado. O sistema não salva dados em banco de dados nem envia para a internet.

O que acontece se eu fechar o programa enquanto alguém está passando um cartão?

Nada de grave acontece. A leitura em andamento é simplesmente interrompida. Quando o programa for reaberto, voltará a funcionar normalmente.

Por que quando a janela está aberta na frente, o número do cartão não vai para o meu sistema?

Isso é um comportamento intencional de segurança: quando você está olhando para o programa, ele entende que você quer ver a leitura, não colar em outro sistema. Ao minimizar a janela, o programa entende que você está trabalhando em outro programa e então cola o número automaticamente lá.

O que é o Interval (ms) nas configurações?

É o tempo (em milissegundos) que o leitor aguarda entre uma verificação e outra. 1000 ms = 1 segundo. Quanto menor o número, mais rápido o leitor verifica, mas pode consumir mais processamento do computador. Para uso normal, valores entre 350 e 1000 funcionam bem.

O prefixo e o sufixo afetam apenas o que é colado no campo, ou também o que aparece no programa?

Ambos! O prefixo e o sufixo são aplicados ao número do cartão em todos os lugares: na tela de monitoração, no histórico e no que é colado no campo externo.

Posso usar o Insoft Readers App com outros programas ao mesmo tempo?

Sim! Esse é justamente o objetivo. O Insoft Readers fica em segundo plano enquanto você trabalha em qualquer outro programa. O número do cartão é colado onde seu cursor estiver.

O que fazer se o leitor não for reconhecido mesmo após reconectar o USB?

Tente reiniciar o computador
Verifique se o driver do leitor está instalado (entre em contato com o suporte técnico)
Tente usar outra porta USB do computador

🧠 8. DICAS IMPORTANTES

Boas práticas de uso

Sempre verifique o Dashboard ao iniciar o trabalho para confirmar que os leitores estão ativos
Use a tela "Card Monitoring" para testar rapidamente se o sistema está funcionando antes de começar a registrar dados
Mantenha a janela minimizada enquanto trabalha em outros sistemas para que o auto-paste funcione corretamente
Salve as configurações sempre que alterar algo em Settings — elas não são salvas automaticamente ao fechar a tela

O que evitar

Não encerre o programa pelo Gerenciador de Tarefas do Windows, a menos que necessário — use sempre o menu da bandeja (botão direito → "Sair")
Não altere as configurações de Prefix/Suffix sem checar com seu supervisor, pois isso pode afetar como os dados são registrados no sistema principal
Não deixe o cursor em campos de senha quando o programa estiver em segundo plano — o número do cartão seria colado lá!
Evite intervalos muito baixos (abaixo de 200ms) nas configurações, pois podem sobrecarregar o computador

Como usar melhor

Configure o Append New Line se o seu sistema avança automaticamente ao pressionar Enter após inserir um código — isso vai acelerar muito o trabalho
Use a tela Device Logs para ver um histórico rápido do dia — mostra horários e quais cartões passaram
O ícone da bandeja é seu melhor amigo: com um clique direito, você acessa as ações mais comuns sem nem abrir a janela principal

9. SUPORTE

Quando procurar o suporte técnico?

Entre em contato com o suporte técnico quando:

O leitor não aparece na tela mesmo após reconectar o USB e reiniciar o programa
O programa não abre ou apresenta erro ao iniciar
Os números dos cartões estão incorretos (diferente do que está impresso no crachá)
O programa trava ou fecha sozinho com frequência
A tela fica em branco e não carrega mesmo aguardando bastante tempo

Informações úteis para ter em mãos ao acionar o suporte

Antes de ligar ou enviar mensagem para o suporte, tente coletar as seguintes informações — isso vai agilizar muito o atendimento:

Qual é o problema exato? Descreva o que acontece (ex: "O leitor aparece como Disconnected mesmo com o cabo conectado")
Desde quando acontece? (hoje, desde ontem, desde a última atualização?)
Você viu alguma mensagem de erro? Se sim, anote a mensagem exata ou tire um print da tela
O que você já tentou fazer para resolver (reconectar o USB, reiniciar o programa, etc.)
Mensagens na tela "Device Logs": Acesse essa tela e informe se há alguma linha vermelha (erro)

Como acessar os logs para o suporte

Abra a janela do Insoft Readers App
Clique em "Device Logs" no menu lateral
Verifique se existem linhas em vermelho (erros)
Tire um print da tela e envie para o suporte

Este guia foi elaborado para ajudar você a usar o Insoft Readers App com tranquilidade. Se tiver dúvidas que não estão aqui, não hesite em contatar o suporte!