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, buscar 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 legal‑tech ou uma ferramenta de revisão de desenhos de engenharia, precisa de um visualizador que funcione como seus usuários: 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 a base de código limpa 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 sua aplicação 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ções, 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 regulamentado – 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 todos os três com um único componente .NET do lado do servidor que suporta mais de 33 tipos de arquivos — incluindo DOCX, XLSX, PPTX, DWG e DXF — pronto para uso. A biblioteca renderiza cada formato nativamente, evitando a necessidade do 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, o que é essencial para os 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 sua persistência em um 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 fonte é 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 alguns usuários até implantações em toda a empresa.

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:

Registre o middleware Doconut – configure o middleware UseDoconut para lidar com o endpoint interno de blocos de imagem (DocImage.axd). Esse endpoint transmite páginas renderizadas como blocos PNG, mantendo a UI responsiva mesmo para arquivos CAD grandes.
Carregue a licença – forneça o arquivo de licença Doconut (por exemplo, DoconutLicense.xml) como um arquivo no disco ou como um stream. A biblioteca lê a licença automaticamente durante a criação da primeira instância do visualizador.
Crie uma instância do visualizador – instancie a classe Viewer, passando quaisquer serviços necessários, como um cache distribuído ou um accessor de contexto HTTP.
Configure as 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 hiperlinks e resolução raster para desenhos CAD.
Abra um documento – chame o método OpenDocument com o caminho do arquivo (ou stream) e a configuração previamente definida. O método retorna 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 do lado do servidor 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 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 de trabalho colaborativo. O gerenciador de anotações da Doconut opera por página e armazena tudo como XML, o que significa que você pode versionar, auditar ou mesclar alterações facilmente 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, destaque 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 no visualizador com LoadAnnotationXML.

Cenários Empresariais

Legal Tech – Advogados inserem um carimbo de “Assinatura” em um contrato e, em seguida, enviam o XML para um serviço de gerenciamento de casos para auditoria.
Revisão de Engenharia – Designers adicionam desenhos de marcação (red‑line) diretamente em uma página DWG; o XML de 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 para o perfil do candidato.

Como os dados de anotação residem no servidor, você mantém controle total sobre quem pode editar, visualizar e imprimir. A API é deliberadamente enxuta: você só precisa dos métodos de recuperação do gerenciador, adição e carregamento, e pode construir recursos adicionais de UI (desfazer/refazer, ferramentas personalizadas) sem incluir dependências extras.

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

Um repositório de documentos só é valioso quando os usuários podem localizar a informação que precisam em segundos. O plugin de busca da Doconut oferece busca instantânea de texto completo em qualquer arquivo aberto. Para PDFs apenas raster ou desenhos CAD escaneados, o motor OCR integrado 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 Plugin de Busca) 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 destaque temporária para mostrar ao usuário onde o termo aparece.

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

Benefícios Empresariais

Portais de clientes podem exibir cláusulas relevantes de um contrato com um único pressionamento de tecla.
Ferramentas de relatório financeiro permitem que analistas localizem um item de linha em dezenas de extratos escaneados.
Sistemas de registro de saúde tornam‑se pesquisáveis por nomes de medicamentos em notas de médicos escaneadas, melhorando a segurança do paciente.

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

Impressão Controlada a partir do Visualizador – Segurança e Conveniência

A impressão costuma ser o elo mais fraco na segurança de documentos. O recurso de impressão controlada da Doconut lhe dá a autoridade para decidir o quê, quando e como um documento pode ser impresso, mantendo ainda um familiar diálogo de impressão baseado no 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 deve registrar cada solicitação de impressão.
Passe a configuração juntamente com o token do documento ao método Print do visualizador.
O visualizador renderiza as páginas selecionadas no servidor, aplica quaisquer 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 lidar com a impressão no servidor, a Doconut garante que o documento original nunca saia do seu ambiente protegido, e você mantém total visibilidade sobre a atividade de impressão — um requisito crítico para indústrias regulamentadas.

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 do lado do servidor, conversão integrada e suporte a mais de 33 formatos de arquivo, você pode eliminar dependências caras de terceiros e manter os dados sensíveis sob seu controle direto.

Pronto para modernizar o fluxo de trabalho de documentos da sua empresa? Inicie 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 para sua aplicação .NET em minutos.