KOSapi

h1. Předmět

*Klíčový zdroj:* [[Courses#GET-coursescode|/courses/{code}]]
*XSI typ:* kos:course
*Související typy:* [[CourseTexts]]

{{sortable_table}}
|_(sortable). Identifikátor |_(sortable). Český název |_. Datový typ |_. Omezení |_. Popis |
| allowedEnrollmentCount | povolený počet zapsání | integer | 1-99 | kolikrát za studium si student může daný předmět zapsat (typicky 2x)|
| approvalDate | datum schválení | date | | |
| classesLang | jazyk výuky | [[ClassesLang]] | | |
| classesType | metody výuky | [[ClassesType]]* | | udává, zda má předmět přednášky, cvičení apod. |
| code | kód | string | NN(Not Null), UQ(Unique), ≤ 20 zn.| unikátní identifikátor předmětu |
| completion | způsob zakončení | [[Completion]] | NN(Not Null) | |
| credits | kredity | integer | 0-999 | |
| department | zodpovědné středisko organizační jednotka | ➞[[Unit]] | NN(Not Null) | středisko organizační jednotka (většinou katedra), pod kterou předmět patří |
| description ^1^ expire | anotace TODO | date | string ML(Multilang) | | |
| homepage | webové stránky | string | ≤ 250 zn. | TODO |
| keywords | klíčová slova | string ML(Multilang) | ≤ 500 zn. | klíčová slova charakterizující předmět (oddělená čárkami) |
| lecturesContents ^1^ | osnova přednášek | string ML(Multilang) | | |
| literature ^1^ | literatura | string ML(Multilang) | | seznam doporučené literatury |
| name | název | string ML(Multilang) | NN(Not Null) ^cs^, ≤ 100 zn. | |
| note | poznámka | string ML(Multilang) | ≤ 2000 zn. | |
| objectives ^1^ | cíle | string ML(Multilang) | | |
| range | rozsah | string | ≤ 5 zn. | udává časovou dotaci výukových hodin; obsahuje hodnoty typu: @[0-9]+[dpcslj](\+[0-9]+[pcslj]?)?@;
nelze jednoznačně strojově dekódovat, protože se tu míchají hodnoty počet/měsíc a počet/semestr bez nějakého odlišení. | odlišení.|
| requirements ^1^ | požadavky | string ML(Multilang) | | |
| season | sezóna | [[Season]] | | část školního roku, ve kterém se předmět vypisuje (letní/zimní/oba) |
| state | stav | [[CourseState]] | NN(Not Null) | stav v „životním cyklu“ předmětu |
| studyForm | forma studia | [[StudyForm]] | | forma studia, pro kterou je předmět určen |
| superiorCourse | nadřízený předmět | ➞[[Course]] | | nadřízený předmět (tzv. superpředmět) |
| subcourses/course | podřízené předměty | ( ➞[[Course]]* ) | | může mít pouze superpředmět |
| tutorialsContents ^1^ | osnova cvičení | string ML(Multilang) | | |
| instance ^2^ | instance předmětu | ( [[Course#instance-předmětu|Instance]]* ) | |

^1^ vypíše se pouze při _[[URLParameters#detail|detail]]=1_
^2^ vypíše se pouze při _[[URLParameters#sem|sem]] ≠ none_

h2. Instance předmětu

{{sortable_table}}
|_(sortable). Identifikátor |_(sortable). Český název |_. Datový typ |_. Omezení |_. Popis |
| semester | semestr | [[SemesterCode]] | NN(Not Null) | |
| capacity [@of='instance'] | kapacita inst. předmětu | integer | 1 – 99999 | |
| capacity [@of='tutorial'] | kapacita cvičení | integer | 1 – 99999 | |
| capacityOverfill | překročení kapacity | [[Permission]] | | příznak určující, zda je povoleno překročení kapacity předmětu |
| occupied | počet obsazených míst | integer | 1 – 99999 | kolik studentů má předmět zapsaný |
| examiners | zkoušející | ( ➞[[Teacher]]* ) | | |
| guarantors | garanti | ( ➞[[Teacher]]* ) | | |
| instructors | cvičící | ( ➞[[Teacher]]* ) | | |
| lecturers | přednášející | ( ➞[[Teacher]]* ) | | |