E-přihláška — Aplikační programové rozhraní aplikace

Na seznam témat a kapitol (obsah)Nadřízená kapitola

E-přihláška obsahuje malé "rozhraní", které můžete využít při propojení z vašich školních webů, které jsou specializované na přijímací řízení. Můžete uchazeče odkázat přímo do aplikace e-přihlášky s tím, že jej nasměrujete na nějaký konkrétní stav či místo.

Nepoužívejte běžná provozní URL, která v prohlížeči vidíte při procházení aplikace, nebudou dlouhodobě fungovat, fungují typicky pouze během uživatelova přihlášení. Pokud chcete odkázat na konkrétní stav aplikace, použijte následující URL adresy. Základní URL je následující:

https://PORTAL.SKOLA.CZ/StagPortletsJSR168/CleanUrl?urlid=eprihlaska

… a následují tyto možnosti:

  • Přímo na podání přihlášky na konkrétní přijímací program: Přidejte parametry odkazující na dvojici identifikátorů otevřeného přijímacího programu (global_idno, rok): &global_idno=HODNOTA&rok=HODNOTA

    Seznam aktuálně otevřených přijímacích programů lze získat například webovou službou z API IS/STAG "prijimacky/getPrijimaciObory". Popis této služby naleznete například zde na DEMO serveru IS/STAG

  • Na obrazovku s vyhledáváním přijímacích programů s možností přednastavit filtr: Přidejte parametr &search=1 a pak libovolné z následujících parametrů, jejichž význam je asi zřejmý &search_fakulta=FAKULTA, &search_typ=TYP_OBORU, &search_forma=FORMA_OBORU, &search_misto=MISTO, &search_jazyk=JAZYK, &search_nazev=VYHLEDAVANI,

  • Výběr jazyka. Zcela obecně platí, že chcete-li vynutit zobrazení webové stránky v nějakém jazyku (tj. obejít běžný výběr jazyka založený na preferencích uživatele), předejte parametr &plang=cz nebo &plang=en

Zadávání textů v HTML formátu

V některých hodnotách textových parametrů a popisných položek je možno zadat HTML syntaxi a ta se přímo zobrazí ve výsledné webové stránce aplikace. Využívejte tuto možnost velmi obezřetně, abyste nerozbili design aplikace či vůbec její fungování na dané webové stránce. Aby se riziko minimalizovalo, prochází tyto texty před zobrazením na stránce tzv. "sanitizací" - kontrole použitého HTML kódu a případně odstranění nepodporovaných HTML tagů, případně jejich atributů a podobně. Taktéž pokud napříkald zapomenete uzavírací tagy, jsou doplněny.

Seznam podporovaných HTML tagů: a, b, blockquote, br, cite, code, dd, dl, dt, em, i, li, ol, p, pre, q, small, span, strike, strong, sub, sup, u, ul . U těchto tagů jsou podporovány pouze následující atributy: jakýkoliv element:atribut class, a:href (lze odkázat pouze na protokoly ftp, http, https, mailto)

Seznam míst, která zadání HTML kódu podporují nejsme reálně schopni udržovat v nápovědě aktuální - potřebujete-li HTML na nějakém místě, prosím, vyzkoušejte si tam zadat například nějaký jednoduchý HTML element a ověřte, zda se v e-přihlášce objeví. A pokud ne a nutně jej potřebujete, požádejte administátory Vaší školy, aby kontaktovali vývojový tým.

Nahrazování speciálních řetězců v některých parametrech a odkazech

V některých hodnotách textových parametrů a URL adresách, které se týkají vždy konkrétního přijímacího programu a které administrátoři zadávají buď ve formuláři PJ0040, lze použít nahrazování speciálních řetězců konkrétními hodnotami od přijímacího programu. Slouží to k tomu, pokud máte například dynamicky generovaný či nějak elegantně členěný web pro uchazeče a chcete odkazovat ze všech přijímacích programů ve stejném "duchu" (abyste nemuseli např. při kopírování přijímacích programů na nový ak. rok to celé přepisovat ručně), můžete do níže uvedených URL vepsat následující podřetězce, které jsou nahrazeny příslušnými hodnotami v okamžiku výpisu:

  • {FAKULTA}. Zkratka fakulty

  • {GLOBALIDNO}. ID přijímacího programu

  • {ROK}. Akademický rok přijímacího programu. Pouze první rok, tj. pro 2024/2025 je hodnota "2024"

  • {AKAD_ROK}. Akademický rok přijímacího programu psaný ve formě pro lidi. Tedy hodnota "2024/2025".

  • {STPRIDNO}. ID studijního programu, k němuž je přijímací program navázán. V případě kombinací mayor.

  • {OBORIDNO}. ID specializace, na kterou je přijímací program navázán. V případě kombinací je prázdné.

  • {KOMBIDNO}. ID kombinace, na kterou je přijímací program navázán. Není-li navázán na kombinaci, je prázdné.

  • {FAKULTA_NAZEV}. Název fakulty, na kterou je přijímací program navázán.

  • {PROGRAM_NAZEV}. Název studijního programu, na který je přijímací program navázán.

  • {SPECIALIZACE_NAZEV}. Název specializace, na kterou je přijímací program navázán.

  • {TYP_PROGRAMU_NAZEV}. Název typu studijního programu, na který je přijímací program navázán.

  • {FORMA_PROGRAMU_NAZEV}. Název formy studijního programu, na který je přijímací program navázán.

  • {MISTO_NAZEV}. Název místa, na který je přijímací program navázán.

Následující hodnoty lze použít i tam, kde nahrazovaný text není přímo v kontextu nějaké přhlášky, ale pouze samotného uchazeče jako takového - například v hlavním menu, kde není vybrána žádná přihláška (např. v parametrech EPR_MENU_TLACITKO_URL a EPR_MENU_TLACITKO_TEXT):

  • {LOCALE}. Hodnota buď "cs" nebo "en" podle toho, jakou jazykovou verzi má aktuálně uživatel přepnutou.

  • {LOGIN_TICKET}. Tajná informace, tajný kód, který je přiřazen k e-mailovému účtu aktuálního uchazeče a který je mu zasílán při registraci na e-mail v rámci zpětné odkazu, na který má kliknout. Používejte s velkou obezřetností, jen na místech, kde to opravdu naprosto nutně potřebujete. Například pro přenos přihlášení uchazeče do nějakého Vašeho návazného systému.

  • {EPR_EXT_URL}. Hodnota sloupečku EPR_EXT_URL tabulky PR_UCHAZECI_WWW, který si škola může nastavovat sama svými vlastními prostředky.

Toto nahrazování hodnot lze použít na těchto místech: