Bílá kniha ČVUT

Z Nápověda KOS
Skočit na navigaci Skočit na vyhledávání

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.

  • 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í