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í texty učitelů 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>

přehled organizačních jednotek, které mají vyplněný atribut pořadí,

• katedra
  • katedra_id [N] ... ID katedry nebo fakulty,
  • fakulta [N] ... jedná-li se o fakultu, obsahuje krátký název fakulty, jinak obsahuje krátký název nadřízené fakulty,
  • fakulta_pln ... jedná-li se o fakultu, obsahuje plný název fakulty, jinak obsahuje plný název nadřízené fakulty,
  • fakulta_zkr ... jedná-li se o fakultu, obsahuje zkratku fakulty, jinak obsahuje zkratku nadřízené fakulty,
  • fakulta_an ... jedná-li se o fakultu, obsahuje krátký anglický název fakulty, jinak obsahuje krátký anglický název nadřízené fakulty,
  • fakulta_pln_an ... jedná-li se o fakultu, obsahuje plný anglický název fakulty, jinak obsahuje plný anglický název nadřízené fakulty,
  • fakulta_zkr_an ... jedná-li se o fakultu, obsahuje anglickou zkratku fakulty, jinak obsahuje anglickou zkratku nadřízené fakulty,
  • 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,
      • ...
      • ...
      • ...
      • ...