GS: AssessmentInstruction: API: GET /quality-api/assessment-instructions/{instructionId}/assessment-components/order
Üldkirjeldus
Teenuse abil saab otsida hindamise juhendi komponentide järjekorda.
Seotud andmeobjektid:
NSIL-1267 - Getting issue details... STATUS
Eeltingimused ja kasutusõigused
- Kasutaja peab olema autenditud ja autoriseeritud.
Sisendid
| Atribuut | Kohustuslikkus, mitmesus | Tüüp | Vaikeväärtus, valideerimine | Kirjeldus, täiendav info |
|---|---|---|---|---|
| instructionId | 1 | String |
| Hindamise juhendi id. |
Väljundid
| Atribuut | Kohustuslikkus, mitmesus | Tüüp | Kirjeldus, täiendav info |
|---|---|---|---|
| components | 0..* | Nested Array | Nimekiri juhendi komponentidest (sektsioon, vormielement). Juhendi komponendid on mitmetasandilised. See tähendab, et ühe juhendi komponendi sees saab olla mitu alakomponenti ja alakomponentidel saab olla alakomponente lõpmatu sügavusega. Sektsiooni tüüpi komponent saab olla esimese taseme komponent, vormielement ei saa olla esimese taseme komponent. Sektsiooni tüüpi komponendil saab olla alakomponente, sh sektsioonid ja vormielemendid. Vormielementi tüüpi komponendil ei saa olla alakomponente. Samal tasemel ja sama ülemkomponendi all kuuluvad komponendid saavad olla nii sektsioonid kui ka vormielemendid. Samal tasemel ja sama ülemkomponendi alla kuuluvaid sektsioone ja vormielemente saab omavahel järjestada. |
| components.id | 1 | FK | Viide juhendi komponendile (sektsioonile või vormielemendile). Viitab AssessmentInstructionSection.Id (sektsioon) väärtusele või AssessmentInstructionSectionElement.id (vormielement) väärtusele. |
| components.type | 1 | ENUM | Juhendi komponendi tüüp. Võimalikud väärtused:
|
| components.level | 1 | Integer | Komponendi tase. Tasemed algavad ühest. |
| components.seqNo | 1 | Integer | Komponendi järjekorranumber. Järjekord algab ühest. |
Tegevused
- Süsteem kontrollib, kas kasutajal on õigust päringut teostada.
- Kui kasutajal ei ole õigust päringut teostada, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
- Süsteem valideerib sisendi.
- Kui sisend on ebakorrektne, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
- Süsteem otsib hindamise juhendi komponentide järjekorra.
- Süsteem otsib Objektid#AssessmentInstructionComponentOrder objekti, mille:
- assessmentInstructionId = Sisendis esitatud instructionId väärtus.
- objectStatus = CURRENT
- Süsteem otsib Objektid#AssessmentInstructionComponentOrder objekti, mille:
- Süsteem tagastab leitud andmed.
- Kui ühtegi objekti ei leitud, siis tagastatakse tühi vastus.