Migracja starszych rozwiązań do przeglądania dokumentów na nowoczesne SDK o niskim zużyciu zasobów
← Back to Blog7 min read

Migracja starszych rozwiązań do przeglądania dokumentów na nowoczesne SDK o niskim zużyciu zasobów

Najszybszą drogą do nowoczesnego, bezpiecznego i responsywnego przeglądarki dokumentów jest zastąpienie przestarzałych komponentów niskozasobowym SDK firmy Doconut. Dla portali internetowych wykorzystujących Kendo UI, SDK zapewnia szybkie renderowanie, pełną dostępność i skoncentrowaną ścieżkę integracji. Przedsiębiorstwa, które kiedyś łączyły własne przeglądarki na bazie bibliotek jedynie desktopowych lub zewnętrznych usług konwersji, szybko napotykają problemy: koszty utrzymania rosną, zależności po stronie klienta stają się kruche, a dostępność zostaje pominięta. Doconut usuwa te bariery, oferując natywne renderowanie PDF, Office i CAD bezpośrednio z back‑endu .NET, jednocześnie utrzymując front‑end lekki i w pełni pod Twoją kontrolą.

W kolejnych sekcjach przyjrzymy się, dlaczego przestarzałe przeglądarki stają się obciążeniem, jak architektura Doconut rozwiązuje te problemy oraz przedstawimy praktyczną mapę migracji, którą możesz rozpocząć już teraz.

Migracja z zależnej od wielu komponentów przeglądarki dziedzictwa do bezpiecznej przeglądarki dokumentów po stronie serwera
Migracja z zależnej od wielu komponentów przeglądarki dziedzictwa do bezpiecznej przeglądarki dokumentów po stronie serwera

1. Przeglądarki dziedzictwa: ukryte koszty za znajomymi interfejsami

Większość „dziedziczących” przeglądarek dokumentów powstała, gdy przeglądarki nadal polegały na wtyczkach, kontrolkach ActiveX lub ciężkich instalacjach Office na serwerze. Skutki pojawiają się na kilka sposobów:

ProblemRealny wpływ
Zależności po stronie klientaUżytkownicy muszą instalować lub włączać wtyczki przeglądarki; korporacyjne IT je blokuje, przerywając przepływ pracy.
Wymagania Office po stronie serweraInstalowanie Microsoft Office na serwerze internetowym narusza najlepsze praktyki bezpieczeństwa i podnosi koszty licencji.
Ograniczone wsparcie formatówNowe formaty CAD lub obrazy (DWG, DXF, PNG) są nieobsługiwane, wymuszając obejścia lub ręczne konwersje.
Wąskie gardła skalowalnościRenderowanie odbywa się na CPU klienta; duże pliki PDF lub wielostronicowe dokumenty Office powodują spowolnienia i awarie.
Luki w dostępnościNawigacja klawiaturą, wsparcie czytników ekranu i zgodność z WCAG są często dodatkami po fakcie, narażając firmy na ryzyko niezgodności.
Koszmar utrzymaniaSDK dostawców, które nie są już aktualizowane, stają się zagrożeniem bezpieczeństwa, a każda poprawka wymusza pełne wdrożenie.

Dodaj te ukryte koszty do systemu skoncentrowanego na dokumentach — czy to DMS, portal CRM, czy platforma e‑learningowa — a ROI szybko znika. Nowoczesne przedsiębiorstwa potrzebują przeglądarki, która nie zależy od wtyczek po stronie klienta, działa bez Office i skaluje się na serwerze. Doconut dostarcza dokładnie to.


2. Niskozasobowe renderowanie po stronie serwera: idealne SDK przeglądarki PDF dla nowoczesnych aplikacji

Kluczową siłą Doconut jest silnik renderowania dokumentów po stronie serwera, który strumieniuje obrazy rastrowe do przeglądarki, eliminując potrzebę jakiejkolwiek wtyczki po stronie klienta. Oto jak architektura odpowiada na wymienione wyżej wyzwania:

a. Minimalny ślad po stronie klienta w przeglądarce

  • Przeglądarka dostarcza jedynie HTML, CSS i niewielką ilość JavaScript. Brak ActiveX, Flash, Silverlight — tylko standardowe zasoby webowe dostarczane do obsługiwanych przeglądarek.
  • Ponieważ renderowanie odbywa się na serwerze, klient nigdy nie potrzebuje .NET Desktop, Office ani przeglądarki CAD.

b. Kompleksowe pokrycie formatów

Doconut natywnie obsługuje ponad 33 formaty z kategorii Office, PDF, CAD, e‑mail i obrazy — w tym DOC/DOCX, XLS/XLSX, PPT/PPTX, DWG, DXF, PNG, JPG i wiele innych. To eliminuje „lukę typów plików”, która zmusza programistów do łączenia wielu zewnętrznych konwerterów.

c. Wbudowane adnotacje, wyszukiwanie i kontrolowane drukowanie

  • Wtyczka adnotacji – dodawaj podświetlenia, komentarze lub rysunki odręczne bezpośrednio w przeglądarce.
  • Wtyczka wyszukiwania – natychmiastowe przeszukiwanie tekstu w całym dokumencie, z OCR dla zeskanowanych obrazów.
  • Kontrolowane drukowanie – wymuszaj zasady drukowania z poziomu UI przeglądarki, zapobiegając nieautoryzowanym kopiom.

d. Konwersja po stronie serwera dla przepływów bez Office

Wtyczka konwertera pozwala przekształcać pliki Word, Excel, PowerPoint i CAD do PDF, PNG lub HTML na serwerze. Bez instalacji Microsoft Office, bez zewnętrznych usług SaaS i bez wycieków danych poza Twoją zaporę.

e. Dostępność wbudowana

Doconut spełnia wytyczne WCAG 2.2 AA od razu — nawigacja klawiaturą, etykiety ARIA i markup przyjazny czytnikom ekranu są wbudowane w HTML przeglądarki. Spełnienie korporacyjnych polityk dostępności staje się kwestią włączenia funkcji, a nie budowania ich od podstaw.

f. Bezproblemowa integracja z nowoczesnymi stosami .NET

Niezależnie od tego, czy używasz ASP.NET Core, .NET 6, czy architektury mikro‑serwisów, Doconut podłącza się do potoku żądań jednym wywołaniem middleware. Przeglądarka może być zintegrowana z komponentami Kendo UI lub obsługiwanym front‑endem webowym.


3. Plan migracji: od przestarzałego rozwiązania do Doconut

Poniżej praktyczny, krok po kroku plan migracji, który możesz zastosować w istniejącej aplikacji .NET. Celem jest wymiana starej przeglądarki na Doconut przy zachowaniu stabilnego publicznego API dla konsumentów.

Krok 1: Przygotowanie środowiska

  1. Dodaj pakiet NuGet Doconut do rozwiązania.
  2. Upewnij się, że serwer działa na .NET 6 (lub nowszym); optymalizator zależności Doconut najlepiej współpracuje z najnowszym runtime.

Krok 2: Rejestracja middleware Doconut

Umieść middleware Doconut wcześnie w potoku żądań ASP.NET, aby żądania obrazów renderowanych dokumentów były przechwytywane i przetwarzane przez silnik Doconut.

Krok 3: Załadowanie licencji

Przy starcie aplikacji wczytaj plik licencji Doconut (lub dokument XML) raz. Jeśli posiadasz licencje specyficzne dla wtyczek (np. wtyczka adnotacji), załaduj je przy użyciu odpowiedniego API Doconut.

Krok 4: Zastąpienie wywołań starego renderowania

Zidentyfikuj miejsca, w których starszy kod renderował stronę dokumentu do bitmapy lub tablicy bajtów. Zamień te wywołania na przepływ otwierania dokumentu Doconut, który zwraca token reprezentujący otwarty dokument. Użyj tokenu do żądania obrazów stron lub miniatur poprzez endpointy serwujące obrazy Doconut.

Krok 5: Włączenie adnotacji i wyszukiwania

Zmapuj istniejącą funkcjonalność „dodaj komentarz” lub „szukaj” na wtyczki Adnotacji i Wyszukiwania Doconut. Obie wtyczki udostępniają proste metody po stronie serwera zwracające ładunki JSON, które front‑end może konsumować.

Krok 6: Aktualizacja integracji front‑endu

Ponieważ Doconut strumieniuje renderowane obrazy, front‑end potrzebuje jedynie znacznika <img> na stronę lub przeglądarki opartej na canvas. Dla Kendo UI powiąż URL‑e obrazów z Kendo Carousel, aby uzyskać płynne przewijanie stron.

Krok 7: Testowanie, optymalizacja, wdrożenie

  • Wydajność – zmierz czas do pierwszej strony; serwerowe renderowanie rastrowe Doconut zazwyczaj daje wyniki poniżej sekundy dla standardowych PDF.
  • Bezpieczeństwo – upewnij się, że żadne dane dokumentu nie wyciekają do klienta poza renderowanymi obrazami.
  • Dostępność – przeprowadź audyt czytnika ekranu; markup Doconut już zawiera role ARIA.

Po pomyślnym przejściu testów, zamień trasę starej przeglądarki na nowy endpoint Doconut i wypuść aktualizację.


4. Zwiększanie dostępności i UX dzięki Doconut i Kendo UI

Dostępność nie jest już „miłym dodatkiem”; to wymóg w wielu regulowanych branżach (opiekę zdrowotną, finanse, sektor publiczny). Gotowa zgodność Doconut pomaga spełnić te standardy bez pisania własnego kodu.

Nawigacja klawiaturą

Każdy interaktywny element — nawigacja po stronach, kontrolki powiększania, narzędzia adnotacji — posiada standardowe atrybuty tabindex. Użytkownicy mogą przemieszczać się po dokumencie wyłącznie klawiaturą, co jest niezbędne dla zgodności z sekcją 508.

Etykiety ARIA i czytniki ekranu

HTML przeglądarki zawiera role="document" oraz opisowe aria-label, które przekazują numery stron i poziom powiększenia technologiom wspomagającym. Nie musisz dodawać dodatkowego skryptu ARIA.

Tryb wysokiego kontrastu

Doconut potrafi odzwierciedlać preferencje wysokiego kontrastu skonfigurowane w interfejsie przeglądarki. UI może przełączyć się na schemat ciemny‑na‑jasnym, utrzymując czytelność dla osób słabowidzących.

Integracja z Kendo UI

Dostępne widgety Kendo UI (np. kendoButton, kendoSlider) mogą współpracować z renderowaniem obrazów Doconut. Efekt? Bezszwowa, w pełni obsługiwana klawiaturą przeglądarka, która wygląda i zachowuje się jak naturalna część Twojej aplikacji.


5. Przyszłościowe rozszerzenia: wtyczki zwiększające możliwości przeglądarki

Modularna architektura wtyczek Doconut oznacza, że możesz rozpocząć od podstawowego podglądu, a później włączać dodatkowe funkcje w miarę rozwoju potrzeb biznesowych.

WtyczkaGłówna korzyśćTypowe zastosowanie w przedsiębiorstwie
Wtyczka adnotacjiPodświetlanie, komentarze, rysowaniePrzegląd prawny, zamówienia zmian inżynieryjnych
Wtyczka wyszukiwaniaPełnotekstowe, OCR‑wspierane wyszukiwanieWyszukiwanie rekordów medycznych, audyt finansowy
Wtyczka konwerteraKonwersja Office → PDF/HTML po stronie serweraIngestja do DMS, automatyczne raportowanie
Kontrolowane drukowanieLimity druku, znaki wodnePoufne kontrakty, regulowane sprawozdania

Ponieważ wszystkie wtyczki działają po stronie serwera, zachowujesz centralną kontrolę nad obsługą danych, licencjonowaniem i skalowaniem. Dodanie nowej wtyczki sprowadza się do załadowania jej licencji i wywołania odpowiedniego API — bez konieczności rekompilacji front‑endu.


Podsumowanie

Modernizacja stosu przeglądania dokumentów nie musi być kosztownym, ryzykownym przeglądem. Przyjmując niskozasobowy silnik renderowania po stronie serwera Doconut, zyskujesz:

  • Szerokie wsparcie formatów bez zewnętrznych konwerterów.
  • Wbudowane adnotacje, wyszukiwanie i kontrolowane drukowanie, spełniające wymogi zgodności.
  • Dostępność klasy korporacyjnej od razu po wyjęciu z pudełka.
  • Płynną integrację z istniejącymi projektami .NET i Kendo UI.

Gotowy, by pożegnać przestarzałe przeglądarki i zapewnić użytkownikom szybsze, bezpieczniejsze doświadczenie? Rozpocznij migrację z Doconut już dziś – pobierz SDK, podążaj za planem migracji i zobacz różnicę w ciągu kilku minut.

#document rendering#PDF Viewer SDK#legacy migration#enterprise .NET#Doconut#renderowanie dokumentów#SDK przeglądarki PDF#migracja dziedzictwa#przedsiębiorstwa .NET