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

---

<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,
      • nazev_bloku ... popis role,
  • 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).

---

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

• funkce_ucitele
  • ucitel_id [N] ... ID vyučujícího,
  • katedra_id ... ID katedry, kde má vyučující danou funkci,
  • funkce ... funkce vyučujícího.

• • ... ,
  • ... ,
  • ... ,
  • ... ,
  • ... ,

... pokračování