E-přihláška — Správa modulu schvalování
Administrátorská část modulu schvalování je k dispozici v portálové sekci "Administrace / Správa schvalování". Je k dispozici uživatelské roli "Administrátor" plus nové roli "Správa schvalování". Tuto roli můžete přidělit nějakému delegovanému uživateli třeba na fakultě a nechat jej tento modul konfigurovat třeba pro potřeby dané fakulty. Uživatelskou roli ES můžete v SY0010 přiřadit buď k fakultě REK a nebo i k nějaké jednotlivé fakultě. Zatím má toto nastavení ale pouze vliv na to, jaké výsledné uchazeči zadané hodnoty může daný člověk stáhnout (viz tato kapitola), ale na možnost editace a nastavování to zatím vliv nemá - zatím necháváme tyto uživatele nastavovat a měnit typy schvalování všechny bez ohledu na fakultu, časem to můžeme dle vašich námětů omezit (modul se teprve bude rozjíždět, takže uvidíme, zda to bude nutné).
Aplikace Vám umožňuje vytvářet, upravovat, mazat typy schvalování a nastavovat jejich atributy. Dále pak pro každý typ schvalování lze nastavit pro koho je určen (omezení na fakultu, formu, typ) a u typů, které očekávají výběr z nějakých předdefinovaných hodnot, lze tyto možné hodnoty specifikovat. Zadání je (snad) intuitivní, většina položek je detailně popsána.
Obrázek 697. Schvalování - editor.
Pro kontrolu Vašeho zadání můžete využít report v sekci IS/STAG / Reporty s názvem Schvalování/Souhlasy / Konfigurace schvalování/souhlasů. Nechte si jej vyexportovat do Excelu a projděte si kompletně a (snad) přehledně, jak máte souhlasy nakonfigurované. Je to asi přehlednější a rychlejší než klikání v administračním rozhraní.
Získání dat
Data, hodnoty a texty, které uchazeči zadali, je možno stáhnout reportem v sekci IS/STAG / Reporty s názvem Schvalování/Souhlasy / Uchazeč - seznam schvalování/souhlasů.
K reportu mají přístup uživ. role administrátor, prorektor a uživatelská role "Správa schvalování" v případě, že má nastavenu fakultu na REK. Dále pak k reportu mohou omezeně role studijní referentka, tajemník fakulty a "Správa schvalování" (má-li nastavenou nějakou konkrétní fakultu) - ti pak mohou vidět pouze uchazeče na jejich fakulty.
Obrázek 698. Schvalování - report.
Oba tyto reporty jsou k dispozici i prostřednictvím REST API v modulu WS, jedná se o endpoint "ng_souhlasy". Pozor, jedná se o jiný endpoint a jinou technologii, než je následná kapitola o kompletním REST API, nicméně k dispozici to je taktéž, pouze na jiném URL. Volání si lze vyzkoušet například na IS/STAG DEMO serveru zde.
REST API pro schvalování/souhlasy
K datům modulu schvalování lze přistupovat přes REST API. Data lze nejen stahovat, ale i je kompletně zadávat, měnit, mazat. Modul sestává ze čtyř tabulek (tři tabulky slouží k definování struktury schvalování/souhlasů, čtvrtá pro evidencei dat zadaných studenty/uchazeči), pro každou tabulku existuje sada CRUD operací (create,update,delete plus selecty). Jedná se o tabulky:
SCHVALOVANI_TYPY. Definice jednotlivých typů schvalování, tedy jednotlivých položek, která uchazeč/student za nějakých podmínek a na daných místech může vidět a může případně nějak reagovat. Hlavní tabulka s definicí daného modulu.
SCHVALOVANI_MOZNE_HODNOTY. Podřízená tabulka: má-li nějaký typ schvalování možnost vybírat z několika předem daných hodnot, zde se ony hodnoty definují.
SCHVALOVANI_MOZNE_HODNOTY. Podřízená tabulka: má-li nějaký typ schvalování možnost být dostupný pouze omezenější množině uchezečů/studentů, zde se omezení definují. Více omezení zadaných u jednoho typu schvalování je spojeno logickou spojkou OR.
SCHVALOVANI. Tabulka s daty, která zadali uchazeči/studenti - tedy typicky reakce, odpovědi, zvolené hodnoty. V případě typu schvalování "Žádné odpovidání - pouze zobrazená informace", tedy pokud chcete pouze uchazeči nějakou informaci zobrazit, platí, že pokud pro daného uchazeče do tabulky SCHVALOVANI vložíte nějaký záznam, pak se hodnota z položky ODPOVED_TEXT vezme (není-li prázdná) a použije se na obrazovce, kde uchazeč informaci vidí, namísto položky SCHVALOVANI_TYPY.SCHVALOVANY_TEXT. Čili tím můžete danému uchazeči doručit nějakou, zcela individualizovanou hodnotu konkrétně pro něj.
Toto REST API je zdokumentováno ve formě OpenAPI specifikace a je pro něj zprovozněn vizuální nástroj Swagger UI běžící přímo v našem modulu WS. Konkrétně na našem IS/STAG DEMO serveru je k dispozici přímo zde: Swagger UI. Vyzkoušet můžete snadno, využijte nějakou uživatelskou roli pro volání služeb určenou, tj. například roli "Správa schvalování" nebo na DEMO serveru klidně nějakého administrátorského uživatele (všichni mají heslo "demo"), kterého si vyberete na titulní straně portálu IS/STAG demo.
