Zadávání známek a zápočtů — Hromadný zápis známek a zápočtů

Na seznam témat a kapitol (obsah)Nadřízená kapitola

Úvod

Aplikace Hromadný zápis známek a zápočtů slouží vyučujícím a uživatelům s rolí katedra k hromadnému vkládání hodnocení zkoušek a zápočtů. Aplikace je alternativou k možnosti vkládat hodnocení ručně pomocí webového formuláře. Oba možné způsoby vkládání hodnocení jsou integrovány na společné portletové stránce.

Potenciální výhoda hromadného uložení hodnocení spočívá v tom, že uživatel může hodnocení doplnit v externím programu, pokud je pro něj práce s webovým formulářem nepohodlná nebo nemožná (např. pokud není k dispozici internetové připojení).

Zadávání hodnocení webovým formulářem přímo v portálu nebo exportem, doplněním v externím programu a načtením zpět do portálu.

Obrázek 164. Zadávání hodnocení webovým formulářem přímo v portálu nebo exportem, doplněním v externím programu a načtením zpět do portálu. 

Jsou podporovány dva formáty pro přenos dat:

  • CSV — lze rovnou otevřít a editovat v MS Excel. POZOR — jako oddělovač se v případě CSV používá středník, nikoliv čárka (čárka se totiž v českých verzích používá i jako oddělovač desetinných čísel).

  • XML — pro strojové zpracování.

Portlet poskytuje seznamy studentů a jejich exporty.

Obrázek 165. Portlet poskytuje seznamy studentů a jejich exporty. 

Formát CSV

Formát CSV byl zvolen především proto, že jej lze přímo otevřít v programu MS Excel, kde je pak zobrazen přehledně jako tabulka. V Excelu uživatelé (vyučující) doplní potřebné údaje, soubor uloží a poté prostřednictvím portletu nahrají do IS/STAG.

Formát CSV má bohužel také svoje nevýhody — nikde není specifikován přesný formát jednotlivých sloupců, takže je například velký problém při zpracování položek datum, které jsou zapsány v každém jazyce jinak a nelze přesně určit, v jakém z nich chceme, aby Excel data ukládal. Přesnější popis formátu CSV lze získat ve Wikipedii.

Jako oddělovač se v případě CSV používá znak středník, nikoliv čárka. Čárka se totiž v českých verzích používá i pro desetinná čísla a docházelo by tak k problémům. České verze MS Excel používají ve výchozím případě také středník, proto je použit i v IS/STAG.

Tabulka seznamu studentů ve formátu CSV

Barevné značení v obrázcích:

  1. Povinné položky — MUSÍ BÝT ZADÁNY (při načítání souboru do IS/STAG nesmí chybět).

  2. Nepovinné položky — MOHOU BÝT ZADÁNY (pokud jsou uvedeny, přenáší se do IS/STAG).

  3. Informativní — pro orientaci uživatele v tabulce (při načítání do IS/STAG jsou ignorovány).

Soubor CSV načtený do Excelu je zobrazen jako tabulka, kterou lze rozdělit na tři části
  • Část určující předmět a studenta: 

    • katedra — zkratka katedry/pracoviště

    • zkratka — zkratka předmětu

    • rok — rok varianty předmětu

    • semestr — zkratka semestru (ZS, LS)

    • os_cislo — osobní číslo studenta

    • jmeno — jméno studenta

    • prijmeni — příjmení studenta

    • titul — titul studenta

    • nesplnene_prerekvizity — seznam nesplněných podmiňujících předmětů

    CSV: Část určující předmět a studenta

    Obrázek 166. CSV: Část určující předmět a studenta. 

  • Část o zkoušce/zápočtu: položky — pro informace o ZKOUŠCE NEBO ZÁPOČTU (je-li předmět zakončen pouze zápočtem):

    • zk_typ_hodnoceni — typ hodnocení zkoušky, udává zda se zkouška hodnotí Známkou či Slovně. V případě hodnocení známkou musí vyučující do položky s hodnocením uložit známku, v případě slovního hodnocení uloží buď S (splnil) nebo N (nesplnil).

    • zk_hodnoceni — hodnocení zkoušky, dle stupnice dané školy, nejčastěji hodnoty 1, 2, 3 nebo 4. V případě slovního hodnocení buď S (splnil) nebo N (nesplnil).

    • zk_body — body získané u zkoušky. Jedná se o číslo, které může případně mít až dvě desetinná místa — POZOR — zde stačí, aby byla uvedena jen jedna z těchto dvou povinných položek.

    • zk_datum — datum udělení zkoušky. Ve formátu DD.MM.YYYY (den.měsíc.rok). Pokud není uveden, pak se při nahrávání známky do IS/STAG systém pokusí datum automaticky doplnit — doplní datum posledního platného zkouškového termínu, na kterém byl student na daném předmětu zapsán (na termínu, který již proběhl). Pokud student nebyl na žádném termínu, systém nedovede datum zjistit a nahrání této položky skončí s chybou — datum bude třeba v Excelu dopsat ručně.

    • zk_pokus — na kolikátý pokus byla zkouška absolvována (1-9). Při exportu z IS/STAG se v případě, že student ještě nemá v IS/STAG zapsanou žádnou známku, vygeneruje automaticky navrhované číslo pokusu (systém spočítá, na kolika termínech student již byl. Pokud nebyl na žádném, navrhne nulu). Pokud není položka pokus vyplněna, dojde při nahrávání do IS/STAG k určení hodnoty automaticky — uloží se počet platných termínů, na kterých student doposud byl. Pokud na žádném nebyl, skončí nahrání rovněž s chybou.

    • zk_ucit_idno — číslo (ID) učitele (UCITIDNO v IS/STAG), který hodnocení uděluje. Tuto položku můžete nechávat nevyplněnou vždy — při nahrávání do IS/STAG je automaticky nahrazena číslem toho učitele, který je v portálu přihlášen. Vyučující nemá možnost zadávat známky za jiného vyučujícího, proto buď musí nechat položku nevyplněnou anebo zapsat své vlastní číslo. Pouze uživatel pracující pod rolí katedra musí ID učitele, za kterého hodnocení uděluje, uvést. Zjištění ID čísla učitele

    • zk_jazyk — Jazyk, ve kterém student předmět absolvoval (tj. ve kterém byl předmět vyučován).

    • zk_ucit_jmeno — Příjmení a jméno učitele, který hodnocení udělil. Pouze informativní údaj při exportu dat. Při importu do IS/STAG se zcela ignoruje.

    CSV: Část o zkoušce/zápočtu

    Obrázek 167. CSV: Část o zkoušce/zápočtu. 

    Pokud chce vyučující zapsat známku, MUSÍ vyplnit ALESPOŇ jednu z položek zk_hodnoceni nebo zk_body. Ostatní (modré — nepovinné) položky jsou ve většině situací doplněny automaticky (viz popis jednotlivých položek). Naopak, pokud položka zk_hodnoceni ani položka zk_body vyplněny či uvedeny NEJSOU, pak k zápisu známky nedochází (tj. nedochází k žádné změně stavu v IS/STAG) a na obsahu dalších položek již nezáleží.

  • Část o zápočtu před zkouškou: pro uložení informace o ZÁPOČTU PŘED ZKOUŠKOU

    • zppzk_hodnoceni — hodnocení zápočtu před zkouškou. Musí obsahovat hodnoty buď S (splnil) nebo N (nesplnil)

    • zppzk_datum — analogie, viz minulý odstavec

    • zppzk_pokus — analogie, viz minulý odstavec. S jediným rozdílem: U zápočtu před zkouškou pokud pokus není vyplněn a student ani nebyl na žádném z termínů zápočtu před zkouškou, tak nedojde k chybě jako v případě zkoušky, ale nastaví se číslo pokusu na 1.

    • zppzk_ucit_idno — analogie, viz minulý odstavec

    • zppzk_ucit_jmeno — Příjmení a jméno učitele, který hodnocení udělil. Pouze informativní údaj při exportu dat. Při importu do IS/STAG se zcela ignoruje.

    CSV: Část o zápočtu před zkouškou (ZppZk)

    Obrázek 168. CSV: Část o zápočtu před zkouškou (ZppZk). 

    Pokud chce vyučující zapsat zápočet před zkouškou, MUSÍ vyplnit alespoň položku zppzk_hodnoceni. Ostatní (modré — nepovinné) položky jsou ve většině situací doplněny automaticky (viz popis jednotlivých položek). Naopak, pokud položka zppzk_hodnoceni vyplněna či uvedena NENÍ, pak k zápisu zápočtu před zkouškou nedochází (tj. nedochází k žádné změně stavu v IS/STAG) a na obsahu dalších položek již nezáleží.

Pokud na nějaké řádce nic uživatel nezmění, tak se také po nahrání souboru nezmění nic v IS/STAG. Položky, které jsou v okamžiku nahrávání shodné se stavem v IS/STAG, se v něm nijak neaktualizují.

Pokud u zkoušky není vyplněno hodnocení ani body, pak to také znamená, že se údaj o zkoušce v IS/STAG nebude měnit (stejně tak v případě zápočtu a jeho hodnocení). Není to tedy tak, že by se údaje o zkoušce z IS/STAG odstranily. Hromadným načtením hodnocení není možné informaci již uloženou v IS/STAG zrušit (smazat) — k tomu je třeba použít původní aplikaci pro zadávání hodnocení prostřednictvím webového formuláře.

Formát XML

Datová struktura je jednoduchá — jedná se o seznam libovolného množství jednotlivých záznamů, přičemž jeden záznam (element student_na_predmetu) obsahuje podelementy, které přesně odpovídají (názvem i pořadím) sloupečkům, které byly popsány u formátu CSV. XML soubory musejí být vždy kódovány v UTF-8.

Všechny položky mají stejný význam a stejná pravidla (povinné/nepovinné/informativní) jako u formátu CSV.

Je k dispozici XML Schéma, které až na jednu drobnou odlišnost platí pro XML použité zde v portletu pro Hromadný zápis známek i ve Webové službě nad IS/STAG v příslušné službě (na ZČU viz https://stag-ws.zcu.cz).

<?xml version="1.0" encoding="UTF-8"?>

<ns1:zapis_znamek xmlns:ns1="http://stag-ws.zcu.cz/">
  <znamky>
    <student_na_predmetu>
      <katedra>KIV</katedra>
      <zkratka>PPA1</zkratka>
      <rok>2007</rok>
      <semestr>ZS</semestr>
      <os_cislo>A05551</os_cislo>
      <jmeno>Veronika</jmeno>
      <prijmeni>Novotná</prijmeni>
      <titul></titul>
      <nesplnene_prerekvizity></nesplnene_prerekvizity>
      <zk_typ_hodnoceni>Známkou</zk_typ_hodnoceni>
      <zk_datum>15.5.2008</zk_datum>
      <zk_pokus>1</zk_pokus>
      <zk_hodnoceni>2</zk_hodnoceni>
      <zk_body>85.3</zk_body>
      <zk_ucit_idno></zk_ucit_idno>
      <zk_jazyk></zk_jazyk>
      <zppzk_datum>10.5.2008</zppzk_datum>
      <zppzk_pokus>1</zppzk_pokus>
      <zppzk_hodnoceni>S</zppzk_hodnoceni>
      <zppzk_ucit_idno></zppzk_ucit_idno>
    </student_na_predmetu>
  </znamky>
</ns1:zapis_znamek>

Příklad 1. Příklad XML

Hromadné načtení hodnocení

Portlet Hromadný zápis známek a zápočtů do IS/STAG
Portlet Hromadný zápis známek a zápočtů do IS/STAG

Obrázek 169. Portlet Hromadný zápis známek a zápočtů do IS/STAG. 

Portlet obsahuje dvě záložky. V první je formulář sloužící k nahrání CSV (nebo XML) souboru s vyplněnými daty do IS/STAG. Vyberte tedy soubor ze svého souborového systému a klikněte na tlačítko Nahrát hromadné známky.

Na tlačítko klikněte pouze jednou a vyčkejte. Operace může trvat delší dobu a to v závislosti na počtu záznamů v odeslaném souboru. Maximální velikost takto nahraného souboru je 5 MB.

Portlet nejprve zkontroluje odeslaný soubor po formální a syntaktické stránce a pak postupně odesílá položky do IS/STAG. Generuje průběžně informace o průběhu tohoto procesu, které se zobrazí ihned po jeho ukončení. Pak se přímo v portletu objeví informace o posledním proběhlém načtení známek — datum a čas, počet všech položek, počet položek úspěšně vložených do IS/STAG a poté informace a případná chybová hlášení pro jednotlivé položky. Tento seznam je možné zkopírovat ze stránky, chybné položky opravit a nahrát znovu. Portlet umožňuje otevřít výsledek hromadného zápisu známek ve verzi pro tisk.

Hromadný zápis známek a zápočtů — chyby

Obrázek 170. Hromadný zápis známek a zápočtů — chyby. 

Zjištění ID učitele
Vyhledání ID učitele

Obrázek 171. Vyhledání ID učitele. 

Záložka Vyhledání ID učitele se týká především uživatelů s rolí katedra. Protože do CSV a XML souborů musí vkládat i informaci o vyučujícím, za kterého načítají soubor s hodnocením — v souboru se uvádí přímo identifikátor (ID) daného učitele, pod kterým je veden v IS/STAG — tzv. ucitidno. Záložka obsahuje jednoduchý vyhledávací formulář pro nalezení učitele a jeho ID (pracoviště a příjmení, součástí je dohledávač).

Ukázkový postup — zápis známek krok za krokem

Zde najdete jednoduchý a stručný popis postupu, jak použít aplikaci pro hromadný zápis známek a zápočtů. Detailní informace k jednotlivým krokům jsou popsány v předchozích kapitolách:

  1. Stažení aktuálních dat z IS/STAG. — které skupině studentů chcete zapisovat známky:

    • Studentům na některém z mých zkouškových termínů — klikněte na odkaz CSV ve sloupci Export v portletu Seznam termínů, předmětů a rozvrhových akcí.

    • Studentům na nějaké rozvrhové akci, např. na vašem cvičení — v portletu Seznam termínů, předmětů a rozvrhových akcí na záložce Předměty a rozvrhové akce si přepnete zobrazení na seznam rozvrhových akcí a u příslušné akce si stáhněte potřebný CSV soubor.

    • Studentům na celém předmětu — v portletu Seznam termínů, předmětů a rozvrhových akcí na záložce Předměty a rozvrhové akce si přepněte zobrazení na seznam předmětů a u příslušného předmětu si stáhněte potřebný CSV soubor.

  2. Uložení dat na disk: ve všech předchozích případech vám prohlížeč nabídne uložení nebo otevření souboru. Uložte si soubor na vámi zvolené místo, odkud jej později otevřete.

  3. Otevření v Excelu: otevřete uložený soubor:

    • Spusťte program MS Excel a zvolte v menu položku Soubor/otevřít, najděte vámi uložený soubor a otevřete jej.

    • NEBO: Poklepejte myší na název vámi uloženého souboru v Průzkumníku souborů nebo jiném programu pro správu souborů, který používáte.

    Excel načte soubor a zobrazí jeho obsah formou výše popsané tabulky.

  4. Vyplnění údajů: měňte pouze ty údaje, které chcete do IS/STAG načíst. Ostatní údaje, které nezměníte, zůstanou v IS/STAG rovněž nezměněné.

    • Chcete-li zapsat zápočet před zkouškou (jen u předmětů zakončených Zk+Zp), vyplňte u každého studenta sloupeček zppzk_hodnoceni — ten jediný je povinný.

      V případě, že studenti nebyli zapsáni na nějaké termíny zápočtu před zkouškou (což často nebývají), musíte vyplnit i sloupečky zppzk_datumzppzk_pokus. Pokud na nějakém termínu zapsaní byli, je možné nechat i tyto dva sloupečky nevyplněny a při hromadném zápisu budou automaticky nastaveny (viz popis položek v kapitole Formát CSV).

    • Chcete-li zapsat zkoušku (u předmětů zakončených Zk nebo Zk+Zp) či zápočet (u předmětů zakončených Zp), vyplňte u každého studenta sloupeček zk_hodnoceni (případně i zk_body).

      Pokud vyplňujete údaje u studentů, kteří byli na zkouškovém termínu, můžete nechat zbylé sloupce nevyplněné a ty budou doplněny dle údajů jejich posledního absolvovaného zkouškového termínu. Nechcete-li této možnosti využít, vyplňte opět i sloupečky zk_datumzk_pokus. Podrobné informace o doplňování viz kapitola Formát CSV.

  5. Nahrání do IS/STAG: v portletu Hromadný zápis známek a zápočtů se přepněte na záložku Zápis známek, do formuláře vyberte soubor, který jste připravili v předešlém kroku a klikněte na tlačítko Nahrát hromadné známky.

  6. Kontrola výsledku: po nahrání souboru zkontrolujte dle výpisu portletu, zda nedošlo u nějaké z položek k problému, podle chybového hlášení opravte soubor dat a výše popsanými kroky v Excelu soubor znovu nahrajte do IS/STAG.