Přidání prohlížení dokumentů do podnikové aplikace zahrnuje víc než jen vložení PDF do iframe. Soubory Office, výkresy CAD, e‑mailové soubory a obrázky vyžadují různé možnosti vykreslování, přičemž aplikace stále potřebuje řídit autentizaci, úložiště, autorizaci a uchovávání dat.
Doconut je .NET SDK pro prohlížeč dokumentů navržené k vložení vykreslování a interakce s dokumenty do webových aplikací. Místo prezentace neověřeného receptu se zdrojovým kódem tento návod vysvětluje rozhodnutí o integraci, která by měl váš tým učinit, a identifikuje standardní .NET komponenty, které SDK běžně obklopují.
Proč je vložený prohlížeč odlišný od stažení souboru
Stahovací koncový bod přenáší původní soubor a nechává prohlížení na softwaru mimo vaši aplikaci. Vložený prohlížeč udržuje uživatele uvnitř vašeho produktu a může poskytovat konzistentní místo pro navigaci, vyhledávání, revizi a další povolené funkce.
Vytvořit vrstvu vykreslování sami je obtížné, protože každý formát má svá vlastní pravidla:
- PDF soubory mohou obsahovat vložená písma, anotace, formuláře a velmi velké sady stránek.
- Word, Excel a PowerPoint soubory vyžadují pečlivé rozvržení a správu písem.
- CAD výkresy potřebují přesné měřítko, vrstvy a detailní přiblížení.
- E‑mailové a obrazové formáty zavádějí přílohy, metadata, barvy a otázky rozlišení.
Vyhrazené SDK umožňuje týmu aplikace soustředit se na řízení přístupu, pracovní postupy a uživatelskou zkušenost místo údržby samostatného vykreslovače pro každý podporovaný formát.
Krok 1: Potvrďte požadované formáty a funkce
Začněte reálným inventářem souborů, které uživatelé otevírají. Oddělte nezbytné formáty od příležitostných a zaznamenejte reprezentativní vzorky pro testování.
Váš kontrolní seznam může zahrnovat:
- PDF a XPS dokumenty
- Dokumenty pro zpracování textu
- Tabulky
- Prezentace
- CAD výkresy
- E‑mailové soubory
- Běžné obrazové formáty
Poté identifikujte funkce, které jsou pro každý pracovní postup důležité. Prohlížení, fulltextové vyhledávání, anotace, tisk a konverze jsou různé schopnosti a mohou vyžadovat různé komponenty Doconut nebo licence.
Prohlédněte si aktuální rozsah produktu na ověřené stránce prohlížeče Doconut před tím, než se zavážete k formátu či funkci. Schopnosti produktu se mohou měnit, takže vaše akceptační testy by měly zůstat konečnou autoritou pro dokumenty, které vaši zákazníci skutečně používají.
Krok 2: Vyberte, kde dokumenty vstupují do aplikace
ASP.NET aplikace může přijímat dokumenty z několika řízených zdrojů:
- Nahrání zpracované jako ASP.NET Core
IFormFile - Ochráněné úložiště souborů
- Databáze nebo úložiště pro správu dokumentů
- Objektové úložiště přístupné serveru
- Interní služba, která vrací
Stream
Pracovní postup prohlížení by měl používat serverově autorizovaný odkaz na dokument. Neukládejte přihlašovací údaje k úložišti, neomezené cesty k souborům ani trvalé veřejné URL do klientského markupu.
Pokud uživatelé nahrávají soubory, validujte je před vykreslením. Ověřte velikost souboru, příponu, podpis souboru a jakákoliv obchodně specifická omezení. Ukládejte serverově vygenerovaný identifikátor místo toho, abyste důvěřovali původnímu názvu souboru jako cestě.
Krok 3: Definujte autentizaci a autorizaci
Aplikace – nikoli UI prohlížeče – by měla rozhodovat, kdo smí dokument otevřít.
V ASP.NET Core lze použít standardní mechanismy, jako je autentizační middleware, atribut [Authorize], zásady, nároky a autorizace založená na zdrojích, k ochraně koncového bodu, který spouští relaci prohlížení. Rozhodnutí o autorizaci by mělo zahrnovat jak aktuálního uživatele, tak požadovaný dokument.
Bezpečný tok požadavku vypadá takto:
- Uživatel požaduje dokument pomocí aplikačního identifikátoru.
- Server autentizuje uživatele.
- Server ověří, že uživatel může přistupovat k tomuto konkrétnímu dokumentu.
- Server vyřeší chráněnou lokaci úložiště.
- Prohlížeč obdrží pouze informace potřebné pro tuto autorizovanou relaci.
Nikdy nepředpokládejte, že skrytí tlačítka v panelu nástrojů je kontrolou autorizace. Kontroly přístupu na straně serveru zůstávají nezbytné i v případě, že ovládací prvky pro stažení nebo tisk nejsou zobrazeny.
Krok 4: Přidejte Doconut pomocí oficiálních integračních zdrojů
Použijte aktuální balíček a instalační instrukce dodané Doconut. Ověřená stránka ke stažení Doconut poskytuje přístup k NuGet integračním zdrojům, dokumentaci, příkladům a demům.
Přesné nastavení může záviset na:
- Typu vaší ASP.NET nebo .NET aplikace
- Vybraném Doconut produktu a pluginech
- Verzi Doconut
- Vaší licenci
- Formátech dokumentů a funkcích, které povolíte
- Konfiguraci vašeho Windows serveru
Postupujte podle dokumentace, která odpovídá nainstalované verzi. Vyhněte se kopírování inicializačních úryvků z nesouvisejících blogových příspěvků, protože jmenné prostory, konfigurace, cesty k assetům a API se mohou mezi verzemi měnit.
Krok 5: Vytvořte dedikovanou hranici pro prohlížení
Uchovávejte prohlížení dokumentů za malou aplikační službou místo volání SDK funkcionality napříč controllery a UI komponentami.
Tato služba může být zodpovědná za:
- Vyřešení autorizovaného identifikátoru dokumentu
- Otevření dokumentu jako kontrolovaného
Stream, pokud je to vhodné - Poskytnutí požadované konfigurace prohlížení
- Uvolnění souborových a streamových zdrojů
- Překlad technických selhání na bezpečné aplikační chyby
- Zaznamenání provozních metrik bez logování obsahu dokumentu
Tato hranice usnadňuje aktualizace a snižuje riziko odhalení detailů úložiště prezentační vrstvě. Také poskytuje testům jasné místo, kde lze nahradit bezpečnou implementaci.
Krok 6: Navrhněte stránku prohlížeče
Prohlížeč by měl mít dostatek prostoru, aby byl užitečný. Úzká karta obklopená nesouvisejícími ovládacími prvky ztěžuje kontrolu velkých tabulek a CAD výkresů.
Plánujte stránku kolem:
- Stabilní výšky prohlížeče
- Jasných stavů načítání, prázdného obsahu a chyb
- Stručného názvu dokumentu
- Ovládacích prvků přístupných klávesnicí
- Rozvržení, které neukrývá důležité ovládací prvky prohlížeče
- Výslovného způsobu návratu do nadřazeného pracovního postupu
Testujte s dlouhými názvy souborů, velkým počtem stránek, širokými tabulkami, detailními výkresy a dokumenty, které se nepodaří vykreslit. Stav chyby by neměl odhalovat cesty na serveru, výpisy výjimek ani URL úložiště.
Krok 7: Spravujte soubory a dočasná data
Definujte politiku uchovávání před nasazením. Zvažte původní soubor, dočasná vykreslovací data, cache, exporty, anotace a logy odděleně.
Užitečná opatření zahrnují:
- Vyhrazený dočasný adresář s omezenými oprávněními
- Jedinečné názvy generované serverem
- Úklid po úspěšných i neúspěšných relacích
- Plánovaný proces pro opuštěné dočasné soubory
- Kvóty úložiště a monitorování
- Šifrování v klidu, pokud to vyžaduje vaše bezpečnostní politika
Udělejte úklid pozorovatelným. Pokud mazání selže tiše, dočasné soubory se mohou hromadit a představovat jak provozní, tak bezpečnostní problém.
Krok 8: Nakonfigurujte produkční ochrany
Vykreslování dokumentů může spotřebovávat CPU, paměť a dočasný diskový prostor. Chraňte aplikaci explicitními limity:
- Maximální velikost nahrávaného souboru
- Maximální počet souběžných vykreslovacích úloh
- Časové limity požadavků a zpracování
- Limity front, pokud se vykreslování provádí asynchronně
- Kvóty dočasného úložiště
- Kontroly zdraví a strukturované monitorování chyb
U velkých nebo nepředvídatelných zátěží oddělte vykreslování od latencí‑citlivých aplikačních procesů. Měřte s dokumenty podobnými těmi, které používají vaši zákazníci, místo spoléhaní se jen na malé testovací soubory.
Krok 9: Otestujte kompletní pracovní postup
Úspěšný integrační test by měl pokrýt více než „objevil se první stránka“.
Testujte:
- Každý požadovaný formát souboru
- Malé, velké, více‑stránkové i poškozené soubory
- Dokumenty s neobvyklými písmy
- Souborové heslo‑chráněné soubory, pokud váš pracovní postup podporuje
- Autorizované i neautorizované uživatele
- Současné relace prohlížení
- Restartování aplikace a přerušené požadavky
- Úklid po úspěchu i po selhání
- Funkce prohlížeče zahrnuté ve vaší vybrané konfiguraci produktu
Uchovávejte verzovanou kolekci očištěných testovacích dokumentů. Opakujte ji při aktualizaci Doconut, .NET, Windows Server, úložiště nebo souvisejících závislostí.
Bezpečnostní kontrolní seznam
Před vydáním ověřte, že:
- Každý požadavek na prohlížení vyžaduje autentizaci, kde je to vhodné.
- Autorizace je kontrolována pro konkrétní dokument.
- Vstup od uživatele se nemůže stát neomezenou cestou k souboru na serveru.
- Přihlašovací údaje k úložišti nikdy nedojdou ke klientovi.
- Limity nahrávání a validace jsou povoleny.
- Dočasné soubory mají omezený přístup a otestovanou politiku úklidu.
- Logy neobsahují obsah dokumentů, tajné klíče ani citlivé URL.
- Chybové zprávy zobrazované uživatelům jsou očištěné.
- SDK a aplikační závislosti podléhají procesu aktualizací.
Ovládací prvky prohlížeče mohou podpořit váš obchodní proces, ale nemohou zabránit každému způsobu zachycení, jakmile je informace viditelná oprávněnému uživateli. Používejte je spolu s kontrolami přístupu a vhodnou politikou ochrany informací.
Kde Doconut zapadá
Doconut poskytuje schopnost prohlížení dokumentů uvnitř .NET aplikace, zatímco vaše aplikace zůstává zodpovědná za identitu, autorizaci, úložiště souborů, uchovávání, auditování a okolní pracovní postupy.
Toto rozdělení odpovědností dává .NET týmům praktickou cestu, jak podporovat obchodní dokumenty bez nutnosti budovat několik vykreslovacích enginů od nuly. Navíc udržuje podrobnosti specifické pro produkt v oficiální dokumentaci pro verzi, kterou nasazujete.
Prozkoumejte Doconut .NET SDK pro prohlížeč dokumentů a poté použijte oficiální zdroje ke stažení a dokumentaci k vyhodnocení s vašimi vlastními dokumenty.
Závěr
Spolehlivý vložený prohlížeč dokumentů začíná jasnými požadavky na formáty a bezpečným serverovým tokem dokumentů. Validujte vstupy, autorizujte každý požadavek na dokument, izolujte přístup k SDK za aplikační službou, naplánujte úklid dočasných souborů a testujte s realistickými soubory.
S těmito základy může Doconut dodat vrstvu prohlížení pro vaši Windows‑based .NET webovou aplikaci, zatímco váš tým si udrží kontrolu nad architekturou aplikace a životním cyklem dokumentů.