Bílá kniha ČVUT
Generování BK
Popis generování xml
Globální parametry
Při generování xml souboru se používají tyto globální parametry
- SEM_BK ... semestry akademického roku, pro který se BK generuje. Semestry jsou zapsané vzestupně bez mezer a oddělené středníkem. Např. "B221,B222" .
- SEM_BK2 ... obsahuje semestry akademického roku pro který se generuje připravovaná BK a začátek a konec období v kterém se připravovaná BK generuje. Semestry jsou zapsané vzestupně oddělené středníkem, následuje začátek období ve tvaru DD.MM.RRRR oddělené od semestrů středníkem a konec období ve tvaru DD.MM.RRRR oddělené od začátku středníkem. Zápis je bez mezer.
Fakultní parametry
Používají se následující parametry, které vyplňují jednotlivé fakulty
- BKW_PREHLEDPR ... určuje, jaké předměty se budou zobrazit v BK podle stavu. Obsahuje kódy stavu předmětu N-navržené, S-schválené, U-uzavřené. Kódy se píší v libovolním pořadí bez mezer. Např. "S", "SN", "NSU", atd.
- RVHODINY ... obsahuje začátky a konce jednotlivých vyučovacích hodin. Data jsou zapsaná ve tvaru začátek vyučovací hodiny HH:MI následuje dvojtečka a konec vyučovací hodiny HH:MI. Jednotlivé hodiny jsou oddělené středníkem. Např. 10:00-10:50;11:00-11:50;13:00-13:50 .
- BKW_VOLITELNY_PR_FAK ... v BK zobrazit volitelné předměty fakulty.
Části xml souboru
hlavička
obsahuje
- datum generování BK,
- kód akademického roku pro který se BK generuje,
- semestry akademického roku pro který se BK generuje.
rozvrhové lístky
obsahuje rozvrhové lístky z akademického roku BK, které mají vyplněno
- předmět,
- začátek výuky,
- délku výuky.
organizační jednotky
struktura:
- přehled organizačních jednotek (fakult, ústavů a kateder), které mají vyplněný atribut pořadí,
- za každou organizačnou jednotkou je seznam platných oborů dané fakulty|katedry,
- u každého oboru je seznam platných studijních programů daného oboru,
- na konci seznamu organizačních jednotek je jeden prázdný záznam (katedra),
- za prázdným záznamem je opět seznam fakult s textem pro tělesnou přípravu.
Záznamy jsou setříděny podle atributu pořadí.
studijní programy
seznam obsahuje studijní programy, které
- jsou určeny pro matriku,
- typ studijního programu je B, M, N nebo D,
- podle atributu platnost od a platnost do jsou platné,
- jsou aspoň v jednom schváleném studijním plánu který je exportován do BK.
Za každým programem je seznam studijních plánů daného programu které jsou schválené a mají se exportovat do BK.
studijní plány
přehled obsahuje schválené studijní plány které podle atributu export mají být exportovány do BK.
Poznámka: studijní plán je akivní když jsou na něm studenti se studijním stavem studuje nebo přerušeno.
- za každým studijním plánem je blok rolí
- role je atribut skupin předmětů které jsou v daném studijním plánu,
- nabídka rolí je z číselníku ROLESP.
- skupiny předmětů
- každý blok role obsahuje přehled skupin předmětů s danou rolí které podle atributu export se mají exportovat do BK.
- předměty skupiny předmětů
- každá skupina obsahuje přehled předmětů které patří do dané skupiny,
- přehled předmětů se řídí atributem aktivní studijního plánu (popsáno u studijních plánů),
- je-li plán aktivní, přehled obsahuje všechny předměty skupiny,
- není-li aktivní, obsahuje pouze schválené předměty skupiny.
- u každé skupiny je přehled v kterém semestru kolik, s jakým ukončeným a za kolik kreditů se musí absolvovat předmětů.
předměty
obsahuje všechny předměty instalace bez ohledu na stav předmětu a platnost záznamu.
Pravidla pro generování xml:
- předměty fakulty F4 s kódem začínající na 818 se zobrazují u katedry 24118 (katedra sw inženýrství) bez ohledu na to, u které katedry jsou v DB,
- příznak volitelný předmět se určuje pomocí atributu TPREDMETY.volitelny_pro, TPREDMETY.forma_studia a TPREDMETY.program_id takto:
- je-li volitelny_pro = F a hodnota parametru BKW_VOLITELNY_PR_FAK je A pak příznak volitelný předmet v xml bude mít hodnotu F,
- je-li volitelny_pro = F a hodnota parametru BKW_VOLITELNY_PR_FAK je N nebo parametr BKW_VOLITELNY_PR_FAK na fakultě předmětu není založen, pak příznak volitelný předmet v xml bude mít hodnotu null,
- je-li volitelny_pro = S pak příznak volitelný předmet v xml bude mít hodnotu S,
- jsou-li atributy předmětu forma studia a studijní program prázdné, pak příznak volitelný předmet v xml bude mít hodnotu S,
- Hodnoty pro atribut volitelny_pro jsou
- F ... volitelný předmět pro fakultu,
- S ... volitelný předmět pro celou školu.
- vztahy u předmětu jsou zobrazeny z obou stran, to znamená, že jsou zobrazeny vztahy, když je daný předmět prvním předmětem ve vztahu i vztahy, kde je druhým předmětem ve vztahu.
- vztahy jsou v číselníku TVZTPRED_CIS.
- kredity, způsob zakončení a název předmětu se generuje v tomto pořadí
- z předmětu vypsaného v letním semestru akademického roku BK,
- když není vypsán v letním semestru potom z předmětu vypsaného v zimním semestru akademického roku BK,
- není-li vypsán ani v zimním semestru potom z katalogu předmětů.
- do seznamu vyučujících předmětu se generují
- na první místo se vygeneruje autor návrhu z posledního semestru, kde je autor návrhu vyplněn s maximálním ID osoby,
- potom se ze semestrů akademického roku BK generují všechny vyučující:
- přednášející,
- cvičící,
- zkoušející,
- garanti,
- autoři návrhu.
- k předmětu se vygenerují některé atributy a texty vyučujících ze všech semestrů v kterých je předmět vypsán,
- hodnota značky <export> se generuje z atributu předmětu export takto:
- je-li na druhém místě atributu export hodnota 0 pak příznak v xml bude mít hodnotu 0,
- v ostatních případech hodnotu 9.
- hodnota značky <zobrazit> se generuje takto
- je-li na fakultě předmětu založen parametr BKW_PREHLEDPR a stav předmětu je z tohoto parametru, pak hodnota značky bude A,
- není-li parametr založen a stav předmětu je S, pak hodnota značky bude A,
- v ostatních případech hodnota bude null.
- hodnota značky <jazyk_vyuky_studenta> se určuje
- z atributu předmětu jazyk_vyuky_studenta, je-li vyplněn,
- jinak má hodnotu CS.
vyučující
obsahuje všechny vyučující dané instalace
- u každého vyučujícího se generuje seznam kateder na kterých má daný vyučující nějakou funkci. Tento seznam neobsahuje kmenovou katedru vyučujícího.
- funkce vyučujících jsou z číselníku TFUNUCIT.
funkce vyučujících
obsahuje všechny funkce všech vyučujících na dané instalaci.
podmínky na stud. plány
obsahuje podmínky plnění studijních plánů po jednotlivých rolí a semestrech.
průchody stud. plánem
obsahuje všechny průchody studijních plánů které jsou v BK.
skupiny předmětů
obsahuje všechny skupiny předmětů setříděné podle atributů poradi a nazev.
- u každé skupiny je kromě popisu i přehled předmětů skupiny
- u každé skupiny je i blok podmínek po semestrech na skupinu.
Struktura xml
Formátovací konvence
- Všechny elementy druhé úrovně jsou formátovány jako nadpis čtvrté úrovně (H3). Elementy nižších úrovní jsou poté uvozeny odrážkami s odsazením odpovídajícím úrovni zanoření elementu a sázeny neproporcionálním fontem.
- U každého elementu lze definovat
- [N] -- NOT NULL
- [U] -- UNIQUE
- [N|U] -- kombinace obou
hlavička souboru
<?xml version="1.0" encoding="windows-1250"?>
hlavička
elementy v hlavičce
<datum> ... datum generování xml
<akad_rok> ... akademický rok, pro který se generuje BK
<rozsemy> ... semestry pro které se generuje BK
- rozsem ... ID semestru pro který se generuje BK
<listky>
rozvrhové lístky.
- semestr [N] ... kód zimního/letního semestru, pro který se BK generuje,
- listek ... jeden rozvrhový lístek,
- li_fakulta [N] ... ID fakulty, která rozvrhový lístek vytvořila,
- li_predmet ... ID předmětu, pro který je lístek určen,
- li_prkod ... kód předmětu, pro který je lístek určen,
- li_prnaz ... český název předmětu, pro který je lístek určen,
- li_prnaz_an ... anglický název předmětu, pro který je lístek určen,
- li_mistnost ... číslo místnosti, kam je výuka naplánovaná,
- li_den ... dvoumístná zkratka dne v týdnu, na kdy je výuka naplánovaná,
- li_zacatek ... čas začátku výuky ve tvaru DD:MI,
- li_delka ... délka výuky v minutách,
- li_ucitel ... příjmení a jméno prvního vyučujícího,
- li_kapacita ... nepoužívá se,
- li_typ [N] ... typ rozvrhového lístku, hodnoty jsou z číselníku TYPROZP,
- li_cislo ... číslo rozvrhové paralelky,
- li_poznamka ... poznámka k lístku,
- li_sudylichy ... příznak, jak často se vyučuje (S / L / null = sudý týdny / liché týdny / každý týden),
- li_rocnik ... číslo ročníku, pro který je lístek určen,
- li_skupiny ... číslo studijních skupin (oddělené čárkou), pro které je lístek určen,
- li_mistnaz ... název místnosti, kam je výuka naplánovaná,
- li_lokalita ... název lokality, kam je výuka naplánovaná,
- li_mistnost_web_url ... nepoužívá se,
- li_ucitel_id ... ID prvního vyučujícího,
- li_ucitel2_id ... ID druhého vyučujícího,
- li_ucitel2 ... příjmení a jméno druhého vyučujícího,
- li_rocniky ... seznam ročníků (oddělené čárkou), pro které je lístek určen,
- li_zac_min ... začátek výuky ve tvaru HH:MI,
- li_kon_min ... konec výuky ve tvaru HH:MI,
- li_del_min ... délka výuky v minutách,
- li_pno ... číslo přednáškové paralelky,
- li_cno ... číslo cvičební paralelky,
- li_lno ... číslo laboratorní paralelky,
- li_mist_kod ... kód místnosti, kam je výuka naplánovaná,
- li_poznamka_an ... anglická poznámka k lístku,
- li_rozvrhove_tydny ... pořadová čísla týdnů, kdy skutečně probíhá výuka. NULL=celý semestr, "1"=jen první týden, "2,3,7,10", "1-3,5,8".
<katedry>
organizační jednotky.
- katedra
- katedra_id [N] ... ID organizační jednotky,
- fakulta [N] ... jedná-li se o fakultu/ústavu, obsahuje krátký název fakulty/ústavu, jinak obsahuje krátký název nadřízené fakulty/ústavu,
- fakulta_pln ... jedná-li se o fakultu/ústavu, obsahuje plný název fakulty/ústavu, jinak obsahuje plný název nadřízené fakulty/ústavu,
- fakulta_zkr ... jedná-li se o fakultu/ústavu, obsahuje zkratku fakulty/ústavu, jinak obsahuje zkratku nadřízené fakulty/ústavu,
- fakulta_an ... jedná-li se o fakultu/ústavu, obsahuje krátký anglický název fakulty/ústavu, jinak obsahuje krátký anglický název nadřízené fakulty/ústavu,
- fakulta_pln_an ... jedná-li se o fakultu/ústavu, obsahuje plný anglický název fakulty/ústavu, jinak obsahuje plný anglický název nadřízené fakulty/ústavu,
- fakulta_zkr_an ... jedná-li se o fakultu/ústavu, obsahuje anglickou zkratku fakulty/ústavu, jinak obsahuje anglickou zkratku nadřízené fakulty/ústavu,
- kod ... kód organizační jednotky,
- nazev ... krátký název organizační jednotky. Je-li ID org. jednotky 76 nebo 253, je doplněn o řetězec - Děčín,
- popis ... popis org. jednotky česky,
- nazev_an ... krátký anglický název organizační jednotky. Je-li ID org. jednotky 76 nebo 253, je doplněn o řetězec - Děčín,
- popis_an ... popis org. jednotky anglicky,
- kat_poradi ... pořadové číslo pro třídění při zobrazení org. jednotek,
- typstr [N] ... typ organizační jednotky (číselník EKTYPSTR),
- nadriz ... ID nadřízené organizační jednotky,
- <obory> ... obory dané katedry,
- obor
- obor_id [N] ... ID oboru,
- kod ... kód oboru,
- nazev ... český název oboru,
- typ ... typ studijního programu,
- <programy_id> ... studijní programy pod kterými se daný obor vyučuje,
- program_id ... ID studijního programu,
- zkratka ... zkratka oboru,
- nazev_dipl ... český název oboru pro diplom,
- nazev_dipl_an ... anglický název oboru pro diplom,
- poradi ... pořadí , určující pořadí při tisku oboru na BK,
- charak_cs ... charakteristika oboru - česky,
- charak_an ... charakteristika oboru - anglicky,
- prof_pos ... profesní postavení pro Dodatek k diplomu do kapitoly 5,2 - česky,
- prof_post_en ... profesní postavení pro Dodatek k diplomu do kapitoly 5,2 - anglicky,
- specializace ... příznak, zda se jedná o obor nebo o specializaci (A=specializace, null=obor).
- obor
<programy>
studijní programy,
- program
- program_id [N] ... ID katedry nebo fakulty,
- kod ... interní kód,
- kod_ext ... externí kód,
- typ [N] ... typ programu (číselník TYPSPROG),
- nazev ... česý název,
- nazev_an ...anglický název,
- planovany_titul ... titul, který má obdržet student po absolvování studijního programu,
- jazyk ... jazyk výuky studijního programu
- <stplany_id> ... studijní plány, které jsou určeny pro daný studijní program,
- stplan_id ... ID studijního plánu,
- delka ... délka studia v rocích,
- charakteristika_cs ... charakteristika česky,
- charakteristika_an ... charakteristika anglicky,
- pozadavky_na_prijeti_cs ... požadavky na přijetí česky,
- pozadavky_na_prijeti_an ... požadavky na přijetí anglicky,
- postupy_uznavani_cs ... postupy uznávání česky,
- postupy_uznavani_an ... postupy uznávání anglicky,
- kvalifikacni_pozadavky_cs ... kvalifikační požadavky a předpisy - česky,
- kvalifikacni_pozadavky_cs ... kvalifikační požadavky a předpisy - anglicky,
- profil_programu_cs ... profil programu - česky,
- profil_programu_an ... profil programu - anglicky,
- klicove_vysledky_cs ... hlavní výsledky učení - česky,
- klicove_vysledky_an ... hlavní výsledky učení - anglicky,
- prof_profil_abs_cs ... profesní profil absolventů - česky,
- prof_profil_abs_an ... profesní profil absolventů - anglicky,
- pristup_k_dalsimu_stud_cs ... přístup k dalšímu studiu - česky,
- pristup_k_dalsimu_stud_an ... přístup k dalšímu studiu - anglicky,
- pravidla_hodnoceni_cs ... pravidla zkoušení, hodnocení a klasifikace - česky,
- pravidla_hodnoceni_an ... pravidla zkoušení, hodnocení a klasifikace - anglicky,
- pozadavky_na_ukonceni_cs ... požadavky na ukončení studia - česky,
- pozadavky_na_ukonceni_an ... požadavky na ukončení studia - anglicky,
- charak_cs ... charakteristika česky,
- charak_an ... charakteristika anglicky,
- koordinator ... koordinátor programu,
- garant ...garant programu,
- fakulta_id [N] ... ID fakulty vlastníka programu,
- profil_kod ... kód profilu programu (číselník PROG_PROFIL),
- profil_txt ... profil programu slovy,
- oblast_vzdelani_kod ... kód převládající oblasti vzdělání (číselník PROG_OBLAST_VZDELANI),
- oblast_vzdelani_txt ... převládající oblast vzdělání - slovy,
- zamereni_kod ... Study in Prague - kategorie zaměření/zařazení programu - kód (číselník SIP_ZARAZENI),
- zamereni_txt ... Study in Prague - kategorie zaměření/zařazení programu - slovy.
<stplany>
studijní plány.
- stplan
- parametr podminka_exp ... kód pro export studijního plánu (číselník EXPORTBK),
- stplan_id [N] ... ID studijního plánu,
- program_id ... ID studijního programu, pro který je studijní plán určen,
- obor_id ... ID studijního oboru, pro který je studijní plán určen,
- ob_garant_titul ... titul garanta oboru,
- ob_garant_prijmeni ... priíjmení garanta oboru,
- ob_garant_jmeno ... jméno garanta oboru,
- ob_garant_titulza ... titul za jménem garanta oboru,
- <bloky> ... role skupin předmětů v daném studijním plánu ,
- blok
- role [N] ... kód role (číselník ROLESP),
- <skupiny> ... skupiny předmětů v daném bloku,
- skupina
- skupina_id [N] ... ID skupiny předmětů,
- nazev ... název skupiny předmětů,
- <vs_predmet> ... předmět skupiny předmětů,
- kod ... kód předmětu,
- nazev ... český název předmětu,
- nazev_an ... anglický název předmětu,
- <neurcene>
- <predmet_id> ... id predmetu
- <podminky> ... podmínky na skupinu předmětů,
- podminka
- rozsah ... nepoužívá se,
- zpuszak ... způsob zakončení předmětu,
- kredity ... počet kreditů v podmínce na daný semestr,
- pocet_pr ... počet předmětů v podmínce na daný semestr,
- podminka
- skupina
- nazev_bloku ... popis role,
- blok
- minpockred ... minimální počet kreditů pro úspěšné absolvování studijního plánu,
- forma_studia ... forma studia pro kterou je studijní plán určen (číselník FSTUD),
- poznamka_pl ... poznámka,
- nazev_pl ... český název studijního plánu,
- nazev_pl_an ... anglický název studijního plánu.
<predmety>
předměty celé instalace.
- predmet
- predmet_id [N] ... ID předmětu,
- kod ... kód předmětu,
- nazev [N] ... český název,
- nazev_an ... anglický název,
- kredity ... počet kreditů za absolvování předmětu,
- rozsah ... rozsah výuky,
- rozsah_popis ... český popis rozsahu výuky,
- rozsah_popis ... anglický popis rozsahu výuky,
- zpuszak ... způsob zakončení (číselník ZPUSZAK),
- <texty> ... texty předmětu,
- anotace ... anotace česky,
- anotace_an ... anotace anglicky,
- pozadavky ... požadavky česky,
- pozadavky_an ... požadavky anglicky,
- osnova ... osnova česky,
- osnova_an ... osnova anglicky,
- osnova_cv ... osnova pro cvičení česky,
- osnova_cv_an ... osnova pro cvičení anglicky,
- literat ... literatura česky,
- literat_an ... literatura anglicky,
- cile ... cíle výuky česky,
- cile_an ... cíle výuky anglicky,
- obsah ... obsah výuky česky,
- obsah_an ... obsah výuky anglicky,
- ects_pozadavky_cs ... požadavky ECTS česky,
- ects_pozadavky_an ... požadavky ECTS anglicky,
- ects_kriteria_cs ... metody a kritéria hodnocení (zápočet, kl. zápočet, zkouška) - česky,
- ects_kriteria_an ... metody a kritéria hodnocení (zápočet, kl. zápočet, zkouška) - anglicky,
- ects_prac_staze_cs ... pracovní stáže - česky,
- ects_prac_staze_an ... pracovní stáže - anglicky,
- poznamka_text_cs ... poznámka - dlouhý text - česky,
- poznamka_text_an ... poznámka - dlouhý text - anglicky,
- ects_nepov_slozky_cs ... nepovinné složky programu - česky,
- ects_nepov_slozky_an ... nepovinné složky programu - anglicky,
- ects_pl_cinnosti_cs ... plánované činnosti - česky,
- ects_pl_cinnosti_an ... plánované činnosti - anglicky,
- ects_zp_uskutecneni_cs ... způsob uskutečnění - česky,
- ects_zp_uskutecneni_an ... způsob uskutečnění - anglicky,
- zlsem ... předmět se vyučuje v zimním (Z), letním (L) nebo v obou semestrech (null),
- <sem_idy> ... vybrané atributy a texty vyučujících po semestrech,
- sem_idx,
- sem_id [N] ... ID semestru v kterém je předmět vypsán,
- bezrozvrhu ... příznak, že se předmět nerozvrhuje (A/null),
- volitelny_pro ... příznak, zda je předmět volitelný a pro koho (F=fakulta, S=škola),
- <texty_ucitelu> ... texty vyučujících k předmětu v daném semestru,
- text_uci1,
- text_uci_id [N] ... ID vyučujícího, který text napsal,
- text_uci_txt ... text,
- text_jazyk ... kód jazyku v kterém je text napsaný (CS-česky, EN-anglicky).
- text_uci1,
- sem_idx,
<ucitele>
vyučující celé instalace.
- ucitel
- ucitel_id [N] ... ID vyučujícího,
- katedra_id ... ID kmenové katedry vyučujícího a ID kateder, na kterých má vyučující funkci,
- titul_pred ... titul před jménem,
- jmeno ... jméno,
- prijmeni ... příjmení,
- titul_za ... titul za jménem,
- osobni_cislo ... osobní číslo,
- email ... email,
- telefon ... číslo telefonu,
- umelecke_jmeno ... umělecké jméno,
- ssu_uid ... univerzální unikátní identifikátor osoby.
<funkce_ucitelu>
funkce vyučujících celé instalace.
- podm
- podm_id [N] ... ID vyučujícího,
- katedra_id ... ID katedry, kde má vyučující danou funkci,
- funkce ... funkce vyučujícího.
<stplpodmrole>
podmínky na plnění studijního plánu po semestrech.
- podm
- podm_id [N] ... ID podmínky,
- podm_stplan_id ... ID studijního plánu,
- podm_role ... kód role předmětů ve studijním plánu,
- podm_semestr ... kód semestru pro který podmínka platí (nemusí být vyplněný),
- podm_minkred ... minimální počet absolvovaných předmětů pro splnění části stud. plánu, určenou danou rolí,
- podm_minpredm ... minimální počet absolvovaných předmětů pro splnění části stud. plánu, určenou danou rolí.
- ... ,
- ... ,
- ... ,
- ... ,
- ... ,
- ... ,
- ... ,
- ... ,
- ... ,
- ... ,
- ... ,
- ... ,
- ... ,
- ... ,
- ... ,
... pokračování