Üldkirjeldus

Teenus võimaldab lisada päringu käivitanud kasutajale Väljakutsete vaate veergude järjestuse seadistused vastavalt valitud asutusele/ametikohale ja gruppeerimistüübile (nt hindamise liik või teema).

Seotud andmeobjektid:

Objektid#AssessmentChallengesColumnSettings

Seotud Jira taskid

NSIL-1181 - Getting issue details... STATUS

Eeltingimused ja kasutusõigused

Kasutajal on seos sisendis esitatud asutusega ja sama asutuse eesmärkide vaatamise õigus.
- institutionId = Kasutaja valitud rolliga seotud asutus
- Õigust reguleerib privileeg: HSILM_PLANNING_GOAL_VIEW.
või kasutajal on seos nii sisendis esitatud asutuse kui ka ametikohaga.
- institutionId = Kasutaja valitud rolliga seotud asutus
- jobsite = Kasutaja valitud rolliga seotud ametikoht
- Eraldi privileegi ei ole vaja.
Planeerimise meeskonnaliikme ja arhiivi rolli valinud kasutajatel ei ole õigust muuta Väljakutsete vaate veergude vaikimisi järjestust.

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	Väärtuseks peab olema kasutaja valitud rolliga seotud asutuse ID.	Viide asutusele, mille piires seadistused kehtivad.
jobsite	0..1	String	Väärtus peab vastama EHIS klassifikaatorile PEDAGOOG_AMETIKOHT. Väärtuseks peab olema kasutaja rolliga seotud ametikoha ID.	Viide ametikohale, mille piires seadistused kehtivad.
groupingType	1	String	Võimalikud väärtused: ASSESSMENT_TYPE - hindamise liik THEME - teema	Määrab, mille alusel väljakutsed Väljakutsete vaates veergudesse grupeeritakse.
columns	1	Array		Kasutaja määratud veergude järjestus. Massiivis on veerud samas järjekorras, nagu kasutaja need paigutas.
columns.code	1	String	Kui groupingType on "ASSESSMENT_TYPE", peab väärtus olema EHIS klassifikaatori ASSESSMENT_TYPE kood (code); kui "THEME", siis HSILM_THEME_LABEL kood (code).	Veeru parameetri kood.

Väljundid

Atribuut	Kohustuslikkus, mitmesus	Tüüp	Kirjeldus, täiendav info
personalCode	1	String	Kasutaja isikukood.
institution	1	Object	Asutus (KOV, õppeasutus), mille piires seadistused kehtivad.
institution.id	1	String	Viide seotud asutusele EHISes.
jobsite	0..1	String	Viide ametikohale, mille piires seadistused kehtivad. Väärtustena kasutatakse EHIS klassifikaatorit PEDAGOOG_AMETIKOHT.
groupingType	1	String	Määrab, mille alusel väljakutsed Väljakutsete vaates veergudesse grupeeritakse. Võimalikud väärtused: ASSESSMENT_TYPE - hindamise liik THEME - teema
columns	1	Array	Kasutaja määratud veergude järjestus. Massiivis on veerud samas järjekorras, nagu kasutaja need paigutas.
columns.code	1	String	Veeru parameetri kood. Kui groupingType on "ASSESSMENT_TYPE", peab väärtus olema EHIS klassifikaatori ASSESSMENT_TYPE kood (code); kui "THEME", siis HSILM_THEME_LABEL kood (code).
updatedAt	1	Date	Seadistuste viimase uuendamise aeg.

Ärireegel

Ühe asutuse või asutuse ja ametikoha kombinatsiooni piires võib kasutajal olla iga gruppeerimistüübi kohta maksimaalselt üks seadistuse kirje.

Tegevused

Süsteem kontrollib, kas kasutajal on õigust päringut teostada.
1. Kui kasutajal ei ole õigust, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
Süsteem kontrollib, kas sisendandmed vastavad nõuetele.
1. Kui andmed ei vasta nõuetele, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
Süsteem kontrollib, kas kasutajal on juba olemas seadistuste kirje sisendis esitatud asutuse/ametikoha ja gruppeerimistüübiga:
1. Süsteem otsib Objektid#AssessmentChallengesColumnSettings objekti, mille:
  1. personalCode = Kasutaja isikukood
  2. institution.id = Sisendis esitatud "institutionId" väärtus
  3. jobsite = Sisendis esitatud "jobsite" väärtus (kui on määratud)
  4. groupingType = Sisendis esitatud "groupingType" väärtus
2. Kui tingimustele vastavad seadistused leitakse, need jäädavalt kustutatakse.
Süsteem lisab kasutajale uued seadistused sisendis esitatud asutuse/ametikoha ja gruppeerimistüübi kohta:
1. Süsteem loob uue Objektid#AssessmentChallengesColumnSettings objekti järgmiste andmetega:
  1. personalCode = Kasutaja isikukood
  2. institution.id = Sisendis esitatud "institutionId" väärtus
  3. jobsite = Sisendis esitatud "jobsite" väärtus (kui on määratud)
  4. groupingType = Sisendis esitatud "groupingType" väärtus
  5. columns = lisatakse kõik massiivi columns kirjed samas järjekorras, nagu need on sisendis esitatud:
    1. Iga kirje sisaldab:
      1. columns.code = vastava sisendkirje "columns.code" väärtus
  6. Kirjed lisatakse täpselt sellises järjekorras, nagu need on sisendis esitatud.
Süsteem tagastab kasutajale lisatud seadistused.

PM: API: AssessmentChallenge: POST /planning-api/assessment-challenges-column-settings