For the complete documentation index, see llms.txt. This page is also available as Markdown.

Przekierowania wewnętrzne Eximee

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

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),

  • w akcji REDIRECT – w szczegółach akcji, w wierszu Typ przekierowania (zob. Akcje).

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.

Konfiguracja

Listę parametrów podaje się w pliku:

/etc/eximee/webforms.xml

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

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

Zmiana listy zaczyna działać po ponownym uruchomieniu aplikacji Webforms. Formularzy nie trzeba wdrażać ponownie.

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.

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:

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:

  • 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.

Ostatnia aktualizacja

Czy to było pomocne?