Práce s knihovnou Document Viewer – podpora formátů PDF, Office a CAD s vestavěnými anotacemi, vyhledáváním a tiskem: Praktický průvodce

Knihovna Document Viewer v Doconut vám umožňuje renderovat soubory PDF, Office a CAD, anotovat je, prohledávat jejich obsah a tisknout — vše z jediného .NET komponentu.
Pokud budujete portál zaměřený na dokumenty, právní‑tech správu případů nebo nástroj pro revizi technických výkresů, potřebujete prohlížeč, který funguje tak, jak vaši uživatelé očekávají: okamžitě, bezpečně a bez externích služeb. Doconut poskytuje tento zážitek on‑premise, uvnitř vaší ASP.NET nebo .NET Core aplikace, a zároveň udržuje kódovou základnu čistou a nasazovací stopu malou.

V tomto praktickém průvodci projdeme hlavní workflow knihovny Document Viewer, ukážeme vám, jak ji vložit, a představíme tři pilíře, které ji činí nepostradatelnou — anotace, vyhledávání (včetně OCR) a řízený tisk. Na konci budete mít připravený prototyp a jasnou představu o tom, jak může Doconut stát páteří jakéhokoli podnikového řešení s velkým objemem dokumentů.

Bezpečný podnikově orientovaný prohlížeč dokumentů zobrazující soubory PDF, Office a CAD s nástroji pro anotace a tisk

Nasazení na Windows a možnosti bezplatné zkušební verze

Knihovna Doconut běží na .NET 6 a je plně podporována ve Windows prostředích. Ať už hostujete svou aplikaci v Azure, AWS nebo on‑premise, poskytuje konzistentní výkon renderování a anotací.

Pro rychlý start nabízí Doconut bezplatnou zkušební verzi, která zahrnuje plný přístup k anotacím, OCR‑poháněnému vyhledávání a řízenému tisku. Zaregistrujte se na oficiálních stránkách, stáhněte si zkušební licenci a postupujte podle níže uvedených kroků integrace, abyste během několika minut viděli knihovnu v akci.

Proč je Document Viewer Library průlomová pro .NET podniky

Podniky, které spravují smlouvy, technické schémata nebo zaměstnanecké záznamy, čelí třem opakujícím se výzvám:

Rozmanitost formátů — PDF, Word dokumenty, Excel tabulky a CAD výkresy koexistují ve stejném úložišti.
Spolupráce při revizi — Obchodní uživatelé potřebují zvýraznit, okomentovat nebo otisknout dokument, aniž by opustili aplikaci.
Regulovaný přístup — Tisk musí být auditovatelný a prohledávatelný text musí být dostupný i u naskenovaných obrázků.

Doconut’s Document Viewer Library řeší všechny tři problémy jediným serverovým .NET komponentem, který podporuje více než 33 typů souborů — včetně DOCX, XLSX, PPTX, DWG a DXF — bez nutnosti Microsoft Office, Acrobat nebo externích konverzních služeb. Protože renderování probíhá na serveru, citlivá data zůstávají za vaším firewallem, což je nezbytné pro zdravotnictví, právní a finanční odvětví.

Vestavěný engine pro anotace vám umožní přidávat zvýraznění, volné kresby nebo razítka přímo do plátna prohlížeče. Anotace jsou uloženy jako lehký XML, což usnadňuje jejich perzistenci v databázi nebo systému správy verzí. Vyhledávací plugin poskytuje okamžité vyhledávání textu v jakémkoli otevřeném dokumentu; pokud je zdroj naskenovaný obrázek, OCR engine extrahuje vyhledávatelný řetězec za běhu. Nakonec funkce řízeného tisku vám dává možnost vynutit omezení rozsahu stránek, vodoznaky nebo auditní logy tisku, vše pomocí jediné API volání.

Tyto schopnosti vám umožní nahradit spletitou sadu třetích stran (prohlížeče, JavaScript pluginy, externí konverze) jedinou udržovatelnou knihovnou, která škáluje od několika uživatelů po celopodnikové nasazení.

Vkládání prohlížeče: Krok‑za‑krokem integrace v ASP.NET Core

Níže je stručný popis kroků potřebných k integraci Doconut’s Document Viewer Library do ASP.NET Core aplikace:

Zaregistrujte middleware Doconut — nakonfigurujte middleware UseDoconut, který obsluhuje interní endpoint pro obrázkové dlaždice (DocImage.axd). Tento endpoint streamuje vykreslené stránky jako PNG dlaždice a udržuje UI responzivní i u velkých CAD souborů.
Načtěte licenci — poskytněte licenční soubor Doconut (např. DoconutLicense.xml) buď jako soubor na disku, nebo jako stream. Knihovna licenci načte automaticky při vytvoření první instance prohlížeče.
Vytvořte instanci prohlížeče — instancujte třídu Viewer a předáte jí potřebné služby, jako je distribuovaná cache nebo HTTP context accessor.
Nastavte možnosti renderování — vytvořte konfigurační objekt (např. PdfConfig) pro řízení výchozího chování renderování, extrakce hyperodkazů a rozlišení rastru pro CAD výkresy.
Otevřete dokument — zavolejte metodu OpenDocument s cestou k souboru (nebo streamem) a dříve definovanou konfigurací. Metoda vrátí bezpečný token, který front‑end JavaScript použije k požadavkům na obrázky stránek, anotace a výsledky vyhledávání.

Tyto kroky vytvoří server‑side prohlížeč pro Windows prostředí běžící na .NET 6. Token‑based přístup udržuje klienta lehkým: front‑end potřebuje pouze odkaz na komponentu Doconut hostovanou na https://doconut.app.

Vestavěné anotace pro workflow v reálném čase

Anotace promění pasivní prohlížeč na kolaborativní pracovní prostor. Správce anotací Doconut funguje na úrovni jednotlivých stránek a vše ukládá jako XML, což znamená, že můžete snadno verzovat, auditovat nebo slučovat změny v databázi.

Typický workflow anotací

Získejte správce anotací pro aktuální stránku voláním metody GetAnnotationManager a předáním rozměrů stránky.
Vytvořte objekt anotace (např. razítko, zvýraznění nebo volnou kresbu) a nastavte jeho pozici, velikost a vizuální vlastnosti.
Přidejte anotaci do správce.
Uložte XML anotací pomocí GetAnnotationXml a uložte jej do úložiště.
Při opětovném otevření dokumentu načtěte uložené XML zpět do prohlížeče pomocí LoadAnnotationXML.

Podnikové scénáře

Legal Tech — právníci umístí razítko „Podpis“ na smlouvu a odešlou XML do služby správy případů k auditu.
Engineering Review — designéři přidají červené náčrty přímo na stránku DWG; XML anotací je uloženo vedle revizní historie.
HR & Recruitment — náboráři zvýrazní klíčové části životopisu, přidají komentáře a odešlou anotovanou verzi do profilu kandidáta.

Protože data anotací žijí na serveru, máte plnou kontrolu nad tím, kdo může editovat, kdo může zobrazit a kdo může tisknout. API je úmyslně úzké: potřebujete jen získání správce, přidání a načtení, a můžete na vrcholu postavit další UI funkce (undo/redo, vlastní nástroje) bez dalších závislostí.

Okamžité vyhledávání a OCR: Zajištění vyhledatelnosti každého dokumentu

Úložiště dokumentů má smysl jen tehdy, když uživatelé dokážou během sekund najít požadované informace. Doconut’s search plugin nabízí okamžité full‑textové vyhledávání v jakémkoli otevřeném souboru. Pro raster‑only PDF nebo naskenované CAD výkresy vestavěný OCR engine extrahuje text na požádání, čímž převádí obrázky na prohledávatelný obsah bez samostatného předzpracování.

Typický workflow vyhledávání

Zavolejte vyhledávací metodu prohlížeče (exponovanou Search Plugin) s požadovaným klíčovým slovem.
Získáte seznam odpovídajících čísel stránek a souřadnice každého výskytu.
Pro každý výskyt získáte správce anotací stránky a přidáte dočasnou zvýrazňovací anotaci, která uživateli ukáže, kde se termín nachází.

Když uživatel otevře naskenovaný PDF faktury, prohlížeč automaticky spustí OCR na každé stránce během renderování. Extrahovaný text je indexován v paměti, což dělá následná vyhledávání okamžitými. Tento přístup eliminuje potřebu samostatné OCR služby, snižuje latenci a zajišťuje, že prohledávatelný text nikdy neopustí vaše zabezpečené prostředí.

Podnikové výhody

Zákaznické portály mohou jedním stiskem klávesy zobrazit relevantní klauzule ze smlouvy.
Finanční nástroje umožňují analytikům najít položku napříč desítkami naskenovaných výpisů.
Zdravotnické systémy se stávají prohledávatelnými podle názvů léků v naskenovaných poznámkách lékařů, čímž zvyšují bezpečnost pacientů.

Vše je dosaženo bez jakýchkoli třetích závislostí, což udržuje stack lehký a povrch pro shodu malý.

Řízený tisk z prohlížeče – bezpečnost potkává pohodlí

Tisk je často nejslabším článkem v bezpečnosti dokumentů. Funkce řízeného tisku od Doconut vám dává pravomoc rozhodnout co, kdy a jak může být dokument vytištěn, a přitom poskytuje známý tiskový dialog v prohlížeči.

Typický workflow tisku

Definujte objekt PrintConfig s možnostmi, jako jsou omezení rozsahu stránek, vodoznaky a volba logování každého požadavku na tisk.
Předáte konfiguraci spolu s tokenem dokumentu metodě Print prohlížeče.
Prohlížeč vykreslí vybrané stránky na serveru, aplikuje vodoznaky a streamuje tisknutelný PDF zpět do prohlížeče klienta.
Automaticky se vytvoří auditní záznam, který umožňuje administrátorům sledovat, kdo co a kdy vytiskl.

Tím, že tisk probíhá na serveru, Doconut zajišťuje, že originální dokument nikdy neopustí vaše chráněné prostředí, a vy máte plnou přehlednost o tiskové aktivitě — kritický požadavek pro regulovaná odvětví.

Závěr

Doconut’s Document Viewer Library poskytuje .NET týmům jediný, bezpečný a bohatě vybavený komponent pro renderování PDF, Office souborů a CAD výkresů, obohacený o anotace, OCR‑poháněné vyhledávání a řízený tisk. Díky server‑side zpracování, vestavěné konverzi a podpoře více než 33 formátů můžete odstranit nákladné závislosti na třetích stranách a udržet citlivá data pod přímou kontrolou.

Jste připraveni modernizovat svůj podnikový workflow s dokumenty? Začněte dnes s bezplatnou zkušební verzí Doconut, stáhněte knihovnu a podle výše uvedených kroků přidejte výkonné prohlížení, anotace a vyhledávání do vaší .NET aplikace během několika minut.