miniSTAG Předmět: / Č.studenta: Filtr: ▼ Další hledání...	Toto nejsou oficiální stránky Studijní agendy :-). Více... ⚿ Nepřihlášený

DEMO - Pozor, prezentovaná data nejsou z ostré databáze

miniAPI

Kromě prohlížení WWW stránek miniSTAGu se dají data ze STAGu prostřednictvím miniSTAGu získat (a zformátovat) ještě jedním způsobem, který popisuji na této stránce. Jde vlastně jen o rozhraní, které umožňuje dostat se přímo k obsahu "tabulek", se kterými miniSTAG interně pracuje (což jsou dále v zásadě pouze nějakým způsobem přejmenované a popřípadě částečně zpracované výstupy z XML/CSV tabulek poskytovaných Webovými službami nad IS/STAG).

Přístup k datům funguje na základě zaslání vhodně sestaveného požadavku na určitou URL adresu. Jako usnadnění jsou u tabulek na WWW stránkách miniSTAGu (vždy pod tabulkou) uvedeny odkazy na "formulář" usnadňující přístup k tomuto rozhraní.

Pozn: Získavat data způsobem popsaným na této stránce je možné i z již přefiltrovaných tabulek.

Stručně

Data jako taková lze získat na adrese, která začíná

http://stat.kma.zcu.cz/demoStag/api/

a za kterou následuje otazník a pak seznam parametrů (nebo dvojic parametr=hodnota) oddělených znakem &.

Pomocí parametrů určíme

co hledáme - parametr q, např. q=StudP|KMA|MA2|2009|LS
jaké položky má obsahovat výstup (parametr pol) a jak má být zformátován - csv, html, tex, php, json; lze také uvést format=vlastní formát
další upřesnění jako výpis po sloupcích místo po řádcích (cols) nebo vstupní a výstupní kódování (ie, oe).

Než přijde kapitolka s popisem parametrů, nejlépe asi podívat se nejprve na několik příkladů.

Př. 1: Tabulka

K získání výpisu jmen a příjmení studentů nějakého předmětu v podobě HTML tabulky zavoláme

http://stat.kma.zcu.cz/demoStag/api/?q=StudP|KMA|MA2|2009|LS&pol=jm,prijm&html

Vyzkoušet

Př. 2: TeX

Výpis diplomek katedry s řádky ve tvaru \entry{jméno}{příjmení}{název}{vedoucí} ke zpracování v TeXu

http://stat.kma.zcu.cz/demoStag/api/?q=DiplK|KMA|2008&pol=jm,prijm,tit,vedprijm&tex

Vyzkoušet

Př. 3: Vlastní seznamy, e-maily a další..

Pomocí jednoduchého formátovacího jazyka můžeme z dostupných položek vyrobit např. seznam emailů studentů, když oproti Př. 1 místo dvojice parametrů pol a html uvedeme vhodnou definici formátu v parametru format

...?q=StudP|KMA|TP|2008|LS&format=Student [stud]: [jm] [prijm][9][zkr][10] ...?q=StudP|KMA|TP|2008|LS&format=[jm] [prijm] <[ori]@students.zcu.cz>,[10]

Vyzkoušet Vyzkoušet

a můžeme také používat jednoduché podmínky, např. označit kombinované studenty, vynechat studenty se jménem Pavel, nebo se pokusit naivně o výpis studentek

...?q=StudP|KMA|TP|2008|LS&format=[prijm] [jm][?forma=K] - komb.[/forma][10] ...?q=StudP|KMA|TP|2008|LS&format=[!jm=Pavel][i]. [jm] [prijm][10][/jm] ...?q=StudP|KMA|TP|2008|LS&format=[?prijm~*ova][jm] [prijm][10][/prijm]

Vyzkoušet Vyzkoušet Vyzkoušet

Př. 4: Kombinace více tabulek

Do zformátovaného výpisu můžeme doplnit i informace z další tabulky a rozhodovat podle nich - např.

vypsat studenty předmětu FIPM (2. roč.), a označit hvězdičkou ty, kteří měli zároveň zapsaný i předmět MA2 (tj. jejich osobní číslo (kódované v položce stud) se vyskytuje i v seznamu studentů MA2):
...?q=StudP|KMA|FIPM|2007||[roc=2]&format=[i]. [stud] [jm] [prijm][@A=StudP|KMA|MA2|2007][?stud=[A.stud]] *[/stud][/A][10]
Vyzkoušet

Tato další tabulka dokonce může být u každého studenta jiná (doba načtení dat pak bude příslušně delší) - např.

diplomanti katedry matematiky a u každého které předměty cizích kateder měl zapsané
...?q=StudP|KMA|DPMA|2009&format=[stud] [jm] [prijm] [zkr][@A=PredmS|[stud]|2009][!A.kat=KMA][10] [A.kred] [A.kat] [A.predm][9][A.tit][/A.kat][/A][10][10]
Vyzkoušet
studenti z určitého seznamu (např. studenti z nějakého termínu) a na jaké zkouškové termíny z M1 se přihlásili
...?q=StudT|777197&format=[stud] [jm] [prijm][@A=TermP|KMA|M1|2010][?A.plat=A][?A.typ=Zk][@B=StudT|[A.term]][?stud=[B.stud]][10] [A.den] [A.dat] - [A.prijm][/stud][/B][/A.typ][/A.plat][/A][10][10]
Vyzkoušet
studenti daného zkouškového termínu a na jaké zkouškové termíny všech předmětů se přihlásili
...?q=StudT|777797&format=[stud] [jm] [prijm][@A=TermS|[stud]|2010][?A.plat=A][?A.typ=Zk][10] [A.den] [A.dat][9] [A.kat]/[A.predm] - [A.prijm][/A.typ][/A.plat][/A][10][10]
Vyzkoušet
diplomanti katedry KMA a jejich diplomky a závěrečné zkoušky
...?q=StudP|KMA|DPMA|2009<&format=[stud] [jm] [prijm] [zkr][@C=DiplK|KMA|2009][?stud=[C.stud]][10] [C.tit] ([C.vedprijm])[/stud][/C][@A=PredmS|[stud]|2009][?A.kred=0][10] [A.kat]/[A.predm][9][A.tit][/A.kred][/A][10][10]
Vyzkoušet
seznam státnicových předmětů KMA a studenti, kteří je mají zapsané
...?q=InfoPK|KMA|2010&format=[?zk~statn*][kat]/[predm] [tit][10]----------------------------------[@B=StudP|[kat]|[predm]|2010][10][B.stud] [B.jm] [B.prijm][/B][10][10][/zk]
Vyzkoušet

Př. 5: Použití umělé tabulky

Můžeme vygenerovat umělou tabulku včetně názvů sloupečků a použít ji např. k navázání "stejných" výpisů pro dva předměty po sobě.

...?q=TabCo|kat,predm|KMA,PSF;KIV,FIN&csv ...?q=TabCo|kat,predm|KMA,PSF;KIV,FIN&format=[predm][10][@A=StudP|[kat]|[predm]|2013][A.stud] [A.jm] [A.prijm][10][/A]

Vyzkoušet Vyzkoušet

Př. 6: Počítací tabulka

Můžeme vygenerovat tabulku shrnující údaje z jiné tabulky. Např. k tabulce obsahují seznam rozvrhových akcí předmětu můžeme vygenerovat počet rozvrhových akcí podle typu rozvrhové akce a vyučujícího (tabulka četností), nebo spočítat celkové počty studentů zapsaných na akcích daného typu a učitele (tabulka součtů):

...?q=CountTab|AkceP%7CKMA%257CPSA%257C2020||typ,uc,prijm&csv ...?q=SumTab|AkceP%257CKMA%257CPSA%257C2020|obs%2Cplan|typ%2Cuc%2Cprijm&format=[predm][10][@A=StudP|[kat]|[predm]|2013][A.stud] [A.jm] [A.prijm][10][/A]

Vyzkoušet Vyzkoušet

Hodnoty parametrů by měly být zakódované pro použití v URL (týká se asi hlavně speciálních znaků, případně písmen s diakritikou).

Parametry

q
Označení dat, která chceme získat. Vždy označení tabulky a parametry, ve tvaru
```
<co><čeho>|<par1>|<par2>|...|<rok>|<semestr>|<filtr>
```
Např. seznam studentů předmětu KMA/MA1 v LS 2009/2010 (<co> jsou studenti, <čeho> je předmětu), případně z nich jen druháci a prezenční
q=StudP|KMA|MA1|2009|LS q=StudP|KMA|MA1|2009|LS|[roc=2][forma=P]
Jsou to ta označení, která lze na WWW stránkách miniSTAGu vidět jako parametr prev v URL adrese odkazované stránky při zvolení některé položky v seznamu. Jako tabulku do parametru q lze použít i umělou tabulku TabCo|..|...|
Nejsnazší asi je najít vhodnou tabulku na WWW stránkách miniSTAGu a použít v úvodu zmíněný odkaz pod příslušnou tabulkou. Tyto odkazy právě označení konkrétní tabulky do formuláře vyplňují.

pol

Seznam položek, které se (v případě předdefinovaných formátů) mají vypsat.

Např.

  pol=jm,prijm,stud

Názvy a význam položek je třeba vyspekulovat, popř. vyhledat v předdefinovaných výstupech (php, viz níže), několik nejčastějších:

[i] číslo řádku

[jm] jméno
[prijm] příjmení
[stud] osobní číslo studenta
[uc] číslo učitele ve STAGu
[ori] orion login
[roc] ročník studia [kat] katedra
[predm] předmět
[rok] rok
[sem] semestr

[kod] kód studijního programu
[cislo] číslo oboru (obsahuje i písmena :-)
[zkr] zkratka oboru
...

Není-li uvedena žádná položka, vypíšou se položky všechny.

výstupní formáty (předdefinované)
Formátování výstupu lze zajistit buď pomocí textu s formátovacími značkami (zapsaného do parametru format), anebo prostřednictvím předdefinovaných formátů. Předdefinový formát zvolíme uvedením některého z parametrů
- csv - jako hodnoty oddělené středníkem
- html - jako HTML tabulka (tedy <table>...</table>)
- tex - zformátované do řádků tvaru \entry{pol1}{pol2}...
- php - k načtení jako PHP kód
- json - k načtení jako JavaScript
Které položky a v jakém pořadí se mají vypsat, lze upřesnit pomocí parametru pol.
Je možné také psát např. json=název_funkce - v tom případě bude výstup zapsán do závorek jako argument uvedené funkce. Tedy uvedení hodnot k parametrům
json=zpracuj resp. php=zpracuj
způsobí výstup ve tvaru
zpracuj ( ... ) resp. <?php zpracuj ( ... ) ?>
Podobně tex=\příkaz způsobí "přejmenování" defaultního \entry, dostaneme řádky začínající nikoli \entry..., ale \příkaz....
A podobně zápis csv=oddělovač umožňuje zvolit místo středníku jiný oddělovač.
Pokud není uveden žádný z předdefinovaných formátů (a ani parametr format), předpokládá se html.
cols
Vypsat (v případě předdefinovaných formátů) položky nikoli po řádcích, ale po sloupcích. Tedy např. nejdříve všechna jména, pak všechna příjmení.
format (vlastní)
Jakým způsobem mají být zformátována data z každého řádku tabulky (alternativa k předdefinovaným formátům). Text, do kterého budou na místech označených hranatými závorkami dosazeny konkrétní hodnoty z tabulky.
Např. z některé z tabulek studentů (StudP, StudA...) lze vyrobit seznam emailových adres (jméno a příjmení plus adresa, každá na jednom řádku) pomocí
```
  format=[jm] [prijm] <[ori]@students.zcu.cz>,[10]
  format=[?ori][jm] [prijm] <[ori]@students.zcu.cz>,[10][/ori]
```
kde ve druhém případě výpis proběhne jen u těch studentů, kteří mají "nenulový" orion login. Další příklady v úvodu.
Text uvedený v parametru format může obsahovat značky:
- [název] - doplní se obsah položky se zadaným názvem
- [?název]...[/název]
  [!název]...[/název]
  - část mezi značkami bude vytištěna, pouze pokud hodnota položky "název" v daném řádku je vyplněná (nenulová, neprázdná), resp. naopak pouze pokud položka neexistuje.
- [?název=hodnota]...[/název]
  [!název=hodnota]...[/název]
  - část mezi značkami se vypíše, pouze pokud položka bude/nebude mít danou hodnotu.
  Kromě '=' lze použít i další podmínky. Přehled:
  - = (rovnítko) - přesná shoda
  - ~ (vlnka) - přibližná shoda, ignoruje se diakritika a velikost písmen, v zápisu hodnoty lze v tomto případě navíc také použít zástupné znaky ? a * pro jeden a pro více znaků.
  - < > <= >= (nerovnosti) - porovnání hodnot jako čísla, jde-li o číselné hodnoty, nebo jako řetězce s ignorováním diakritiky a velikosti
- [@název=tabulka]...[/název] - cyklus přes řádky další tabulky; na pravé straně je označení tabulky ve stylu jakým se zadává v parametru q, zvolený název se pak používá jako prefix při přístupu k hodnotám z ní, např. zavedeme-li
```
  [@A=StudP|KMA|MA1|2009]
```
  máme pak k dispozici [A.jm], [A.prijm]
- [číslo] - vypíše se znak s daným ASCII kódem (zadaným jako desítkové číslo), např. [32] je mezera, [10] odřádkování, [9] tabulátor
- [[ - potřebujeme-li ve výstupu levou hranatou závorku.
- [posloupnost_mezerových _znaků] - při uvedení parametru ignors zapíše do výstupu odpovídající posloupnost mezerových znaků. Při neuvedení parametru ignors je takováto značka ignorována, tj. lze ji v tomto případě použít ke skrytí bílých znaků zapsaných v parametru format např. pouze kvůli přehlednosti zápisu.
Podmínky lze do sebe vnořovat, ale pouze pokud se týkají různých položek. V testovacích hodnotách nemohou být hranaté závorky... Správnost zápisu formátu se nijak nekontroluje. Nedodržení uvedených pravidel může projít, nebo vést k nepředvídatelným efektům.
Pokud bude současně s parametrem format uveden i některý z předdefinovaných formátů, přednost má format. Nicméně uvedení parametru html nebo tex současně s format znamená, že případné speciální znaky obsažené v dosazovaných položkách budou ve výstupu zakódovány podobně jako u těchto formátů.
ignors
Ignorovat (v případě vlastního formátu) mezerové znaky (mezera, tabulátor, odřádkování...) přítomné v textu parametru formát mezi značkami. Zároveň je možné posloupnost mezerových znaků zobrazit pomocí značky složené z posloupnosti takových znaků (taková značka je běžně - při neuvedení parametru ignors - ignorovaná). Parametr ignors tak např. způsobí, že řetězec [jmeno] [prijmeni] bude zobrazen bez mezery, tedy např. JosefNovák, zatímco potřebujeme-li mezery mezi jménem a příjmením zachovat, můžeme uvést [jmeno][ ][prijmeni].
Tento parametr je možné využít pro zvýšení přehlednosti zápisu parametru format.
ie
Vstupní kódování. Kódování češtiny, v němž jsou zadány parametry q a format (ano, existují katedry a předměty, které mají ve zkratce znaky s diakritikou).
MiniSTAG pracuje v kódování iso-8859-2. Zadáváte-li parametry v kódováním jiném, je třeba ho uvést. Např.
ie=win nebo ie=utf8
Možnosti viz parametr oe. Pokud vstup nebude odpovídat zvolenému kódování, výsledky budou patrně nesprávné.
oe
Výstupní kódování. Na výběr jsou
il2 - ISO-8859-2 (latin2)
win - windowsovské CP1250
dos - dosovská CP852
utf8 - UTF8
asc - výstup bez háčků a čárek (na vstupu raději nezkoušet)
Pokud se díváte na výsledky WWW prohlížečem, za výstupní kódování nejspíš nemusíte zadávat nic.

Umělá tabulka

Kromě tabulek naplněných daty získávanými ze STAGu disponuje miniSTAG možností vytvořit si vlastní umělou tabulku, jejíž obsah se generuje podle hodnot uvedených v jejím parametru. Její označení je TabCo a má dva parametry. První parametr budou názvy sloupečků oddělené čárkou (defaultně názvy c1,c2,...) a druhý parametr jsou vlastní data (jednotlivé řádky oddělené středníkem; v rámci řádku oddělovač čárka - něco jako matice v matlabu). Např. kód

TabCo|prvni,druhy|a,b; c,d; e,f|

reprezentuje tabulku

i prvni druhy

1 a b

2 c d

3 e f

i	prvni	druhy
1	a	b
2	c	d
3	e	f

V označeních sloupečků lze použít pouze písmenka bez diakritiky a číslice, a nelze použít názvy i a ind. Jinak (nebo pokud nejsou uvedeny) bude použíto defaultní označení c1, c2,...

Umělá tabulka nalezne použití i při filtrování k zapsání podmínky nebo.

Počítací tabulky

Možné také je vygenerovat k dané tabulce jednoduché statistiky - počet řádků a součty či průměry vybraných sloupečků. K tomu slouží tabulky CountTab (resp. NTab), SumTab a MeanTab. Navíc, tyto statistiky je možné získat nejen za celou tabulku, ale při uvedení dodatečného parametru také po částech definovaných kombinacemi hodnot tam zvolených sloupečků. Obecný tvar označení počítacích tabulek je

CountTab|zdroj|sloupecky|podle|
SumTab|zdroj|sloupecky|podle|
MeanTab|zdroj|sloupecky|podle|

kde zdroj je označení zdrojové tabulky, jejíž data se mají použít (pozor, její označení musí být URL-zakódované), sloupecky je seznam čárkami oddělených názvů sloupečků , jejichž součet či průměr nás zajímá (v případě CountTab necháme prázdné - automaticky se vygenerují sloupečky n a proc) a podle je seznam čárkami oddělených názvů sloupečků, podle jejichž hodnot se má tabulka rozdělit a které také budou uvedeny ve výstupu (bude-li tento seznam prázdný, spočte se požadovaná statistická hodnota souhrnně za celou tabulku).

Přesněji,

sloupecky může ve skutečnosti obsahovat položky ve tvaru novy_nazev=originalni_nazev, pokud bychom sloupečky se statistikami chtěli ve výstupu mít pojmenované jinak než původní sloupečky s hodnotami,
pokud bude sloupecky prázdné, automaticky se bude statistika počítat pro každý sloupeček kromě těch uvedených v podle,
v případě tabulky CountTab jsou ve výsledku automaticky generovány sloupečky n a proc, tedy absolutní četnost a relativní četnost v procentech (v případě nerozdělené tabulky bude jednoduše spočten počet řádků a v proc bude 100) a pomocí sloupecky je možné je přejmenovat.

miniSTAG -- M. Friesl, 2009-2022
Zdroj dat: DEMO Webové služby nad IS/STAG
2024-04-19 12:35:58