Para vincular o termo, vá primeiramente ao grid de assunto, que fica em: Catálogos/Autoridade/Assunto/Lista.
Localize o Termo que será vinculado a uma Área de Conhecimento no campo localizar, selecione-o e clique no botão alterar FAQ-BNWEB-Outros-Vinculando-Ico-Alterar.jpg.
Na tela dos dados do Termo, clique em Área do Conhecimento.
Selecione a área desejada e clique em salvar. O Termo está vinculado a Área do Conhecimento.
DEBUG – QUERY – Executáveis – Tempo de Execução
O BNWEB oferece um mecanismo de DEBUG para verificar as querys e o tempo de cada uma.
Para podermos “rastrear” quais as querys que estão sendo executadas, o procedimento é ativar o DEBUG.
No BNMARC.INI
[GERAL]
DEBUG=1
ALERTA: cuidado com esta opção, ela vai logar todas as querys executadas e o tempo de execução de cada uma em .log.
O ideal é ativar este parâmetro num momento crítico (por 1 hora) e depois desligá-lo.
Assim pode avaliar quais são as querys.
OBS.: Somente pessoas experientes devem utilizar este mecanismo.
Documentação técnica e operacional
Produto: BNWEB 2024.10 ou superior — Sistema de Gestão de Bibliotecas
Fabricante do sistema: CTY Informática
Recurso: validação biométrica de usuários (1-1)
Equipamento homologado: FingKey Hamster DX
Tecnologia de integração: SDK/API do fabricante, com comunicação entre o navegador e um componente local (que deve ser instalado localmente)
Status da documentação: 2026.10
O BNWEB oferece um recurso de biometria que permite validar a identidade de um usuário previamente identificado, utilizando sua impressão digital.
A funcionalidade é integrada às operações do sistema, permitindo que a biblioteca utilize a leitura biométrica como etapa de confirmação da identidade do usuário durante o atendimento.
A implementação atual utiliza exclusivamente o(s) leitor(es) homologado(s). Cada computador que for utilizar a biometria necessita instalar a API/SDK e registrá-la para realizar a captura e a verificação biométrica.
O BNWEB é uma aplicação web executada no navegador, enquanto a comunicação com o equipamento biométrico depende de um componente instalado ou disponibilizado no computador do operador.
A finalidade é acrescentar uma etapa de verificação da identidade do usuário ao processo de atendimento da biblioteca.
O recurso pode ser utilizado no fluxo de empréstimos.
A biometria não substitui as regras de negócio do sistema. A autorização e o registro do empréstimo continuam sujeitos às condições e permissões configuradas no BNWEB.
A implementação utiliza o método de comparação 1:1 (um para um).
Nesse método, o sistema já sabe qual usuário deseja verificar. A impressão digital apresentada é comparada com o registro biométrico previamente associado àquele usuário.
Exemplo:
Captura de impressão digital por meio do equipamento compatível.
Utilização do registro biométrico associado a um usuário previamente identificado.
Comparação biométrica 1:1.
Retorno do resultado da verificação para utilização no fluxo operacional do BNWEB.
Integração com as operações do sistema que oferecem suporte à validação biométrica.
A funcionalidade atualmente documentada não deve ser confundida com os seguintes recursos:
Identificação biométrica 1-N
Compatibilidade universal com leitores
Reconhecimento facial ou outras modalidades
FingKey Hamster DX, integrado por meio da API/SDK correspondente.
O equipamento precisa estar corretamente instalado e reconhecido pelo sistema operacional para que o componente de integração possa realizar a captura.
OBS: A utilização/homologação de outro(s) modelo(s) depende da existência de um mecanismo de integração compatível, testes específicos. Caso sua instituição necessite de outro modelo, solicite uma proposta específica.
| Item | Requisito ou condição |
| Aplicação | BNWEB acessado pelo navegador |
| Equipamento | Deve ser homologado pelo BNWEB |
| Conexão física | Porta USB funcional |
| Sistema operacional | Windows 10/11 e ser compatível com o driver e o componente biométrico instalado |
| Driver | Driver adequado ao modelo e à versão do Windows. |
| SDK/API/DLL | Componentes necessários à captura e à comparação biométrica |
| Integração local | Serviço, aplicação auxiliar ou Web API utilizada pela implementação atual |
| Navegador | Navegador compatível com a versão implantada do BNWEB e com a integração local |
| Conectividade | Acesso ao BNWEB e ao componente local, conforme a arquitetura instalada |
| Permissões | Permissão para instalar e executar o componente e acessar o equipamento |
Importante: as versões mínimas do Windows, os navegadores oficialmente suportados, as versões de driver e SDK, os requisitos de arquitetura x86/x64 e os detalhes de rede precisam ser confirmados com o pacote efetivamente distribuído pela CTY. Esta documentação inicial não estabelece versões mínimas ainda não homologadas.
A funcionalidade é utilizada por meio da aplicação web do BNWEB. O computador de trabalho e o leitor biométrico trabalham juntos.
Cada estação que utiliza a biometria precisa atender aos requisitos do equipamento e do componente local.
A configuração exata do servidor depende da infraestrutura já utilizada pela instituição e não deve ser confundida com os requisitos do leitor biométrico.
Antes da instalação, verifique:
Utilize os instaladores e as instruções fornecidos / homologadas pela CTY Informática.
Não prossiga para o diagnóstico do BNWEB enquanto o próprio leitor não estiver funcionando corretamente no computador.
OBS.: Se o seu Sistema Operacional for o Windows 11, você deve DESATIVAR o recurso “ISOLAMENTO DE NÚCLEO”,
reiniciar o computador e realizar o procedimento descrito no item 4.1.
Para localizar este recurso, basta digitar “Isolamento de núcleo” na barra pesquisa do menu Iniciar do Windows;
O componente local permite que o BNWEB, executado no navegador, solicite operações ao equipamento biométrico.
O procedimento deve seguir o pacote de instalação da versão implantada. Dependendo da implementação, pode envolver:
Instalação dos componentes do SDK/API (FingertechWEB.exe), que se localiza dentro da pasta FingertechWeb_Installer
Instalação ou configuração do serviço ou aplicativo auxiliar.
Configuração das permissões necessárias.
Inicialização do componente local.
Verificação da comunicação entre o navegador e o componente.
Teste de captura e comparação biométrica.
O nome do serviço, o endereço local da API, a porta de comunicação e os comandos de inicialização devem ser documentados a partir da implementação efetivamente utilizada.
Após a instalação:
O teste deve ser feito com dados de teste autorizados, sem utilizar cadastros de usuários reais sem a devida autorização.
A validação começa com a seleção ou identificação prévia do usuário no BNWEB.
O sistema utiliza o registro biométrico associado a esse usuário para verificar se a impressão apresentada corresponde ao cadastro.
O resultado indica se o mecanismo biométrico encontrou ou não uma correspondência de acordo com seus critérios.
A validação não pesquisa automaticamente todos os usuários da biblioteca.
Sim, é possível cadastrar todos os dedos da mão.
Não. A biometria é uma etapa de verificação da identidade do usuário.
O registro do empréstimo continua dependendo do fluxo operacional e das regras do BNWEB, incluindo as permissões e condições aplicáveis ao usuário e ao material.
Pode sim ser utilizada na devolução, mas é necessário ativar essa opção nos parâmetros gerais do empréstimo.
A implementação atual descrita neste documento utiliza comparação 1:1. Portanto, o usuário precisa estar previamente identificado para que sua digital seja comparada ao registro correspondente.
A identificação automática sem a identificação prévia do usuário não faz parte do escopo atual.
Não substitui, pois para utilizar a Biometria no BNWEB depende da identificação prévia do usuário;
Verificar:
Driver ausente ou incompatível.
Problema na porta USB ou no cabo.
Equipamento com defeito.
Componente do fabricante não instalado corretamente.
Procedimento:
Verifique a conexão USB.
Confirme se o dispositivo é reconhecido pelo sistema operacional.
Verifique o driver.
Teste o leitor com a ferramenta do fabricante.
Se persistir, registre o modelo, a versão do driver e a mensagem de erro para o suporte.
Possíveis causas:
Serviço ou aplicativo local não iniciado.
Falha de comunicação entre o navegador e o componente.
Permissões insuficientes.
Incompatibilidade entre o navegador e a integração instalada.
API / SDK / DLL ou dependência ausente.
Procedimento:
Confirme que o leitor funciona fora do BNWEB.
Verifique se o componente local está em execução.
Consulte o diagnóstico e os registros de erro disponíveis.
Verifique se o navegador apresenta mensagens de bloqueio ou falha de comunicação.
Desative as proteções do navegador / antivírus.
Acione o suporte da CTY com os dados técnicos coletados.
Possíveis causas:
Dedo diferente daquele cadastrado.
Posicionamento inadequado.
Captura de baixa qualidade.
Cadastro biométrico incorreto ou incompleto.
Procedimento:
Solicite uma nova captura, seguindo as instruções do fabricante.
Confirme que o usuário selecionado é o correto.
Verifique se o cadastro biométrico está disponível.
Se o problema persistir, encaminhe o caso ao suporte.
Refaça o cadastro somente pelo procedimento autorizado e após avaliar as consequências para o registro existente.
Verifique se houve atualização do Windows, driver, SDK, navegador ou componente local.
Registre as versões antes e depois da alteração. Não reverta nem substitua componentes indiscriminadamente em produção.
O suporte deve confirmar a compatibilidade da combinação de versões instalada.
Não. Apenas com os leitores homologados.
Outros equipamentos dependem de avaliação técnica, disponibilidade de SDK, compatibilidade de drivers e testes de integração.
Sim. A CTY pode evoluir a arquitetura para criar uma interface padronizada e adaptadores específicos por fabricante.
Essa evolução requer análise da integração atual, dos formatos biométricos e da compatibilidade dos mecanismos de comparação. Solicite uma proposta.
Anti-spam / Filtros / Anti-Vírus dificultam o recebimento de e-mails
Alguns e-mails aos usuários de provedores de internet com sistemas de filtro de mensagens, chamados de proteção anti-spam*, etc, como, por exemplo, Terra e UOL.
Os e-mails de provedores com sistema de seleção de mensagens estão sendo automaticamente eliminados / devolvidos porque as mensagens enviadas são interpretadas como spam no processo de filtragem.
Uma alternativa para solucionar o problema é a liberação de um domínio ou um e-mail específico (neste caso da contempory.com ou seu provedor de origem).
Na ferramenta e essa liberação é feita pelo próprio usuário.
Como autorizar um domínio?
O domínio de um e-mail é o que vem depois da arroba “@” (exemplo: contempory.com ou @empresa.com.br).
UOL/ TERRA / BOL / HOTMAIL, …
Todo o mecanismo de consulta depende de um processo – BNM_ROT_INVERT_GERAL – que deve estar agendado no servidor.
Para verificar se o seu BNWEB está com o mecanismo de busca correto, siga os seguintes passos:
a) entre no BNWEB coum uma matrícula que tenha direito no menu SISTEMA;
b) entre em sistema / log do invert;
c) verifique a data / hora da última execução do BNM_ROT_INVERT_GERAL e veja se o mesmo foi executado de madrugada e concluido com sucesso (sim).
Caso não tenha sido concluído com sucesso, solicite ao administrador do servidor entre no servidor e verifique:
a) Que o BNM_ROT_INVERT_GERAL esteja agendado para ser executado diariamente;
b) Que o usuário do agendamento esteja ativo e com a senha correta, e com direitos para executar o BNM_ROT_INVERT_GERAL;
c) Veja no mesmo diretório do BNM_ROT_INVERT_GERAL.EXE o arquivo de LOG AAAA_MM_DD_BNM_ROT_INVERT_GERAL.log Onde AAAA = Ano, MM = Mes, DD = Dia
Verifique o conteúdo deste arquivo para detalhamento de possíveis erros.
OBS.: Situações comuns
Após o ajuste de qualquer possível erro, entre nos agendados do Windows e de um RUN no BNM_ROT_INVERT_GERAL
“… The specified CGI application misbehaved by not returning a complete set of HTTP headers from time to time …”
Aparentemente este erro ocorre sem nenhuma explicação e ocasionalmente.
Existe um BUG confirmado pela própria Microsoft que possui a mesma msg, desta forma, solicitamos verificar e ajustar os seguintes pontos:
A) Colocar as DLLs junto ao executável e também no PATH da máquina
Dentro dos diretorios …\scripts\bnweb …\scripts\bnportal
existem algumas DLLs, por favor copie todas para c:\windows\system32
B) Aplicar o HOT-FIX da própria Microsoft
http://support.microsoft.com/default.aspx?scid=kb;EN-US;884764
C) Registrar as DLLs
Ainda como medida preventiva, pode-se registrar as DLLs
Pelo próprio windows, utilize o comando ( uma vez para cada DLL: )
D) Após os ajustes acima, o IIS deve ser reiniciado, de preferência em serviços do Windows e não no gerenciador do IIS.
Possíveis situações para o seu portal não consultar:
OBS.: Caso as duas rotinas não estejam agendadas ou não estejam sendo executadas, verifique no manual de instalação do BNWEB como proceder.
BNPortal Mobile (Dispositivos móveis)
O portal “mobile” BNPortal mobile, permite que aparelhos do tipo mobile / tablets possam utilizar o portal, realizando consultas e reservas. Este portal é um conjunto reduzido das funcionalidades do portal BNPORTAL.
Os dispositivos homologados para sua utilização são: BlackBerry, iPad, Samsung Galaxy Tab, LG Cookie, Nokia ESeries. Entretanto, diversos outros equipamentos compatíveis podem funcionar. A Contempory só prestará assistência a um equipamento homologado.
1) Criar uma Área do Conhecimento (ou usar uma que já exista)
Esta área (o nome dela) irá aparecer no portal.
No cadastro da Área, marque a opção “ÁREA DE INTERESSE” para que esta área apareça.
2) Relacionar os assuntos com a Área de Interesse
Entre no Catálogo de Assuntos, em cada Assunto e indique a Área desejada.
(Etiqueta 13 é Centralizada) 
