> 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/eksploatacja-aplikacji/webforms/konfiguracja/przekierowania-wewnetrzne.md).

# Przekierowania wewnętrzne Eximee

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

Przekierowanie wewnętrzne Eximee to przekierowanie z formularza do innego formularza Eximee, przy którym platforma sama przekazuje formularzowi docelowemu wybrane parametry, na przykład źródło wejścia albo kanał. Autor formularza nie musi dopisywać ich ręcznie do adresu przekierowania. Listę przekazywanych parametrów ustala administrator środowiska w pliku `webforms.xml`.

## Oznaczenie przekierowania jako wewnętrznego

Aby oznaczyć przekierowanie jako wewnętrzne, zaznacz w Designerze pole **Przekierowanie wewnętrzne Eximee**. Pole jest dostępne:

* w akcji nawigacyjnej – w wierszu akcji, pod metodą i polem **Link przekierowania** (zob. [Akcje nawigacyjne](https://docs.eximee.com/budowanie-aplikacji/logika-biznesowa/przeplywy/akcje-nawigacyjne.md)),
* w akcji REDIRECT – w szczegółach akcji, w wierszu **Typ przekierowania** (zob. [Akcje](https://docs.eximee.com/budowanie-aplikacji/logika-biznesowa/przeplywy/akcje.md)).

Parametry są dołączane do oznaczonego przekierowania:

* po przejściu na kolejną stronę, cofnięciu na poprzednią stronę i zapisie wniosku (akcje nawigacyjne),
* przy przejściu do wybranej strony, na przykład przyciskami **Wstecz** i **Dalej** przeglądarki,
* po wywołaniu akcji REDIRECT.

Przekierowanie bez zaznaczonego pola działa jak dotychczas – platforma nie zmienia jego adresu.

{% hint style="warning" %}
Zaznaczaj pole tylko wtedy, gdy adres prowadzi do formularza Eximee. Platforma nie sprawdza adresu docelowego, więc oznaczenie przekierowania do zewnętrznej strony przekaże tej stronie parametry z listy.
{% endhint %}

## Konfiguracja

Listę parametrów podaje się w pliku:

```
/etc/eximee/webforms.xml
```

w elemencie `eximee.internal-redirect.parameters`, jako nazwy rozdzielone przecinkami:

```xml
<webforms>
    <eximee>
        <internal-redirect>
            <parameters>SOURCE,channel,idKampanii</parameters>
        </internal-redirect>
    </eximee>
</webforms>
```

**Domyślna wartość:** pusta lista. Przekierowanie oznaczone jako wewnętrzne nie dostaje wtedy żadnego parametru.

{% hint style="info" %}
Zmiana listy zaczyna działać po ponownym uruchomieniu aplikacji Webforms. Formularzy nie trzeba wdrażać ponownie.
{% endhint %}

## Zasady dołączania parametrów

* Przekierowanie dostaje każdy parametr z listy, którego nazwy nie ma jeszcze w adresie. Parametr podany w adresie przez autora formularza zachowuje swoją wartość, także pustą (na przykład `idKampanii=`).
* Nazwy parametrów są porównywane z uwzględnieniem wielkości liter: `idKampanii` i `idkampanii` to dwa różne parametry.
* Wartość parametru to wartość zmiennej sesyjnej formularza o tej nazwie w chwili przekierowania, także zmieniona przez logikę formularza. Wyjątki:
  * `channel` dostaje wartość `native`, gdy formularz działa w aplikacji mobilnej; poza nią parametr nie jest dołączany,
  * `SOURCE` dostaje źródło, z którym formularz został uruchomiony.
* Parametr bez wartości nie jest dołączany.
* Przy metodzie GET parametry trafiają na koniec adresu, w kolejności z listy, przed fragmentem `#`. Przy metodzie POST trafiają do pól wysyłanego formularza. Wartości są kodowane tak, żeby formularz docelowy odczytał je bez zmian.

{% hint style="warning" %}
Przy metodzie GET wartości parametrów są widoczne w adresie, w historii przeglądarki i w nagłówku Referer. Jeśli lista zawiera parametr z danymi wrażliwymi, na przykład identyfikatorem sesji klienta, ustaw w akcji metodę POST.
{% endhint %}

## Przykład

Lista parametrów w `webforms.xml` to `SOURCE,channel,idKampanii`. Akcja nawigacyjna z zaznaczonym polem **Przekierowanie wewnętrzne Eximee** ma metodę GET i link przekierowania:

```
https://wnioski.example.com/app/wniosek-docelowy/index.html?idKampanii=wiosna#start
```

Klient otworzył formularz w przeglądarce z parametrem `SOURCE=www`, a zmienna sesyjna `idKampanii` ma wartość `jesien`. Po przejściu na kolejną stronę formularz docelowy zostanie otwarty pod adresem:

```
https://wnioski.example.com/app/wniosek-docelowy/index.html?idKampanii=wiosna&SOURCE=www#start
```

* `SOURCE` został dołączony przed fragmentem `#start`.
* `idKampanii` zachował wartość `wiosna` z linku przekierowania.
* `channel` nie został dołączony, bo formularz działa w przeglądarce.

Gdyby akcja miała metodę POST, formularz docelowy dostałby pola `idKampanii=wiosna` i `SOURCE=www`, a adres przekierowania nie zawierałby parametrów.

## Rozwiązywanie problemów

Jeżeli parametr z listy nie trafił do formularza docelowego, sprawdź, czy:

* w akcji jest zaznaczone pole **Przekierowanie wewnętrzne Eximee**,
* nazwa w `webforms.xml` ma tę samą wielkość liter co zmienna sesyjna,
* link przekierowania nie zawiera już parametru o tej nazwie, także z pustą wartością,
* zmienna sesyjna ma wartość w chwili przekierowania,
* aplikacja Webforms została uruchomiona ponownie po zmianie listy.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.eximee.com/eksploatacja-aplikacji/webforms/konfiguracja/przekierowania-wewnetrzne.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
