Napojení na eSIMS
Jedná o dva různé systémy: Český a Slovenský eSIMS.
ČESKý eSIMS
Nastavení
Pro zapnutí funkcionality stačí nastavit hodnotu parametru ESIMS_CZ_API_KEY - hodnotou je "API klíč", který vaše škola od E-SIMS získala.
Popis rozhraní
Všechny události, které nám MŠMT ukádá, že se mají vykazovat na eSIMS (typicky zápis do studia, změna formy, financování, osobních údajů, přerušení, výjezdů atd.) jsou na pozadí ukládány do tabulky ESIMS_PREPRARE_REQUEST. Z ní jsou pak v závislosti na nastavení (hned, po určitém čase, jedenkrát denně v noci) přenášeny na server eSIMS pomocí rozhraní na bázi webových služeb. Administrátor pak může na portále v logu (Studium - Administrace - Externí systémy - Logy a chyby) a sledovat vše (nastavit filtr na ESIMS) , co se na tomto rozhraní děje.
V rozhraní mezi IS/STAG a eSIMS jsou implementovány tyto webbové služby pro vykazování studentů:
Služby pro správu etap studia
POST
/api/Etapa/EtapaVrat
Vyhledání základního infa etapy studia podle jeho id
POST
/api/Etapa/IdEtapyVrat
Vyhledání informací etapy studia podle jeho id
POST
/api/Etapa/EtapaZaloz
Založení etapy studia
PUT
/api/Etapa/EtapaUprav
Upravení etapy studia
DELETE
/api/Etapa/EtapaSmaz
Smazání etapy studia
Služby pro správu studií
POST
/api/Studium/StudiumVrat
Vyhledání základních informací studia podle id studenta, rč
POST
/api/Studium/IdStudiumVrat
Vyhledání informací o studiu podle jeho id
POST
/api/Studium/StudiumZaloz
Založení nového studia
PUT
/api/Studium/StudiumUprav
Úprava studia
DELETE
/api/Studium/StudiumSmaz
Smazání studia podle id
DELETE
/api/Studium/SocialniStipendiumSmaz
Mazání sociálního stipendia
PATCH
/api/Studium/RegistracePrestupuZaloz
Registraci přestupu studenta z jednoho studia na jiné a to ať už v rámci jedné školy nebo různých škol
PATCH
/api/Studium/DatumZapisuUprav
Umožní upravit datum zápisu studia, zároveň upravuje i datum u etapy studia, pokud existje etapa se stejným datem PlatnostOd
Služby pro správu studenta
POST
/api/Student/StudentVrat
Vyhledání studenta podle jeho id na škole, rč, aifo
POST
/api/Student/StudentVratRck
Vyhledání rodného čísla nebo kódu v SIMS podle zaslané AifoUložky nebo jména, příjmení, data narození a adresy.
POST
/api/Student/StudentZaloz
Vytvoření studenta
PUT
/api/Student/StudentUprav
Upravení studenta
DELETE
/api/Student/StudentSmaz
Smazání studenta
PATCH
/api/Student/IdStudentaNaSkoleUprav
Umožní změnit nebo vložit Identifikaci studenta na škole, jedná se o identifikaci dané školy, jiné školy o této identifikace nebudou vědět
PATCH
/api/Student/RodneCisloKodUprav
Umožní změnit rodné číslo či kód v první řadě u studenta, který studuje pouze na jedné škole a nebyl ztotožněn v ISZR
SLOVENSKý ESIMS
Do souboru ws-config.properties musí přibýt:
# Konfigurace Slovenskeho E-SIMS
esims_sk_check_endpoint_url=https://crs-demo.minedu.dev/api/import/daily/check/
Endpoint URL vede na ten endpoint, na němž se checkuje stav odeslaných dávek. Zde je uveden pro DEMO instanci Slovenského E-SIMS, pro provozní to bude následně podobné URL.
Dále je pak třeba nastavit parametr STAGu "ESIMS_SK_AUTHORIZATION_HEADER", který obsahuje přesně hodnotu hlavičky "Authorization", která se do SIMSu posílá. Což by měl být řetězec složený ze slova "Bearer", mezerou a pak kód obdržený od autority. Například tedy "Bearer kckcviogert24fdg687g".