Üldkirjeldus

Teenus võimaldab muuta väljakutse olulisust. Väljakutse olulisuse väärtust muudetakse ainult planeerimise moodulis, hindamise andmed ei muutu.

Seotud andmeobjektid:

Objektid#AssessmentChallenge

Seotud Jira taskid

NSIL-665 - Getting issue details... STATUS

NSIL-904 - Getting issue details... STATUS

Eeltingimused ja kasutusõigused

Kui tegemist on asutusepõhise väljakutsega (AssessmentChallenge.assessment.assessmentScope = INSTITUTIONAL):
- Kasutajal peab olema seos väljakutse asutusega ja sama asutuse eesmärkide lisamise ja muutmise õigus.
  - AssessmentChallenge.assessment.institution.id = Kasutaja poolt valitud rolliga seotud asutus
  - Õigust reguleerib privileeg: HSILM_PLANNING_GOAL_MANAGE.
Kui tegemist on isikupõhise väljakutsega (AssessmentChallenge.assessment.assessmentScope = INDIVIDUAL):
- Kasutaja peab olema väljakutse omanik ja tal peab olema seos väljakutse asutuse ja ametikohaga.
  - AssessmentChallenge.personalCode = päringu käivitanud kasutaja isikukood.
  - AssessmentChallenge.assessment.institution.id = Kasutaja poolt valitud rolliga seotud asutus
  - AssessmentChallenge.assessment.jobsite = Kasutaja poolt valitud rolliga seotud ametikoht
  - Eraldi privileegi ei ole vaja.
  - Selgitus: Väljakutse omanik saab muuta selle olulisust ainult siis, kui see on seotud kehtiva ametikohaga, mille ta on rolli valikus valinud. Lõpetatud ametikoha väljakutse olulisust muuta ei saa.
Väljakutsega seotud eesmärgi meeskonnaliikmel ei ole õigust muuta väljakutse olulisust.

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
assessmentChallengeId	1	UUID	Väljakutse peab eksisteerima. AssessmentChallenge.id = assessmentChallengeId Väljakutse ei tohi olla vanem kui viis aastat. Väljakutse peab olema seotud hindamise liigi põhjal uusima hindamisega.	Väljakutse identifikaator.
elementId	1	UUID	Element peab eksisteerima. AssessmentChallenge.elements.id = elementId Elemendi tüüp peab olema "olulisus". AssessmentChallenge.elements.code = IMPORTANCE	Elemendi id.
selectedValue	1	Integer	Valitud väärtus peab jääma skaala sisse. AssessmentChallenge.elements.scale.valuesFrom >= selectedValue <= AssessmentChallenge/elements.scale.valuesUntil	Skaalal valitud väärtus.

Väljundid

Atribuut	Kohustuslikkus, mitmesus	Tüüp	Kirjeldus, täiendav info
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.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: CHALLENGE_TYPE - Väljakutse liik CHALLENGE - Väljakutse TOPIC - Teema IMPORTANCE - Olulisus
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.
1. Kui kasutajal ei ole õigust päringut teostada, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
Süsteem kontrollib, kas andmed vastavad nõuetele.
1. Kui andmed ei vasta nõuetele, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
Süsteem otsib päringus esitatud asutuse väljakutset, mis on kuni 5 aastat vana. Kasutaja saab muuta väljakutset, millega seotud hindamine on hindamiseliigi põhjal uusim.
1. Süsteem otsib Objektid#AssessmentChallenge objekti, mille:
  1. id = Sisendis esitatud "assessmentChallengeId" väärtus.
  2. assessment.institution.id = Kasutajaga seotud asutus.
  3. assessment.endDate <= Päringu teostamise aeg - 5 aastat.
  4. Kui asutusel on veel assessment.assessmentType ja assessment.id kombinatsioone, siis peab assessment.endDate olema suurim.
  5. Sama assessment.endDate korral valitakse objekt, mille assessmentChallenge.createdAt on suurim.
Süsteem muudab leitud skaala elemendi andmeid:
1. Süsteem otsib Objektid#AssessmentChallenge.elements objekti, mille:
  1. id = Sisendis esitatud "elementId" väärtus.
  2. code = IMPORTANCE.
2. Süsteem uuendab leitud Objektid#AssessmentChallenge.elements objekti andmeid:
  1. elements.scale.selectedValue = Sisendis esitatud "selectedValue" väärtus.
Süsteem tagastab uuendatud andmed.