Integração de SDKs de Visualizador de Documentos com Armazenamento em Nuvem e Plataformas de Colaboração
Por que a Visualização de Documentos Nativa em Nuvem é Importante para Aplicações .NET Modernas
Consistência multiplataforma com um único núcleo .NET
As empresas estão abandonando ferramentas de documentos apenas para desktop e adotando experiências web‑first que rodam no Windows. O motor de renderização do lado do servidor da Doconut roda em .NET 6 e posteriores, garantindo a mesma saída pixel‑perfect independentemente do sistema operacional subjacente. Como o visualizador trabalha com streams, você pode obter um arquivo de qualquer bucket de nuvem, alimentá‑lo diretamente ao componente Doconut e devolver páginas renderizadas ou miniaturas ao cliente sem jamais gravar o arquivo em disco.
Reduzindo latência e largura de banda
Quando um documento está armazenado no Azure Blob Storage, baixar o arquivo completo para o cliente apenas para visualizar a primeira página gera latência desnecessária. Doconut suporta geração de miniaturas sob demanda, permitindo solicitar primeiro uma pré‑visualização de baixa resolução e buscar a renderização da página completa somente quando o usuário rolar. Esse padrão é especialmente valioso para grandes desenhos CAD (DWG, DXF) que podem ter centenas de megabytes.
Processamento com foco em segurança
Todo o processamento pesado permanece no servidor. Ao usar os recursos de processamento do lado do servidor da Doconut, você mantém PDFs confidenciais, contratos legais ou registros médicos dentro da sua VNet privada ou atrás de um firewall corporativo. Nenhum SaaS de terceiros é chamado, e o visualizador nunca transmite bytes crus para um motor no navegador—apenas blocos de imagem ou trechos HTML que você gera nos bastidores.
Conectando Doconut a Serviços Populares de Armazenamento em Nuvem
Abordagem geral de integração
- Obter o fluxo do documento – Use o SDK do provedor de nuvem escolhido (Azure Blob, Amazon S3, Google Cloud Storage) para baixar o arquivo em um objeto
Stream. - Passar o fluxo para Doconut – O visualizador Doconut aceita um stream juntamente com opções de renderização opcionais. Isso elimina a necessidade de arquivos temporários no servidor web.
- Gerar um token do visualizador – Doconut devolve um token que identifica de forma única o documento aberto para a sessão atual. O token pode ser retornado ao front‑end como JSON e usado em solicitações subsequentes de renderização de página ou anotação.
- Renderizar páginas sob demanda – O front‑end chama o endpoint Doconut com o token e o número da página desejada; Doconut devolve um fluxo de imagem ou fragmento HTML.
Como o fluxo de trabalho depende apenas de streams, trocar o código Azure por Amazon S3 ou Google Cloud Storage requer apenas uma alteração na chamada do cloud‑SDK que cria o stream; o restante do pipeline Doconut permanece idêntico.
Manipulando armazenamento multi‑tenant
Em um DMS SaaS, cada locatário pode ter um bucket ou prefixo separado. Como Doconut trabalha com streams, você pode resolver o bucket correto em tempo de execução, abrir o documento e manter o token limitado às reivindicações do usuário atual. O cache interno da Doconut (IDistributedCache) pode ser configurado para usar Redis ou Azure Cache for Redis, garantindo que solicitações repetidas da mesma página sejam atendidas da memória em vez de re‑renderizar.
Habilitando Anotação em Tempo Real e OCR em Fluxos de Trabalho Colaborativos
Plugin de Anotação: transformando um visualizador estático em um hub de revisão
Doconut vem com um Plugin de Anotação que permite que usuários realcem texto, adicionem notas adesivas ou desenhem formas à mão livre. Após abrir um documento, você obtém um gerenciador de anotações do visualizador, adiciona ou modifica objetos de anotação e persiste o estado da anotação como XML. Armazenar o XML ao lado do registro do documento habilita históricos de revisão versionados, e carregar o XML em aberturas subsequentes restaura o estado visual exato.
Busca alimentada por OCR para PDFs escaneados
Contratos, recibos ou imagens médicas escaneados frequentemente chegam como PDFs apenas de imagem. O Plugin de Busca da Doconut executa automaticamente OCR no servidor quando você o habilita na configuração do visualizador. O motor de OCR reside dentro da pilha do lado do servidor, de modo que o texto extraído nunca sai do seu ambiente protegido. Quando o OCR termina, você pode chamar a API de busca para recuperar números de página correspondentes e retângulos delimitadores, que a UI pode destacar. Como o OCR roda no servidor, você também pode indexar o texto extraído no Azure Cognitive Search, Elasticsearch ou qualquer outro serviço de busca para fornecer pesquisa full‑text instantânea em todo o repositório.
Colaboração através de tokens compartilhados
Em integrações com Teams ou SharePoint, normalmente você gera um token de curta duração que codifica o ID do documento, permissões do usuário e um timestamp. A string de token retornada pela chamada OpenDocument pode ser encapsulada em um JWT ou armazenada em uma entrada de cache. Quando outro usuário clica no link compartilhado, o mesmo token é usado para re‑hidratar o visualizador, preservando anotações e camadas de OCR para todos os envolvidos.
Conversão Segura no Lado do Servidor e Impressão Controlada com Doconut
Muitas empresas precisam converter arquivos Word, Excel ou CAD recebidos em PDF para arquivamento, ou impor uma política de “imprimir‑apenas‑se‑aprovado”. O Plugin de Conversão da Doconut trata desses cenários sem exigir Microsoft Office ou serviços de terceiros. Você invoca a API de conversão no servidor, passando o caminho do arquivo fonte (ou stream) e o formato de saída desejado. A conversão ocorre totalmente no back‑end, produzindo um PDF que pode ser armazenado no seu repositório de documentos.
Uma vez que o PDF exista, você pode habilitar Impressão Controlada diretamente na UI do visualizador. Doconut expõe um método para definir permissões de impressão para um token de documento específico. Quando o usuário clica no botão de imprimir, Doconut verifica a flag e ou renderiza um fluxo de imagem imprimível ou devolve uma mensagem amigável “impressão desativada”. Essa abordagem elimina a necessidade de JavaScript customizado para bloquear a caixa de diálogo de impressão do navegador.
Auditoria de atividade de impressão
Como a solicitação de impressão atravessa o middleware Doconut, você pode conectar ao pipeline de logging do ASP.NET Core para capturar quem imprimiu o quê e quando. Armazene a entrada de auditoria em uma tabela SQL ou encaminhe‑a para um sistema SIEM para relatórios de conformidade—crucial para soluções de tecnologia jurídica ou saúde onde cada acesso a documento deve ser rastreável.
Melhores Práticas para Escala e Desempenho em Ambientes Multiplataforma
- Aproveitar o cache distribuído – O cache interno de blocos de página da Doconut pode ser suportado por Redis, Azure Cache ou qualquer implementação
IDistributedCache. Inclua o hash da versão do documento nas chaves de cache para evitar servir imagens obsoletas após uma conversão. - Usar jobs em background para conversão em massa – Ao integrar um grande arquivo, enfileire tarefas de conversão com Hangfire ou Azure Functions. A classe do visualizador Doconut funciona com workers
IHostedServiceporque aceita streams e devolve tokens sem precisar de um contexto HTTP. - Ajustar a resolução de imagem por dispositivo – Dispositivos móveis se beneficiam de um
ImageResolutionmenor (150‑200 DPI), enquanto estações de trabalho desktop podem solicitar 300 DPI para detalhes CAD. Ajuste a resolução com base na string do user‑agent ou em uma configuração client‑side. - Habilitar carregamento preguiçoso de anotações – Armazene o XML de anotação em uma tabela separada e carregue‑o somente quando o usuário abrir o painel de anotações. Isso reduz o payload inicial e acelera a renderização da primeira página.
- Monitorar a pegada de memória – Renderizar páginas CAD em alta resolução pode consumir muita memória. Configure o GC do .NET para usar modo server em produção (
<gcServer enabled="true"/>) e defina um timeout razoável para impedir jobs de renderização descontrolados. - Aplicar CDN para assets estáticos – Os bundles JavaScript e CSS do visualizador são estáticos. Sirva‑os a partir do Azure CDN, CloudFront ou Cloudflare para reduzir milissegundos no carregamento inicial da página, especialmente para equipes distribuídas globalmente.
Seguindo essas diretrizes, você pode suportar milhares de usuários simultâneos em diferentes continentes enquanto mantém a latência abaixo de 200 ms para a primeira página—um benchmark que muitos portais corporativos almejam.
Começando Rápido com o Teste Gratuito da Doconut
A maneira mais rápida de avaliar a Doconut é baixar o teste gratuito no site oficial, adicionar o pacote NuGet a um novo projeto ASP.NET Core e seguir o guia de início rápido. Em poucos minutos você terá um visualizador funcional que pode buscar documentos no Azure Blob, habilitar anotação, executar busca baseada em OCR e realizar conversão segura no lado do servidor. Para instruções passo a passo, visite a documentação da Doconut e comece a construir sua experiência de documento nativo em nuvem hoje.
Pronto para transformar seus fluxos de trabalho de documentos? Inscreva‑se agora no teste gratuito da Doconut e veja como é fácil oferecer experiências de documentos seguras, pesquisáveis e colaborativas em qualquer aplicação .NET.