Praca z Document Viewer Library – obsługa formatów PDF, Office i CAD z wbudowanymi adnotacjami, wyszukiwaniem i drukowaniem: Praktyczny przewodnik

Biblioteka Document Viewer w Doconut pozwala renderować pliki PDF, Office i CAD, dodawać do nich adnotacje, przeszukiwać ich zawartość i drukować — wszystko z jednego komponentu .NET.
Jeśli budujesz portal skoncentrowany na dokumentach, menedżer spraw prawnych lub narzędzie do przeglądu rysunków inżynierskich, potrzebujesz przeglądarki, która działa tak, jak Twoi użytkownicy: natychmiastowo, bezpiecznie i bez zewnętrznych usług. Doconut dostarcza takie doświadczenie on‑premise, wewnątrz Twojej aplikacji ASP.NET lub .NET Core, jednocześnie utrzymując kod w czystości i minimalny rozmiar wdrożenia.

W tym praktycznym przewodniku przejdziemy przez podstawowy przepływ pracy biblioteki Document Viewer, pokażemy, jak ją osadzić, oraz zademonstrujemy trzy filary, które czynią ją nieodzowną — adnotacje, wyszukiwanie (w tym OCR) i kontrolowane drukowanie. Po zakończeniu będziesz mieć gotowy prototyp oraz klarowny obraz, jak Doconut może stać się kręgosłupem każdej przedsiębiorczej aplikacji o dużej liczbie dokumentów.

Bezpieczna przeglądarka dokumentów korporacyjnych wyświetlająca pliki PDF, Office i CAD z narzędziami adnotacji i drukowania

Wdrożenie w systemie Windows i opcje darmowego triala

Biblioteka Doconut działa na .NET 6 i jest w pełni wspierana w środowiskach Windows. Niezależnie od tego, czy hostujesz aplikację w Azure, AWS, czy on‑premise, zapewnia spójne renderowanie i wydajność adnotacji.

Aby szybko rozpocząć, Doconut oferuje darmowy trial, który zapewnia pełny dostęp do silnika adnotacji, wyszukiwania z OCR oraz funkcji kontrolowanego drukowania. Zarejestruj się na oficjalnej stronie, pobierz licencję trial i postępuj zgodnie z poniższymi krokami integracji, aby zobaczyć bibliotekę w działaniu w ciągu kilku minut.

Dlaczego Document Viewer Library jest przełomowa dla przedsiębiorstw .NET

Przedsiębiorstwa zarządzające kontraktami, schematami inżynierskimi lub dokumentacją pracowników napotykają trzy powtarzające się wyzwania:

Różnorodność formatów – PDF‑y, dokumenty Word, arkusze Excel i rysunki CAD współistnieją w tym samym repozytorium.
Współpraca przy przeglądzie – Użytkownicy biznesowi muszą podświetlać, komentować lub znakować dokument bez opuszczania aplikacji.
Regulowany dostęp – Drukowanie musi być audytowalne, a tekst przeszukiwalny nawet w zeskanowanych obrazach.

Biblioteka Document Viewer firmy Doconut rozwiązuje wszystkie trzy problemy za pomocą jednego, po stronie serwera komponentu .NET, który obsługuje ponad 33 typy plików – w tym DOCX, XLSX, PPTX, DWG i DXF – od razu po instalacji. Biblioteka renderuje każdy format natywnie, omijając potrzebę Microsoft Office, Acrobat czy zewnętrznych usług konwersji. Ponieważ renderowanie odbywa się na serwerze, wrażliwe dane pozostają za Twoim firewallem, co jest kluczowe w sektorach opieki zdrowotnej, prawnym i finansowym.

Wbudowany silnik adnotacji umożliwia dodawanie podświetleń, rysunków odręcznych lub pieczęci bezpośrednio na płótnie przeglądarki. Adnotacje są przechowywane jako lekkie XML, co ułatwia ich utrwalenie w bazie danych lub systemie kontroli wersji. Wtyczka wyszukiwania zapewnia natychmiastowe przeszukiwanie tekstu we wszystkich otwartych dokumentach; gdy źródłem jest zeskanowany obraz, silnik OCR wyodrębnia wyszukiwalne ciągi w locie. Na koniec, funkcja kontrolowanego drukowania pozwala wymusić limity zakresów stron, znaki wodne lub logi audytu drukowania, wszystko za pomocą jednego wywołania API.

Razem te możliwości pozwalają zastąpić złożony stos zewnętrznych przeglądarek, wtyczek JavaScript i usług konwersji jedną, łatwą w utrzymaniu biblioteką, skalowalną od kilku użytkowników po wdrożenia korporacyjne.

Osadzanie przeglądarki: krok po kroku integracja w ASP.NET Core

Poniżej znajduje się zwięzły opis kroków niezbędnych do integracji biblioteki Document Viewer firmy Doconut w aplikacji ASP.NET Core:

Zarejestruj middleware Doconut – skonfiguruj middleware UseDoconut, aby obsługiwał wewnętrzny endpoint obrazków (DocImage.axd). Endpoint ten strumieniuje renderowane strony jako kafelki PNG, utrzymując interfejs responsywnym nawet przy dużych plikach CAD.
Załaduj licencję – podaj plik licencji Doconut (np. DoconutLicense.xml) jako plik na dysku lub strumień. Biblioteka odczytuje licencję automatycznie przy pierwszym utworzeniu instancji przeglądarki.
Utwórz instancję przeglądarki – zainicjuj klasę Viewer, przekazując wymagane usługi, takie jak rozproszona pamięć podręczna lub dostęp do kontekstu HTTP.
Skonfiguruj opcje renderowania – przygotuj obiekt konfiguracji (np. PdfConfig), aby kontrolować domyślne zachowanie renderowania, wyodrębnianie hiperłączy i rozdzielczość rastrową dla rysunków CAD.
Otwórz dokument – wywołaj metodę OpenDocument z ścieżką pliku (lub strumieniem) oraz wcześniej zdefiniowaną konfiguracją. Metoda zwraca bezpieczny token, którego front‑end JavaScript używa do żądania obrazów stron, adnotacji i wyników wyszukiwania.

Te kroki skutkują przeglądarką po stronie serwera dla środowisk Windows działających na .NET 6. Podejście oparte na tokenie utrzymuje klienta lekki: front‑end potrzebuje jedynie odwołać się do komponentu Doconut hostowanego pod adresem https://doconut.app.

Wbudowane adnotacje dla przepływów pracy w czasie rzeczywistym

Adnotacje zamieniają pasywną przeglądarkę w współdzieloną przestrzeń roboczą. Menedżer adnotacji Doconut działa na poziomie pojedynczej strony i przechowuje wszystko jako XML, co oznacza, że możesz łatwo wersjonować, audytować lub scalać zmiany w bazie danych.

Typowy przepływ pracy z adnotacjami

Pobierz menedżera adnotacji dla bieżącej strony, wywołując metodę GetAnnotationManager przeglądarki i podając wymiary strony.
Utwórz obiekt adnotacji (np. pieczęć obrazu, podświetlenie lub rysunek odręczny) i ustaw jego pozycję, rozmiar oraz właściwości wizualne.
Dodaj adnotację do menedżera.
Zapisz XML adnotacji przy pomocy GetAnnotationXml i przechowaj go w swoim magazynie danych.
Przy ponownym otwarciu dokumentu wczytaj zapisany XML do przeglądarki metodą LoadAnnotationXML.

Scenariusze korporacyjne

Legal Tech – Prawnicy umieszczają pieczęć „Signature” na kontrakcie, a następnie przesyłają XML do usługi zarządzania sprawą w celu audytu.
Engineering Review – Projektanci dodają rysunki red‑line bezpośrednio na stronie DWG; XML adnotacji jest przechowywany razem z historią wersji.
HR & Recruitment – Rekruterzy podświetlają kluczowe fragmenty CV, dodają komentarze i przesyłają oznaczoną wersję do profilu kandydata.

Ponieważ dane adnotacji znajdują się na serwerze, zachowujesz pełną kontrolę nad tym, kto może edytować, przeglądać i drukować. API jest celowo proste: potrzebujesz jedynie metod pobrania menedżera, dodania i wczytania, a dodatkowe funkcje UI (cofanie/ponawianie, własne narzędzia) możesz budować na ich bazie bez dodatkowych zależności.

Natychmiastowe wyszukiwanie i OCR: uczynienie każdego dokumentu znajdowalnym

Repozytorium dokumentów jest wartościowe tylko wtedy, gdy użytkownicy mogą w kilka sekund znaleźć potrzebne informacje. Wtyczka wyszukiwania Doconut oferuje natychmiastowe, pełnotekstowe wyszukiwanie we wszystkich otwartych plikach. Dla PDF‑ów rasterowych lub zeskanowanych rysunków CAD wbudowany silnik OCR wyodrębnia tekst na żądanie, zamieniając obrazy w treść przeszukiwaną bez osobnego etapu wstępnego przetwarzania.

Typowy przepływ pracy wyszukiwania

Wywołaj metodę wyszukiwania przeglądarki (udostępnioną przez wtyczkę Search) z żądanym słowem kluczowym.
Otrzymaj listę pasujących numerów stron oraz współrzędne każdego dopasowania.
Dla każdego dopasowania pobierz menedżera adnotacji danej strony i dodaj tymczasową adnotację podświetlenia, aby pokazać użytkownikowi, gdzie występuje termin.

Gdy użytkownik otworzy zeskanowany PDF faktury, przeglądarka automatycznie uruchamia OCR na każdej stronie w trakcie renderowania. Wyodrębniony tekst jest indeksowany w pamięci, co sprawia, że kolejne wyszukiwania są natychmiastowe. To podejście eliminuje potrzebę osobnej usługi OCR, zmniejsza opóźnienia i gwarantuje, że przeszukiwalny tekst nigdy nie opuszcza Twojego bezpiecznego środowiska.

Korzyści dla przedsiębiorstw

Portale klientów mogą w jednej chwili wyświetlić odpowiednie klauzule z umowy.
Narzędzia raportowania finansowego umożliwiają analitykom odnalezienie pozycji w dziesiątkach zeskanowanych wyciągów.
Systemy rekordów medycznych stają się przeszukiwalne pod kątem nazw leków w zeskanowanych notatkach lekarzy, zwiększając bezpieczeństwo pacjentów.

Wszystko to realizowane jest bez zewnętrznych zależności, co utrzymuje stos lekki i minimalizuje powierzchnię zgodności.

Kontrolowane drukowanie z przeglądarki – bezpieczeństwo spotyka wygodę

Drukowanie jest często najsłabszym ogniwem w bezpieczeństwie dokumentów. Funkcja kontrolowanego drukowania Doconut daje Ci możliwość decydowania co, kiedy i jak może być drukowane, jednocześnie zapewniając znajome okno dialogowe drukowania w przeglądarce.

Typowy przepływ pracy drukowania

Zdefiniuj obiekt PrintConfig, określający opcje takie jak limity zakresu stron, znaki wodne oraz czy rejestrować każde żądanie drukowania.
Przekaż konfigurację wraz z tokenem dokumentu do metody Print przeglądarki.
Przeglądarka renderuje wybrane strony na serwerze, nakłada znaki wodne i strumieniuje gotowy PDF do przeglądarki klienta.
Automatycznie tworzony jest wpis audytowy, umożliwiający administratorom śledzenie, kto co i kiedy wydrukował.

Obsługując drukowanie po stronie serwera, Doconut zapewnia, że oryginalny dokument nigdy nie opuszcza chronionego środowiska, a Ty zachowujesz pełną widoczność aktywności drukowania – kluczowy wymóg w branżach regulowanych.

Podsumowanie

Biblioteka Document Viewer firmy Doconut daje zespołom .NET jedyny, bezpieczny i bogaty w funkcje komponent do renderowania PDF‑ów, plików Office i rysunków CAD, wzbogacając je o adnotacje, wyszukiwanie z OCR oraz kontrolowane drukowanie. Dzięki przetwarzaniu po stronie serwera, wbudowanej konwersji i obsłudze ponad 33 formatów, możesz wyeliminować kosztowne zależności zewnętrzne i utrzymać wrażliwe dane pod własną kontrolą.

Gotowy, aby zmodernizować przepływ dokumentów w swojej firmie? Rozpocznij darmowy trial Doconut już dziś, pobierz bibliotekę i postępuj zgodnie z opisanymi krokami integracji, aby w kilka minut dodać potężne możliwości przeglądania, adnotacji i wyszukiwania do swojej aplikacji .NET.