PM: API: AssessmentChallenge: GET /planning-api/assessment-challenges
Üldkirjeldus
Teenus väljastab hindamise käigus sõnastatud kasutajaga seotud asutuse või ametikoha väljakutsete nimekirja.
Seotud andmeobjektid:
Seotud Jira taskid
NSIL-664 - Getting issue details... STATUS
NSIL-794 - Getting issue details... STATUS
NSIL-924 - Getting issue details... STATUS
NSIL-931 - Getting issue details... STATUS
NSIL-1033 - Getting issue details... STATUS
Eeltingimused ja kasutusõigused
- Asutusepõhised väljakutsed (assessmentScope = INSTITUTIONAL)
- Kasutajal peab olema seos väljakutse asutusega ja selle asutuse eesmärkide vaatamise õigus.
- AssessmentChallenge.assessment.institution.id = Kasutaja poolt valitud rolliga seotud asutus
- Õigust reguleerib privileeg: HSILM_PLANNING_GOAL_VIEW.
- Kasutajal peab olema seos väljakutse asutusega ja selle asutuse eesmärkide vaatamise õigus.
- Kasutaja ametikoha väljakutsed (assessmentScope = INDIVIDUAL)
- Väljakutse peab olema seotud kasutaja isikukoodiga.
- AssessmentChallenge.assessment.personalCode = Päringu käivitanud kasutaja isikukood.
- Väljakutse peab olema seotud kasutaja isikukoodiga.
- Meeskonnaliikme rolli valinud kasutaja ei saa pärida väljakutseid.
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 |
|---|---|---|---|---|
| assessmentScope | 1 | String |
| Määrab, millise ulatusega väljakutseid otsitakse:
|
| institutionId | 1 | String |
| Viide asutusele, mille väljakutseid otsitakse. |
| jobsite | 0..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 hindamisliigi kohta peavad väljakutsete nimekirjas olema ainult viimase hindamise tulemused, mis on kuni 5 aastat vanad.
- Süsteem otsib Objektid#AssessmentChallenge objekte, mille:
- Kui sisendis esitatud assessmentScope = "INSTITUTIONAL":
- assessment.assessmentScope = "INSTITUTIONAL".
- assessment.institution.id = Sisendis esitatud "institutionId" väärtus.
- assessment.jobsite = NULL.
- assessment.personalCode = NULL
- Kui sisendis esitatud assessmentScope = "INDIVIDUAL":
- assessment.asessmentScope = "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.
- Kui sisendis esitatud assessmentScope = "INSTITUTIONAL":
- Süsteem otsib Objektid#AssessmentChallenge objekte, mille:
- Süsteem tagastab leitud andmed.
- Kui väljakutseid ei leita, tagastatakse tühi vastus.