Praca z Modify PDF Online – anotowanie, podświetlanie i udostępnianie PDF‑ów do wyszukiwania bezpośrednio w aplikacji webowej: Praktyczny przewodnik
← Back to Blog5 min read

Praca z Modify PDF Online – anotowanie, podświetlanie i udostępnianie PDF‑ów do wyszukiwania bezpośrednio w aplikacji webowej: Praktyczny przewodnik

Jeśli musisz umożliwić użytkownikom anotowanie, podświetlanie i przeszukiwanie treści PDF‑ów bez opuszczania przeglądarki, funkcja Modify PDF Online firmy Doconut zapewnia dokładnie to. Osadza pełnoprawną przeglądarkę PDF bezpośrednio w Twojej aplikacji webowej .NET i udostępnia API po stronie serwera do oznaczania i wyszukiwania opartego na OCR – wszystko w jednym, bezpiecznym komponencie.

W kolejnych sekcjach omówimy ogólną architekturę, logiczne kroki niezbędne do włączenia anotacji, podświetlania i wyszukiwania OCR oraz wzorce najlepszych praktyk przy budowie rozwiązania gotowego na potrzeby przedsiębiorstw.

Bezpieczna przeglądarka PDF po stronie serwera z anotacjami, podświetlaniem, wyszukiwaniem OCR i kontrolowanymi narzędziami drukowania
Bezpieczna przeglądarka PDF po stronie serwera z anotacjami, podświetlaniem, wyszukiwaniem OCR i kontrolowanymi narzędziami drukowania

Dlaczego Modify PDF Online jest przełomem dla aplikacji .NET w przedsiębiorstwach

Rozwiązania skoncentrowane na dokumentach – czy to DMS, portal CRM, czy platforma przeglądu prawnego – muszą spełniać trzy sprzeczne wymagania:

  1. Doświadczenie użytkownika – recenzenci oczekują płynnego, przeglądarkowego interfejsu, który zachowuje się jak desktopowy edytor PDF.
  2. Bezpieczeństwo i zgodność – dokumenty często zawierają poufne dane, które nie mogą być przekazywane usługom zewnętrznym.
  3. Skalowalność – pojedyncze wywołanie API może obsługiwać setki jednoczesnych użytkowników w wielu regionach.

Doconut spełnia wszystkie trzy dzięki jednej bibliotece działającej po stronie serwera (dokument nigdy nie opuszcza Twojej infrastruktury), jednocześnie dostarczając renderowaną zawartość do obsługiwanych przeglądarek. Funkcjonalność Modify PDF Online opiera się na tym samym silniku renderującym, który napędza bibliotekę Document Viewer firmy Doconut, zapewniając pikselową wierność PDF‑ów, plików Office i rysunków CAD. Ponieważ funkcja jest wbudowana w przeglądarkę, możesz dodawać, edytować i utrzymywać anotacje bez dodatkowych wtyczek czy usług zewnętrznych.

Kluczowe korzyści dla starszych programistów i architektów

KorzyśćCo to oznacza dla Twojego rozwiązania
HTML5/JavaScript UIPrzeglądarka działa w przeglądarce bez wymogu ActiveX czy własnościowych wtyczek PDF.
Kontrolowane drukowanieMożesz włączać lub wyłączać drukowanie w zależności od roli użytkownika bezpośrednio z interfejsu przeglądarki.
OCR po stronie serweraZeskanowane obrazy stają się tekstem możliwym do wyszukiwania, pozostając w Twoim centrum danych.
Jednolita powierzchnia APITa sama klasa Viewer obsługuje otwieranie, anotowanie i wyszukiwanie PDF‑ów.

Centralizując te możliwości, zmniejszasz ilość własnego kodu, który musisz napisać, utrzymać i audytować – co jest istotne w regulowanych branżach, takich jak opieka zdrowotna, finanse i technologia prawna.


Włączanie anotacji i podświetleń w przeglądarce Doconut

Wtyczka Annotation jest dostępna automatycznie po włączeniu Modify PDF Online. Typowy przepływ pracy składa się z czterech logicznych kroków:

  1. Zarejestruj middleware Doconut – Skonfiguruj potok ASP.NET Core, aby Doconut mógł serwować swoje zasoby statyczne (JavaScript, CSS, WebAssembly) i egzekwować licencjonowanie.
  2. Utwórz instancję Viewer – W usłudze o zasięgu scoped lub w kontrolerze, zainicjuj obiekt Viewer, przekazując wymagane serwisy, takie jak cache i dostęp do kontekstu HTTP.
  3. Otwórz PDF i uzyskaj token dokumentu – Wywołaj metodę otwierania dokumentu, podając ścieżkę pliku (lub strumień) oraz opcje renderowania (np. rozdzielczość obrazu). Metoda zwraca unikalny token identyfikujący sesję dokumentu.
  4. Pracuj z menedżerem anotacji – Pobierz menedżera anotacji dla wybranej strony, dodaj obiekt podświetlenia lub komentarza, a następnie zapisz wynikowy XML na serwerze przy użyciu metody zapisu przeglądarki.

Front‑end po prostu ładuje przeglądarkę z tokenem i włącza wbudowany pasek narzędzi anotacji. Użytkownicy mogą dodawać komentarze, rysować kształty lub umieszczać pieczątki, a każda interakcja jest odsyłana do tego samego punktu końcowego API, co utrzymuje przepływ danych prostym i audytowalnym.


Wyszukiwalny PDF jest niezbędny w każdym portalu opartym na wiedzy. Search Plugin firmy Doconut współpracuje ramię w ramię z Modify PDF Online. Gdy dokument zostaje otwarty, przeglądarka automatycznie indeksuje jego warstwę tekstową. Jeśli plik jest zeskanowanym obrazem, najpierw uruchamiany jest silnik OCR po stronie serwera, konwertując obraz rastrowy na tekst możliwy do przeszukiwania.

Aby udostępnić funkcję wyszukiwania klientowi, zazwyczaj:

  1. Włącz OCR podczas otwierania dokumentu – Ustaw odpowiedni flag w konfiguracji PDF, aby silnik OCR przetworzył zeskanowane strony.
  2. Udostępnij endpoint wyszukiwania – Zaimplementuj lekką metodę API, która przyjmuje token i ciąg zapytania, przekazuje żądanie do procedury wyszukiwania przeglądarki i zwraca numery stron oraz współrzędne podświetleń.
  3. Wyświetl wyniki w UI – Przeglądarka automatycznie podświetla dopasowania; front‑end może zapewnić kontrolki nawigacyjne (następny/poprzedni) bez pełnego przeładowania strony.

Ponieważ anotacje są przechowywane jako XML, podświetlenia wyszukiwania nakładają się czysto na istniejące oznaczenia, dając recenzentom pełny kontekst podczas dodawania komentarzy.


Integracja Modify PDF Online w warstwie bezpiecznego API

Przedsiębiorstwa często udostępniają funkcje dokumentacyjne poprzez REST‑owe API, które znajduje się za uwierzytelnianiem, kontrolą dostępu opartą na rolach i logowaniem zdarzeń. Projekt Doconut ułatwia taką integrację: każda operacja (otwarcie, anotacja, wyszukiwanie, drukowanie) to pojedyncze wywołanie metody na obiekcie Viewer, a biblioteka współpracuje natywnie z IDistributedCache i IHttpContextAccessor.

Zalecany wzorzec to enkapsulowanie wszystkich interakcji z przeglądarką w klasie DocumentService. Usługa weryfikuje uprawnienia wywołującego, otwiera dokumenty, dodaje podświetlenia, uruchamia wyszukiwania z OCR i zwraca wyniki. Kontrolery wywołują metody usługi, utrzymując kod kontrolera lekki i skoncentrowany na zagadnieniach HTTP.

Kluczowe punkty bezpiecznej, skalowalnej implementacji:

  • Przechowywanie tokenu per użytkownik – Zapisz token dokumentu w bezpiecznym cache (np. Redis) powiązanym z sesją użytkownika.
  • Sprawdzanie uprawnień – Egzekwuj reguły biznesowe przed każdą operacją przeglądarki.
  • Bezstanowe endpointy – Każde żądanie zawiera token, co umożliwia poziome skalowanie usługi.
  • Logowanie zdarzeń – Rejestruj akcje anotacji i wyszukiwania w celach raportowania zgodności.

Podsumowanie

Modify PDF Online firmy Doconut dostarcza kompletny stos po stronie serwera do modyfikacji PDF, obejmujący anotacje, podświetlanie i wyszukiwanie oparte na OCR – wszystko bez korzystania z usług zewnętrznych. Stosując opisane wyżej wzorce, możesz zapewnić bezpieczne, wysokowydajne doświadczenie przeglądu PDF, które sprosta obciążeniom przedsiębiorstw.

Gotowy, aby wprowadzić potężną edycję PDF do swojej aplikacji webowej .NET? Wypróbuj Doconut już dziś i zobacz, jak szybko możesz włączyć anotacje, podświetlenia i możliwości wyszukiwania PDF bezpośrednio w przeglądarce.

#PDF#Document Viewer#.NET#Web Development#Enterprise#Przeglądarka dokumentów#Rozwój aplikacji webowych#Przedsiębiorstwo