Podgląd PDF - PdfViewer

Dostępność funkcjonalności zależy od licencji i może nie być dostępna we wszystkich wdrożeniach.

Komponent umożliwia wyświetlenie dokumentu PDF bezpośrednio na formularzu. Dokument może być wskazany za pomocą ścieżki do pliku dostępnego na środowisku lub adresu URL do zewnętrznego zasobu. Pozwala to użytkownikowi na zapoznanie się z treścią (np. regulaminem, umową lub instrukcją) bez konieczności pobierania pliku na dysk czy otwierania nowej karty w przeglądarce.

✅ Kiedy stosować:

• Wyświetlanie pojedynczego dokumentu PDF bezpośrednio na formularzu.

❌ Kiedy nie stosować:

• Prezentowanie listy dokumentów lub umożliwienie ich pobierania. Stosuj: DocumentList.
• Udostępnienie użytkownikowi linku do dokumentu lub innego zasobu bez wyświetlania jego treści na formularzu. Stosuj: ExternalLink.

Komponent czytnika PDF

Ilustracja 1. Przykładowy wygląd komponentu na formularzu

Właściwości komponentu

Właściwości Eximee Designer	Nazwa atrybutu w Źródle	Opis
Link do pdf (sekcja Podstawowe właściwości)	pdfUrl	Względna ścieżka do pliku umieszczonego w folderze na środowisku, bądź też link zewnętrzny, jednakże musi on wtedy spełniać wymagania polityki CORS (odpowiednio ustawiony nagłówek Access-Control-Allow-Origin). Domyślnie właściwość jest ustawiona na pustą. Ważne: Wprowadzenie niepoprawnego URL bądź niewprowadzenie go w ogóle powoduje błąd i uniemożliwia wypełnianie wniosku po próbie wyświetlenia pliku PDF.

Więcej informacji o właściwościach komponentu: Wspólne właściwości komponentów

Konfiguracja komponentu

Adres pliku PDF należy skonfigurować w polu Link do pdf w panelu właściwości komponentu. Wartość ta może zostać wpisana bezpośrednio jako statyczny link lub przekazana dynamicznie za pomocą zmiennej.

1. Ścieżka do pliku dostępnego na środowisku

   Polega na podaniu ścieżki do statycznego zasobu umieszczonego bezpośrednio w strukturze katalogów serwera aplikacji.

   

   Ilustracja 2. Konfiguracja komponentu przy użyciu ścieżki lokalnej
2. Zewnętrzny adres URL

   Polega na podaniu bezwzględnego adresu URL do pliku. Zewnętrzny serwer musi jednak zezwalać na pobieranie pliku przez przeglądarkę z poziomu aplikacji, zgodnie z polityką CORS.

   

   Ilustracja 3. Konfiguracja komponentu przy użyciu zewnętrznego adresu URL

CORS to mechanizm bezpieczeństwa w przeglądarkach internetowych. Blokuje on pobieranie zasobów (np. plików PDF) z innej domeny niż ta, na której znajduje się formularz, chyba że serwer docelowy jawnie wyrazi na to zgodę, wysyłając odpowiedni nagłówek HTTP (Access-Control-Allow-Origin).

1. Zasilenie komponentu wartością zmiennej sesyjnej

   Adres pliku PDF może zostać zasilony dynamicznie wartością zmiennej sesyjnej. W polu Link do pdf można użyć odwołania do zmiennej (np. ${pdfUrl}), która będzie zasilana wartością pochodzącą ze skryptu bądź usługi.

   

   Ilustracja 4. Konfiguracja komponentu przy użyciu zmiennej sesyjnej

   

   Ilustracja 5. Zmienna sesyjna zasilona wartością ze skryptu

W przypadku zasilenia komponentu zmienną sesyjną pamiętaj o dodaniu nasłuchiwania na tę zmienną.

Należy pamiętać, że wartość zmiennej sesyjnej nie może być pusta — w przeciwnym razie wniosek nie będzie działał poprawnie po próbie wyświetlenia komponentu.

Wnioski demo: demoPdfViewer