Kustutamiseks - PM: API: AssessmentChallenge: GET /planning-api/assessment-challenges-archive
Üldkirjeldus
Teenus väljastab kasutaja lõpetatud ametikoha väljakutsete nimekirja.
Seotud andmeobjektid:
Seotud Jira taskid
NSIL-931 - Getting issue details... STATUS
Eeltingimused ja kasutusõigused
- Väljakutse peab olema seotud kasutaja isikukoodiga:
- AssessmentChallenge.assessment.personalCode = Päringu käivitanud kasutaja isikukood.
- Kasutaja kehtivate ametikohtade hulgas ei tohi olla väljakutsega seotud ametikoha ja asutuse kombinatsiooni:
- AssessmentChallenge.assessment.jobsite ja AssessmentChallenge.assessment.institution.id väärtuste kombo ei kuulu kasutaja kehtivate ametikohtade hulka.
- EHIS x-tee teenus GET/users/v1/userAccounts.response.data.jobsiteList
- Eraldi privileegi ei ole vaja.
- AssessmentChallenge.assessment.jobsite ja AssessmentChallenge.assessment.institution.id väärtuste kombo ei kuulu kasutaja kehtivate ametikohtade hulka.
Planeerimise mooduli kasutusrollide ja õiguste kohta saab täpsemalt infot leida lehelt Kasutusõigused ja rollid.
Sisendid
| Atribuut | Kohustuslikkus, mitmesus | Tüüp | Vaikeväärtus, valideerimine | Kirjeldus, täiendav info |
|---|---|---|---|---|
| institutionId | 1 | String |
| Viide asutusele, mille väljakutseid otsitakse. |
| jobsite | 1 | String |
| Kasutaja ametikoht, millele vastavaid väljakutseid otsitakse. |
Väljundid
| Atribuut | Kohustuslikkus, mitmesus | Tüüp | Kirjeldus, täiendav info |
|---|---|---|---|
| assessmentChallenges | 0..* | Array | Hindamise käigus sõnastatud väljakutsete andmed. |
id | 1 | UUID | Objekti identifikaator. |
assessment | 1 | Object | Väljakutega seotud hindamise andmed. |
| assessment.id | 1 | String (PK) | Hindamise id (UUID). |
| assessment.assessmentModelId | 1 | String (FK) | Viide hindamismudelile (UUID). |
| assessment.domain | 1 | EHIS Classifier | Hindamise valdkond. |
| assessment.assessmentType | 1 | EHIS Classifier | Hindamise liik. |
| assessment.assessmentScope | 1 | String | Määrab, kas tegemist on asutusepõhise (INSTITUTIONAL) või isikupõhise väljakutsega (INDIVIDUAL). |
| assessment.personalCode | 0..1 | String | Isiku isikukood, kelle väljakutse see on. Selgitus: Täidetud ainult isikupõhise väljakutse puhul (assessmentScope = INDIVIDUAL). |
| assessment.jobsite | 0..1 | String | Ametikoht, mille raames antud väljakutse on isikule määratud. |
| assessment.startDate | 1 | Date | Hindamise algusaeg. |
| assessment.endDate | 0..1 | Date | Hindamise lõppaeg. |
| assessment.institution | 1 | Object | Hindamisega seotud asutuse (KOV, õppeasutus) objekt. |
| assessment.institution.id | 1 | String | Viide hindamisega seotud asutusele EHISes. |
| assessment.institution.type | 1 | EHIS Classifier | Asutuste liik (KOV, õppeasutus). |
| elements | 1..* | Array | Hindamise väljakutse elemendid. |
| elements.id | 1 | UUID | Elemendi id. |
| elements.assessmentResultSectionElementId | 1 | FK | Hindamise käigus elemendile antud id. |
| elements.code | 1 | Enum | Vaikimisi lisatud elemendi kood. Kasutatakse ainult vaikimisi lisatud elementide korral. Kasutatakse hiljem hindamis tulemuste kuvamiseks planeerimise moodulis. Väärtused:
|
| elements.label | 1 | String | Vormielemendi silt. |
| elements.inputType | 1 | EHIS Classifier | Vormielemendi sisendi formaat. Väärtusena klassifikaatori INPUT_TYPE elemendi viide. |
elements.scale | 0..1 | Object | Skaala objekt. Kasutatakse kui sisendi formaat väärtuseks on "punktid" (SCORE). |
| elements.scale.valuesFrom | 1 | Integer | Skaala väärtuste algus. |
| elements.scale.valuesUntil | 1 | Integer | Skaala väärtuste lõpp. |
elements.scale.selectedValue | 0..1 | Integer | Skaalal valitud väärtus. |
elements.textAreaValue | 0..1 | String | Elemendi väärtus, kui vormielement on tekstiala (TEXT_AREA). |
| elements.ehisClassifierCode | 0..1 | String | EHISe klassifikaatori definitsiooni kood. Kasutatakse kui sisendi formaat väärtuseks on "klassifikaator" (CLASSIFIER). |
| elements.selectedEhisClassifierItems | 0..* | EHIS Classifier Array | Valitud ehise klassifikaatori elemendi objektid. Kasutatakse kui sisendi formaat väärtuseks on "klassifikaator" (CLASSIFIER). |
Tegevused
- Süsteem kontrollib, kas kasutajal on õigust päringut teostada.
- Kui kasutajal ei ole õigust päringut teostada, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
- Süsteem kontrollib, kas sisendandmed vastavad nõuetele.
- Kui andmed ei vasta nõuetele, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
- Süsteem otsib väljakutseid, mis on kuni 5 aastat vanad. Iga hindamiseliigi kohta peavad väljakutsete nimekirjas olema ainult viimase hindamise tulemused, mis on kuni 5 aastat vanad.
- Süsteem otsib Objektid#AssessmentChallenge objekte, mille:
- assessment.assessmentScope = "INDIVIDUAL"
- assessment.personalCode = Päringu käivitanud kasutaja isikukood.
- assessment.institution.id = Sisendis esitatud "institutionId" väärtus.
- assessment.jobsite = Sisendis esitatud "jobsite" väärtus.
- assessment.endDate <= Päringu teostamise aeg - 5 aastat.
- Sama assessment.assessmentType korral on assessment.endDate suurim.
- Süsteem otsib Objektid#AssessmentChallenge objekte, mille:
- Süsteem tagastab leitud andmed.
- Kui väljakutseid ei leita, tagastatakse tühi vastus.