Trabalhando com a Biblioteca Visualizador de Documentos – suporta formatos PDF, Office e CAD com anotações integradas, busca e impressão: Um Guia Prático

A Biblioteca Visualizador de Documentos da Doconut permite renderizar arquivos PDF, Office e CAD, anotá‑los, pesquisar seu conteúdo e imprimir — tudo a partir de um único componente .NET.
Se você está construindo um portal centrado em documentos, um gerenciador de casos de legal‑tech ou uma ferramenta de revisão de desenhos de engenharia, precisa de um visualizador que funcione como seus usuários esperam: instantaneamente, com segurança e sem serviços externos. A Doconut oferece essa experiência on‑premise, dentro da sua aplicação ASP.NET ou .NET Core, mantendo o código limpo e a pegada de implantação reduzida.

Neste guia prático, percorreremos o fluxo de trabalho central da Biblioteca Visualizador de Documentos, mostraremos como incorporá‑la e demonstraremos os três pilares que a tornam indispensável — anotação, busca (incluindo OCR) e impressão controlada. Ao final, você terá um protótipo pronto para execução e uma visão clara de como a Doconut pode se tornar a espinha dorsal de qualquer solução empresarial intensiva em documentos.

Visualizador empresarial seguro exibindo arquivos PDF, Office e CAD com ferramentas de anotação e impressão

Implantação no Windows e Opções de Teste Gratuito

A biblioteca da Doconut funciona em .NET 6 e tem suporte total em ambientes Windows. Seja hospedando seu aplicativo no Azure, AWS ou on‑premise, ela oferece renderização e desempenho de anotação consistentes.

Para começar rapidamente, a Doconut oferece um teste gratuito que inclui acesso total ao motor de anotação, busca habilitada por OCR e recursos de impressão controlada. Inscreva‑se no site oficial, baixe a licença de teste e siga os passos de integração abaixo para ver a biblioteca em ação em poucos minutos.

Por que a Biblioteca Visualizador de Documentos é um Diferencial para Empresas .NET

Empresas que gerenciam contratos, esquemas de engenharia ou registros de funcionários enfrentam três desafios recorrentes:

Diversidade de formatos – PDFs, documentos Word, planilhas Excel e desenhos CAD coexistem no mesmo repositório.
Revisão colaborativa – Usuários de negócios precisam destacar, comentar ou carimbar um documento sem sair da aplicação.
Acesso regulado – A impressão deve ser auditável e o texto pesquisável deve estar disponível mesmo para imagens escaneadas.

A Biblioteca Visualizador de Documentos da Doconut resolve os três com um único componente .NET server‑side que suporta mais de 33 tipos de arquivo — incluindo DOCX, XLSX, PPTX, DWG e DXF — pronto para uso. A biblioteca renderiza cada formato nativamente, eliminando a necessidade de Microsoft Office, Acrobat ou serviços externos de conversão. Como a renderização ocorre no servidor, você mantém os dados sensíveis atrás do seu firewall, essencial para setores de saúde, jurídico e financeiro.

O motor de anotação integrado permite adicionar realces, desenhos à mão livre ou aprovações carimbadas diretamente na tela do visualizador. As anotações são armazenadas como XML leve, facilitando a persistência em banco de dados ou sistema de controle de versão. O plugin de busca fornece pesquisa de texto instantânea em qualquer documento aberto; quando a origem é uma imagem escaneada, o motor OCR extrai strings pesquisáveis em tempo real. Por fim, o recurso de impressão controlada permite impor limites de intervalo de páginas, marcas d’água ou logs de auditoria de impressão, tudo através de uma única chamada de API.

Juntas, essas capacidades permitem substituir uma pilha confusa de visualizadores de terceiros, plugins JavaScript e serviços externos de conversão por uma única biblioteca mantível que escala de poucos usuários a implantações corporativas.

Incorporando o Visualizador: Integração Passo a Passo no ASP.NET Core

A seguir, uma descrição concisa dos passos necessários para integrar a Biblioteca Visualizador de Documentos da Doconut em uma aplicação ASP.NET Core:

Registrar o middleware Doconut – configure o middleware UseDoconut para tratar o endpoint interno de tiles de imagem (DocImage.axd). Esse endpoint transmite páginas renderizadas como tiles PNG, mantendo a UI responsiva mesmo para arquivos CAD grandes.
Carregar a licença – forneça o arquivo de licença da Doconut (por exemplo, DoconutLicense.xml) como um arquivo no disco ou como um stream. A biblioteca lê a licença automaticamente na criação da primeira instância do visualizador.
Criar uma instância do visualizador – instancie a classe Viewer, passando os serviços necessários, como cache distribuído ou acessador de contexto HTTP.
Configurar opções de renderização – configure um objeto de configuração (por exemplo, PdfConfig) para controlar o comportamento padrão de renderização, extração de hyperlinks e resolução raster para desenhos CAD.
Abrir um documento – chame o método OpenDocument com o caminho do arquivo (ou stream) e a configuração definida anteriormente. O método devolve um token seguro que o front‑end JavaScript usa para solicitar imagens de página, anotações e resultados de busca.

Esses passos resultam em um visualizador server‑side para ambientes Windows executando .NET 6. A abordagem baseada em token mantém o cliente leve: o front‑end só precisa referenciar o componente visualizador da Doconut hospedado em https://doconut.app.

Anotações Integradas para Fluxos de Trabalho de Revisão em Tempo Real

As anotações transformam um visualizador passivo em um espaço colaborativo. O gerenciador de anotações da Doconut opera por página e armazena tudo como XML, permitindo versionar, auditar ou mesclar alterações em um banco de dados.

Fluxo típico de anotação

Recupere o gerenciador de anotações da página atual chamando o método GetAnnotationManager do visualizador, fornecendo as dimensões da página.
Crie um objeto de anotação (por exemplo, um carimbo de imagem, realce ou desenho à mão livre) e defina sua posição, tamanho e propriedades visuais.
Adicione a anotação ao gerenciador.
Persista o XML da anotação usando GetAnnotationXml e armazene-o em seu repositório de dados.
Quando o documento for reaberto, carregue o XML salvo de volta ao visualizador com LoadAnnotationXML.

Cenários corporativos

Legal Tech – Advogados inserem um carimbo “Assinatura” em um contrato e enviam o XML para um serviço de gerenciamento de casos para auditoria.
Revisão de Engenharia – Designers adicionam desenhos de linha vermelha diretamente em uma página DWG; o XML da anotação é armazenado junto ao histórico de revisões.
RH & Recrutamento – Recrutadores destacam seções chave de um currículo, adicionam comentários e enviam a versão anotada ao perfil do candidato.

Como os dados de anotação permanecem no servidor, você mantém controle total sobre quem pode editar, visualizar ou imprimir. A API foi projetada para ser enxuta: basta recuperar o gerenciador, adicionar e carregar anotações, podendo construir recursos UI adicionais (desfazer/refazer, ferramentas customizadas) sem depender de dependências extras.

Busca Instantânea e OCR: Tornando Cada Documento Encontrável

Um repositório de documentos só tem valor quando os usuários conseguem localizar a informação necessária em segundos. O plugin de busca da Doconut oferece busca full‑text instantânea em qualquer arquivo aberto. Para PDFs rasterizados ou desenhos CAD escaneados, o motor OCR interno extrai texto sob demanda, transformando imagens em conteúdo pesquisável sem uma etapa de pré‑processamento separada.

Fluxo típico de busca

Chame o método de busca do visualizador (exposto pelo Search Plugin) com a palavra‑chave desejada.
Receba uma lista de números de página correspondentes e as coordenadas de cada ocorrência.
Para cada ocorrência, obtenha o gerenciador de anotações da página e adicione uma anotação de realce temporária para mostrar ao usuário onde o termo aparece.

Quando um usuário abre um PDF escaneado de uma nota fiscal, o visualizador executa OCR automaticamente em cada página ao renderizá‑la. O texto extraído é indexado em memória, tornando buscas subsequentes instantâneas. Essa abordagem elimina a necessidade de um serviço OCR externo, reduz a latência e garante que o texto pesquisável nunca saia do seu ambiente seguro.

Benefícios corporativos

Portais de clientes podem exibir cláusulas relevantes de um contrato com um único toque.
Ferramentas de relatório financeiro permitem que analistas localizem um item de linha em dezenas de declarações escaneadas.
Sistemas de registros de saúde tornam pesquisáveis nomes de medicamentos dentro de notas médicas escaneadas, melhorando a segurança do paciente.

Tudo isso é alcançado sem dependências de terceiros, mantendo a pilha leve e a superfície de conformidade reduzida.

Impressão Controlada a Partir do Visualizador – Segurança com Conveniência

A impressão costuma ser o elo mais fraco na segurança de documentos. O recurso de impressão controlada da Doconut dá a você a autoridade para decidir o que, quando e como um documento pode ser impresso, mantendo ainda o familiar diálogo de impressão do navegador.

Fluxo típico de impressão

Defina um objeto PrintConfig que especifique opções como limites de intervalo de páginas, marcas d’água e se cada solicitação de impressão deve ser registrada.
Passe a configuração junto com o token do documento ao método Print do visualizador.
O visualizador renderiza as páginas selecionadas no servidor, aplica as marcas d’água e transmite o PDF imprimível de volta ao navegador do cliente.
Uma entrada de auditoria é criada automaticamente, permitindo que administradores rastreiem quem imprimiu o quê e quando.

Ao tratar a impressão no servidor, a Doconut garante que o documento original nunca saia do seu ambiente protegido e que você mantenha total visibilidade sobre a atividade de impressão — requisito crítico para indústrias reguladas.

Conclusão

A Biblioteca Visualizador de Documentos da Doconut oferece às equipes .NET um único componente seguro e rico em recursos para renderizar PDFs, arquivos Office e desenhos CAD, enriquecendo‑os com anotações, busca habilitada por OCR e impressão controlada. Com processamento server‑side, conversão integrada e suporte a mais de 33 formatos de arquivo, você pode eliminar dependências caras de terceiros e manter dados sensíveis sob seu controle direto.

Pronto para modernizar seu fluxo de trabalho documental empresarial? Comece seu teste gratuito da Doconut hoje, baixe a biblioteca e siga os passos de integração descritos acima para trazer poderosas capacidades de visualização, anotação e busca ao seu aplicativo .NET em minutos.