| kvalifikacniprace | |
|---|---|
| Popis | Kvalifikační práce (diplomky, bakalářky) |
| Typ | REST |
| Adresa | /ws/services/rest2/kvalifikacniprace |
| Specifikace | |
| Název | kvalifikacniprace |
Operace
| downloadPraceContent | |
|---|---|
| Garance | Negarantováno! Pozor, tato služa je sice na IS/STAG API přítomna, ale její přesná specifikace a funkčnost není jakkoliv garantována a její použití je zcela na riziko klienta. Služba se může kdykoliv bez varování změnit či zmizet. |
| Komentář | Vrátí obsah zadané kvalifikační práce (dle adipIdno), posudku k ní či průběhu obhajoby. Některé práce/posudky/průběhy mohou pro stažení vyžadovat přihlášeného uživatele, jiné může mít právo stáhnout i nepřihlášený uživatel. POZOR - NEPOUŽÍVAT - SLUŽBA JE NEPODPOROVANÁ A BUDE ZRUŠENA! Používejte novou službu soubory/getSouborContent ! |
| HTTP metoda | GET |
| Adresa | /ws/services/rest2/kvalifikacniprace/downloadPraceContent |
| Možné výstupní MIME typy | */* |
| Oblasti | root, downloads |
| Je nutné ověřování | pravděpodobně bez nutnosti přihlášení (služba ovšem na základě konfigurace konkrétní instalace IS/STAG může vyžadovat přihlášení či specifickou roli uživatele) |
| Parametry | ||||
|---|---|---|---|---|
| Název | Typ (Java) | Komentář | ||
| stagUser | String | |||
| adipIdno | Long | |||
| coStahnout | Integer | Co přesně stáhnout? 1-vlastní práci, 2-posudek vedoucího, 3-posudek oponenta, 4-průběh obhajoby. Není-li uvedeno, stahuje se obsah práce. | ||
| downloadPraceContentAuth | |
|---|---|
| Garance | Negarantováno! Pozor, tato služa je sice na IS/STAG API přítomna, ale její přesná specifikace a funkčnost není jakkoliv garantována a její použití je zcela na riziko klienta. Služba se může kdykoliv bez varování změnit či zmizet. |
| Komentář | Vrátí obsah zadané kvalifikační práce (dle adipIdno), posudku k ní či průběhu obhajoby. Vždy vyžaduje přihlášení. Role ADMINISTRATOR, KNIHOVNA a KNIHOVNA_SPRAVCE mohou stahovat všechny práce bez omezení. Role FAKULTA a KATEDRA jen jim náležející práce. POZOR - NEPOUŽÍVAT - SLUŽBA JE NEPODPOROVANÁ A BUDE ZRUŠENA! Používejte novou službu soubory/getSouborContentAuth ! |
| HTTP metoda | GET |
| Adresa | /ws/services/rest2/kvalifikacniprace/downloadPraceContentAuth |
| Možné výstupní MIME typy | */* |
| Oblasti | root, downloads |
| Je nutné ověřování | přihlášení, ověření dle uživatelské role |
| Povolené role |
ALL
|
| Parametry | ||||
|---|---|---|---|---|
| Název | Typ (Java) | Komentář | ||
| stagUser | String | |||
| adipIdno | Long | |||
| coStahnout | Integer | Co přesně stáhnout? 1-vlastní práci, 2-posudek vedoucího, 3-posudek oponenta, 4-průběh obhajoby. Není-li uvedeno, stahuje se obsah práce. | ||
| downloadPraceContentForThesesCZ | |
|---|---|
| Garance | Negarantováno! Pozor, tato služa je sice na IS/STAG API přítomna, ale její přesná specifikace a funkčnost není jakkoliv garantována a její použití je zcela na riziko klienta. Služba se může kdykoliv bez varování změnit či zmizet. |
| Komentář | Vrátí soubor s kvalifikační prací. Určeno pouze pro komunikaci s Theses.CZ. POZOR - NEPOUŽÍVAT - SLUŽBA JE NEPODPOROVANÁ A BUDE ZRUŠENA! Používejte novou službu soubory/getSouborContentForThesesCZ ! |
| HTTP metoda | GET |
| Adresa | /ws/services/rest2/kvalifikacniprace/downloadPraceContentForThesesCZ |
| Možné výstupní MIME typy | */* |
| Oblasti | downloadPraceContentForThesesCZ, root, downloads |
| Je nutné ověřování | přihlášení, ověření speciálním uživatelským účtem |
| Parametry | ||||
|---|---|---|---|---|
| Název | Typ (Java) | Komentář | ||
| adipIdno | Long | |||
| exportPraceData | |
|---|---|
| Garance | Garantováno minimálně do 20.4.2025 |
| Komentář | Exportuje údaje o kvalif. pracích do formátu VSKP či THESES (viz. parametr systemVystupu), většinou pro účely registrů pro odhalování plagiátorství. |
| HTTP metoda | GET |
| Adresa | /ws/services/rest2/kvalifikacniprace/exportPraceData |
| Možné výstupní MIME typy | application/xml, text/xml, application/json, text/yaml, text/csv, application/vnd.ms-excel, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet |
| Oblasti | root, downloads |
| Je nutné ověřování | přihlášení, ověření dle uživatelské role |
| Povolené role |
LOGGED
|
| Parametry | ||||
|---|---|---|---|---|
| Název | Typ (Java) | Komentář | ||
| adipIdno | Long | ID kvalifikační práce. Je-li vyplněno, exportuje se pouze tato jedna práce. Jinak se exportuje obecně více prací, záleží na ostatních parametrech. | ||
| identifikator | String | Externí identifikator uvedený u kvalifikační práce. | ||
| systemVystupu | String | Systém výstupu, může být 'VSKP', 'THESES'. Není-li vyplněno, je použito 'THESES'. | ||
| datumOdevzdaniOd | Date | Není-li uvedeno, berou se všechny záznamy o kvalif. pracích, které ještě nebyly v daném systému výstupu vyexportovány nebo ty, které byly modifikovány. Je-li uvedeno, berou se všechny práce od daného datumu. | ||
| jenSeSouborem | Boolean | Je-li true, berou se jen práce, u kterých je přiložen soubor s plnym textem prace. Neni-li uvedeno, bere se 'false'. | ||
| getKvalifikacniPrace | |
|---|---|
| Garance | Garantováno minimálně do 20.4.2025 |
| Komentář | Vrátí seznam kvalifikačních prací (bakalářských, diplomových) dle zadaných parametrů. Přestože jsou všechny parametry volitelné, systém nedovolí vrátit všechny práce - tj. alespoň jeden musí být zadán. Není-li některý parametr zadán, pak na něm nezáleží. |
| HTTP metoda | GET |
| Adresa | /ws/services/rest2/kvalifikacniprace/getKvalifikacniPrace |
| Možné výstupní MIME typy | application/xml, text/xml, application/json, text/yaml, text/csv, application/vnd.ms-excel, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet |
| Oblasti | root |
| Je nutné ověřování | pravděpodobně bez nutnosti přihlášení (služba ovšem na základě konfigurace konkrétní instalace IS/STAG může vyžadovat přihlášení či specifickou roli uživatele) |
| Parametry | ||||
|---|---|---|---|---|
| Název | Typ (Java) | Komentář | ||
| stagUser | String | |||
| katedra | String | |||
| rokZadani | String | Rok zadání práce | ||
| rokObhajoby | String | Rok obhajoby práce | ||
| osCislo | String | |||
| stprIdno | Long | |||
| adipIdno | Long | ID kvalifikační práce. Pokud parametr vyplníte, ve výsledku získáte pouze tuto jedinou práci. | ||
| ucitIdno | Long | ID osoby se zadaným vztahem k práci (viz. parametr vztahKPraci) - identifikační číslo vyučujícího. | ||
| vztahKPraci | String | Vztah zadané osoby k práci. Není-li zadáno, může mít zadaná osoba libovolný vztah k práci. | ||
| typPrace | Integer | Omezení jen na určitý typ práce (diplomová, bakalářská). Hodnotou je číslo z číselníku 'PRACE'. | ||
| datumZmenyOd | Date | Je-li uvedeno, pak musí být čas poslední změny u navrácených prací větší, než čas uvedený jako hodnota parametru | ||
| datumZmenyDo | Date | Je-li uvedeno, pak musí být čas poslední změny u navrácených prací menší, než čas uvedený jako hodnota parametru | ||
| lang | String | |||
| getKvalifikacniPraceAuth | |
|---|---|
| Garance | Garantováno minimálně do 20.4.2025 |
| Komentář | Naprosto shodná služba jako 'getKvalifikacniPrace'. Tato služba však VYŽADUJE vždy přihlášeného uživatele. |
| HTTP metoda | GET |
| Adresa | /ws/services/rest2/kvalifikacniprace/getKvalifikacniPraceAuth |
| Možné výstupní MIME typy | application/xml, text/xml, application/json, text/yaml, text/csv, application/vnd.ms-excel, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet |
| Oblasti | root |
| Je nutné ověřování | přihlášení, ověření dle uživatelské role |
| Povolené role |
ALL
|
| Parametry | ||||
|---|---|---|---|---|
| Název | Typ (Java) | Komentář | ||
| stagUser | String | |||
| katedra | String | |||
| rokZadani | String | Rok zadání práce | ||
| rokObhajoby | String | Rok obhajoby práce | ||
| osCislo | String | |||
| stprIdno | Long | |||
| adipIdno | Long | ID kvalifikační práce. Pokud parametr vyplníte, ve výsledku získáte pouze tuto jedinou práci. | ||
| ucitIdno | Long | ID osoby se zadaným vztahem k práci (viz. parametr vztahKPraci) - identifikační číslo vyučujícího. | ||
| vztahKPraci | String | Vztah zadané osoby k práci. Není-li zadáno, může mít zadaná osoba libovolný vztah k práci. | ||
| typPrace | Integer | Omezení jen na určitý typ práce (diplomová, bakalářská). Hodnotou je číslo z číselníku 'PRACE'. | ||
| datumZmenyOd | Date | Je-li uvedeno, pak musí být čas poslední změny u navrácených prací větší, než čas uvedený jako hodnota parametru | ||
| datumZmenyDo | Date | Je-li uvedeno, pak musí být čas poslední změny u navrácených prací menší, než čas uvedený jako hodnota parametru | ||
| lang | String | |||
| getKvalifikacniPraceOsoby | |
|---|---|
| Garance | Garantováno minimálně do 20.4.2025 |
| Komentář | Vrátí seznam dvojic kvalifikační práce - osoby se vztahem k práci. Je nutno zadat alespoň jeden z dvojice parametrů adipIdno, ucitIdno. |
| HTTP metoda | GET |
| Adresa | /ws/services/rest2/kvalifikacniprace/getKvalifikacniPraceOsoby |
| Možné výstupní MIME typy | application/xml, text/xml, application/json, text/yaml, text/csv, application/vnd.ms-excel, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet |
| Oblasti | root |
| Je nutné ověřování | pravděpodobně bez nutnosti přihlášení (služba ovšem na základě konfigurace konkrétní instalace IS/STAG může vyžadovat přihlášení či specifickou roli uživatele) |
| Parametry | ||||
|---|---|---|---|---|
| Název | Typ (Java) | Komentář | ||
| stagUser | String | |||
| adipIdno | Long | ID kvalifikační práce. Pokud parametr vyplníte, ve výsledku získáte pouze tuto jedinou práci. | ||
| ucitIdno | Long | ID osoby se vztahem k práci. Pokud parametr vyplníte, ve výsledku získáte pouze práce ke kterým má vztah zadaný učitel. | ||
| lang | String | |||
| nastavPoslatDoKnihovny | |
|---|---|
| Garance | Garantováno minimálně do 20.4.2025 |
| Komentář | Nastaví u zadane kvalifikacni prace priznak 'poslat do knihovny' na zadanou hodnotu (buď A nebo N). Služba vrací řetězec OK pokud bylo v pořádku nastaveno, jinak vrací text chyby. |
| HTTP metoda | GET |
| Adresa | /ws/services/rest2/kvalifikacniprace/nastavPoslatDoKnihovny |
| Možné výstupní MIME typy | text/plain |
| Oblasti | root |
| Je nutné ověřování | přihlášení, ověření dle uživatelské role |
| Povolené role |
AD
(Administrátor)
KN (Knihovna) KS (Knihovna správce) |
| Parametry | ||||
|---|---|---|---|---|
| Název | Typ (Java) | Komentář | ||
| stagUser | String | |||
| adipIdno | Long | |||
| hodnota | String | |||
| nastavPrevzatoKnihovnou | |
|---|---|
| Garance | Garantováno minimálně do 20.4.2025 |
| Komentář | Nastaví u zadane kvalifikacni prace priznak 'prevzato knihovnou' na 'ANO' a pripadne 'prevzato knihovnou datum' na aktualni datum. Služba vrací řetězec OK pokud bylo v pořádku nastaveno, jinak vrací text chyby. |
| HTTP metoda | GET |
| Adresa | /ws/services/rest2/kvalifikacniprace/nastavPrevzatoKnihovnou |
| Možné výstupní MIME typy | text/plain |
| Oblasti | root |
| Je nutné ověřování | přihlášení, ověření dle uživatelské role |
| Povolené role |
AD
(Administrátor)
KN (Knihovna) KS (Knihovna správce) |
| Parametry | ||||
|---|---|---|---|---|
| Název | Typ (Java) | Komentář | ||
| stagUser | String | |||
| adipIdno | Long | |||
| nastavitPrevzatoKnihovnouDatum | Boolean | Pokud je TRUE, nastavi se zaroven polozka 'dat_knihovna' na aktualni datum (datum prevzeti knihovnou). Je-li 'false' nebo neni uvedeno, pak se tato polozka nemeni. | ||
| serviceOAIPMH_GET | |
|---|---|
| Garance | Garantováno minimálně do 20.4.2025 |
| Komentář | Služba OAI-PMH vracejici kvalifikacni prace studentu (Open Archives Initiative - Protocol for Metadata Harvesting). Popis formatu viz: http://www.openarchives.org/OAI/openarchivesprotocol.html |
| HTTP metoda | GET |
| Adresa | /ws/services/rest2/kvalifikacniprace/serviceOAIPMH |
| Možné výstupní MIME typy | application/xml, text/xml, application/json, text/yaml, text/csv, application/vnd.ms-excel, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet |
| Oblasti | root |
| Je nutné ověřování | pravděpodobně bez nutnosti přihlášení (služba ovšem na základě konfigurace konkrétní instalace IS/STAG může vyžadovat přihlášení či specifickou roli uživatele) |
| Parametry | ||||
|---|---|---|---|---|
| Název | Typ (Java) | Komentář | ||
| arg0 | UriInfo | |||
| serviceOAIPMH_POST | |
|---|---|
| Garance | Garantováno minimálně do 20.4.2025 |
| Komentář | Služba OAI-PMH vracejici kvalifikacni prace studentu (Open Archives Initiative - Protocol for Metadata Harvesting). Popis formatu viz: http://www.openarchives.org/OAI/openarchivesprotocol.html |
| HTTP metoda | POST |
| Adresa | /ws/services/rest2/kvalifikacniprace/serviceOAIPMH |
| Možné výstupní MIME typy | */* |
| Oblasti | root |
| Je nutné ověřování | pravděpodobně bez nutnosti přihlášení (služba ovšem na základě konfigurace konkrétní instalace IS/STAG může vyžadovat přihlášení či specifickou roli uživatele) |
| Parametry | ||||
|---|---|---|---|---|
| Název | Typ (Java) | Komentář | ||
| arg0 | String | |||
| serviceOAIPMH_UspesneObhajene_GET | |
|---|---|
| Garance | Garantováno minimálně do 20.4.2025 |
| Komentář | Služba OAI-PMH vracejici kvalifikacni prace 'pouze uspesne obhajene + student je jiz uspesne absolventem'. (Open Archives Initiative - Protocol for Metadata Harvesting). Popis formatu viz: http://www.openarchives.org/OAI/openarchivesprotocol.html |
| HTTP metoda | GET |
| Adresa | /ws/services/rest2/kvalifikacniprace/serviceOAIPMH_UspesneObhajene |
| Možné výstupní MIME typy | application/xml, text/xml, application/json, text/yaml, text/csv, application/vnd.ms-excel, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet |
| Oblasti | root |
| Je nutné ověřování | pravděpodobně bez nutnosti přihlášení (služba ovšem na základě konfigurace konkrétní instalace IS/STAG může vyžadovat přihlášení či specifickou roli uživatele) |
| Parametry | ||||
|---|---|---|---|---|
| Název | Typ (Java) | Komentář | ||
| arg0 | UriInfo | |||
| serviceOAIPMH_UspesneObhajene_POST | |
|---|---|
| Garance | Garantováno minimálně do 20.4.2025 |
| Komentář | Služba OAI-PMH vracejici kvalifikacni prace 'pouze uspesne obhajene + student je jiz uspesne absolventem'. (Open Archives Initiative - Protocol for Metadata Harvesting). Popis formatu viz: http://www.openarchives.org/OAI/openarchivesprotocol.html |
| HTTP metoda | POST |
| Adresa | /ws/services/rest2/kvalifikacniprace/serviceOAIPMH_UspesneObhajene |
| Možné výstupní MIME typy | */* |
| Oblasti | root |
| Je nutné ověřování | pravděpodobně bez nutnosti přihlášení (služba ovšem na základě konfigurace konkrétní instalace IS/STAG může vyžadovat přihlášení či specifickou roli uživatele) |
| Parametry | ||||
|---|---|---|---|---|
| Název | Typ (Java) | Komentář | ||
| arg0 | String | |||
| updateKvalifikacniPrace | |
|---|---|
| Garance | Garantováno minimálně do 20.4.2025 |
| Komentář | Nastavi datum odevzdani kvalifikacni prace na zadanou hodnotu. Vrati-li retezec 'OK', dopadlo to v poradku, jinak vrati chybu |
| Možné výstupní MIME typy | text/plain |
| Oblasti | root |
| Je nutné ověřování | služba je zakázána |
| Parametry | ||||
|---|---|---|---|---|
| Název | Typ (Java) | Komentář | ||
| adipIdno | long | |||
| datumOdevzdani | Date | Datum odevzdani prace nastavit na zadanou hodnotu (muze byt i NULL, pak je datum nastaveno na NULL) | ||
| zrusPrevzatoKnihovnou | |
|---|---|
| Garance | Garantováno minimálně do 20.4.2025 |
| Komentář | Nastaví u zadane kvalifikacni prace priznak 'prevzato knihovnou' na 'NE' a 'prevzato knihovnou datum' na NULL. Služba vrací řetězec OK pokud bylo v pořádku nastaveno, jinak vrací text chyby. |
| HTTP metoda | GET |
| Adresa | /ws/services/rest2/kvalifikacniprace/zrusPrevzatoKnihovnou |
| Možné výstupní MIME typy | text/plain |
| Oblasti | root |
| Je nutné ověřování | přihlášení, ověření dle uživatelské role |
| Povolené role |
AD
(Administrátor)
KN (Knihovna) KS (Knihovna správce) |
| Parametry | ||||
|---|---|---|---|---|
| Název | Typ (Java) | Komentář | ||
| stagUser | String | |||
| adipIdno | Long | |||