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

Biblioteka Document Viewer w Doconut umożliwia renderowanie plików PDF, Office i CAD, ich adnotowanie, przeszukiwanie oraz drukowanie — wszystko z jednego komponentu .NET.
Jeśli budujesz portal skoncentrowany na dokumentach, menedżer spraw prawnych, czy 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 aplikacji ASP.NET lub .NET Core, zachowując czysty kod i niewielki rozmiar wdrożenia.

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

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

Wdrożenie w systemie Windows i opcje wersji próbnej

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ójną wydajność renderowania i adnotacji.

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

Dlaczego biblioteka Document Viewer 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, 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 ochrony zdrowia, prawa i finansów.

Wbudowany silnik adnotacji pozwala dodawać podświetlenia, rysunki odręczne lub pieczęcie bezpośrednio na płótnie przeglądarki. Adnotacje są przechowywane jako lekki XML, co ułatwia ich zapisywanie w bazie danych lub systemie kontroli wersji. Wtyczka wyszukiwania zapewnia natychmiastowe przeszukiwanie tekstu w dowolnym otwartym pliku; gdy źródłem jest zeskanowany obraz, silnik OCR wyodrębnia tekst na bieżąco. Na koniec, funkcja kontrolowanego drukowania umożliwia narzucenie limitów zakresu stron, znaków wodnych lub logów 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 całego przedsiębiorstwa.

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 responsywność UI nawet przy dużych plikach CAD.
Załaduj licencję – podaj plik licencji Doconut (np. DoconutLicense.xml) jako plik na dysku lub jako 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 – utwórz obiekt konfiguracji (np. PdfConfig), aby kontrolować domyślne zachowanie renderowania, ekstrakcję hiperłączy oraz rozdzielczość rastra dla rysunków CAD.
Otwórz dokument – wywołaj metodę OpenDocument z ścieżką do 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 dają 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 środowisko współpracy. Menedżer adnotacji Doconut działa na poziomie stron i przechowuje wszystko jako XML, co umożliwia łatwe wersjonowanie, audyt i scalanie zmian 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.
Po ponownym otwarciu dokumentu wczytaj zapisany XML do przeglądarki metodą LoadAnnotationXML.

Scenariusze przedsiębiorcze

Legal Tech – Prawnicy umieszczają pieczęć „Podpis” na kontrakcie, a XML jest przesyłany do usługi zarządzania sprawą w celu audytu.
Engineering Review – Projektanci dodają czerwone linie 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ć bez wprowadzania 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 ciągu kilku sekund znaleźć potrzebne informacje. Wtyczka wyszukiwania Doconut oferuje natychmiastowe, pełnotekstowe wyszukiwanie w każdym otwartym pliku. 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 miejsce wystąpienia terminu.

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. Podejście to 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 pozwalają analitykom odnaleźć pozycję w dziesiątkach zeskanowanych wyciągów.
Systemy rekordów medycznych stają się przeszukiwalne pod kątem nazw leków w zeskanowanych notatkach lekarza, zwiększając bezpieczeństwo pacjenta.

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 i wygoda

Drukowanie jest często najsłabszym ogniwem bezpieczeństwa dokumentów. Funkcja kontrolowanego drukowania Doconut daje 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 logować 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 z powrotem do przeglądarki klienta.
Automatycznie tworzony jest wpis audytowy, umożliwiający administratorom śledzenie, kto co i kiedy wydrukował.

Obsługa drukowania po stronie serwera 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 i 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 przedsiębiorstwie? Rozpocznij bezpłatną wersję próbną Doconut już dziś, pobierz bibliotekę i postępuj zgodnie z opisanymi krokami integracji, aby w kilka minut dodać potężne możliwości podglądu, adnotacji i wyszukiwania do swojej aplikacji .NET.