> For the complete documentation index, see [llms.txt](https://docs.eximee.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/5-dokumenty-i-zaloczniki/podglad-pdf-pdfviewer.md).

# Podgląd PDF - PdfViewer

{% hint style="info" %}
Dostępność funkcjonalności zależy od licencji i może nie być dostępna we wszystkich wdrożeniach.
{% endhint %}

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.

![](/files/l3CGYRMNkm0OrEQkMfmn)

✅ **Kiedy stosować:**

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

:x: **Kiedy nie stosować:**

* Prezentowanie listy dokumentów lub umożliwienie ich pobierania. Stosuj: [DocumentList](/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/5-dokumenty-i-zaloczniki/lista-dokumentow-documentlist.md).
* Udostępnienie użytkownikowi linku do dokumentu lub innego zasobu bez wyświetlania jego treści na formularzu. Stosuj: [ExternalLink](/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/0-struktura-i-nawigacja/nawigacja/link-externallink.md).

## Komponent czytnika PDF

![Ilustracja 1. Przykładowy wygląd komponentu na formularzu](/files/de854b19e68cf2fb5cdf568a0d07408cef349945)

### Właściwości komponentu

| Właściwości Eximee Designer                                                             | Nazwa atrybutu w Źródle | Opis                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| --------------------------------------------------------------------------------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <p><strong>Link do pdf</strong><br>(sekcja <strong>Podstawowe właściwości</strong>)</p> | pdfUrl                  | <p>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).</p><p>Domyślnie właściwość jest ustawiona na pustą.</p><p><strong>Ważne:</strong> 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.</p> |

> Więcej informacji o właściwościach komponentu: [Wspólne właściwości komponentów](/budowanie-aplikacji/interfejs-uzytkownika/formularze/praca-z-komponentami-bazowymi/wspolne-wlasciwosci-komponentow.md)

### 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](/files/Jr3ISMAQHczD9ELQrqlI)
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](/files/5mDpKKhX9ysMQ3p39nls)

{% hint style="info" %}
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`).
{% endhint %}

3. 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](/files/AO3ny4u9McLu8lkzopry)

   ![Ilustracja 5. Zmienna sesyjna zasilona wartością ze skryptu](/files/YSdPOukxi1hPiH5Ke5HB)

{% hint style="info" %}
W przypadku zasilenia komponentu zmienną sesyjną pamiętaj o dodaniu nasłuchiwania na tę zmienną.
{% endhint %}

{% hint style="info" %}
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.
{% endhint %}

{% hint style="info" %}
Wnioski demo: demoPdfViewer
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.eximee.com/budowanie-aplikacji/interfejs-uzytkownika/formularze/biblioteka-komponentow-bazowych/5-dokumenty-i-zaloczniki/podglad-pdf-pdfviewer.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.