PM: UC: Väljakutsete eesmärgile lisamine/muutmine

Sisukord

Üldkirjeldus

Kasutajal on võimalik vaadata hindamise tulemustes sõnastatud väljakutsete nimekirja hindamise liikide või teemade kaupa sorteeritult. Iga väljakutse kohta on võimalik vaadata sellega seotud eesmärkide nimekirja. Kasutaja saab muuta väljakutse olulisuse skoori ja valida väljakutseid, mida soovib eesmärgiga siduda.

Kasutaja jõuab väljakutsete eesmärgile lisamise vaatesse:

• töölaualt,
• avades väljakutsete lisamise/muutmise modaalakna vaates PM: UC: Eesmärkide kirjeldamine (lisamine/muutmine) või
• liikudes vaatest PM: UC: Eesmärkide kirjeldamine (lisamine/muutmine) või PM: UC: Eesmärkide tegevuste ja ülesannete kirjeldamine (lisamine/muutmine) väljakutsete vaatesse.

Arhiveeritud eesmärkide väljakutseid ei saa muuta.

Seotud Jira taskid

NSIL-889 - Getting issue details... STATUS

NSIL-1131 - Getting issue details... STATUS

NSIL-1151 - Getting issue details... STATUS

Kasutajaliides

Jäljerida

Avaleht → Töölaud → Väljakutsed

Disainid

Eeltingimused

Kasutaja on sisse loginud ja valinud rolliks:

1. Asutus:
   1. Väljakutsed ja eesmärgid on asutusepõhised ning seotud kasutaja asutusega. Kasutajal on sama asutuse eesmärkide lisamise ja muutmise õigus:
      1. AssessmentChallenge.assessment.assessmentScope = INSTITUTIONAL
      2. AssessmentChallenge.assessment.institution.id = Kasutaja valitud rolliga seotud asutus
      3. Goal.goalScope = INSTITUTIONAL
      4. Goal.institution.id = Kasutaja valitud rolliga seotud asutus
      5. Õigust reguleerib privileeg: HSILM_PLANNING_GOAL_MANAGE.
2. Ametikoht:
   1. Väljakutsed ja eesmärgid on isikupõhised ning seotud kasutaja isikukoodi, ametikoha ja asutusega.
      1. AssessmentChallenge.assessment.assessmentScope = INDIVIDUAL
      2. AssessmentChallenge.assessment.personalCode = Kasutaja isikukood
      3. AssessmentChallenge.assessment.institution.id = Kasutaja valitud rolliga seotud asutus
      4. AssessmentChallenge.assessment.jobsite = Kasutaja valitud rolliga seotud ametikoht
      5. Goal.goalScope = INDIVIDUAL
      6. Goal.personalCode = Kasutaja isikukood
      7. Goal.institution.id = Kasutaja valitud rolliga seotud asutus
      8. Goal.jobsite = Kasutaja valitud rolliga seotud ametikoht
   2. Eraldi privileegi ei ole vaja.
3. Eesmärgid ei ole arhiveeritud.
   1. Goal.archived = false
4. Planeerimise meeskonnaliikme ja arhiivi rolli valinud kasutajal ei ole antud vaatele ligipääsu. 

Planeerimise mooduli kasutusrollide ja õiguste kohta saab täpsemalt infot leida lehelt Kasutusõigused ja rollid.

Funktsionaalsus

Selgitused

1. Vaate/modaali avamisel:
   1. Sõltuvalt kasutaja valitud rollist (asutus või ametikoht) päritakse vastavad väljakutsed ja eesmärgid.
   2. Kasutajaliides teeb väljakutsete nimekirja saamiseks päringu: PM: API: AssessmentChallenge: GET /planning-api/assessment-challenges.
      1. Päringu sisend:
         1. Kui kasutaja rolliks on asutus:
            1. assessmentScope =  "INSTITUTIONAL"
            2. institutionId = Kasutaja valitud rolliga seotud asutuse ID
         2. Kui kasutaja rolliks on ametikoht:
            1. assessmentScope = "INDIVIDUAL"
            2. institutionId = Kasutaja valitud rolliga seotud asutuse ID
            3. jobsite = Kasutaja valitud rolliga seotud ametikoha tunnus
   3. Eesmärkide nimekirja saamiseks: PM: API: Goal: GET /planning-api/goals.
      1. Päringu sisend:
         1. Kui kasutaja rolliks on asutus:
            1. goalScope = "INSTITUTIONAL"
            2. institutionId = Kasutaja valitud rolliga seotud asutuse ID
         2. Kui kasutaja rolliks on nii asutus kui ametikoht:
            1. goalScope = "INDIVIDUAL"
            2. institutionId = Kasutaja valitud rolliga seotud asutuse ID
            3. jobsite = Kasutaja valitud rolliga seotud ametikoht
   4. Veergude järjestuse seadistuste saamiseks: PM: API: AssessmentChallenge: GET /planning-api/assessment-challenges-column-settings.
      1. Päringu sisend:
         1. Kui kasutaja rolliks on asutus:
            1. institutionId = Kasutaja valitud rolliga seotud asutuse ID
         2. Kui kasutaja rolliks on ametikoht:
            1. institutionId = Kasutaja valitud rolliga seotud asutuse ID
            2. jobsite = Kasutaja valitud rolliga seotud ametikoha tunnus
   5. Kasutajaliides kuvab päringuga saadud väljakutsed.
      1. Vaikimisi on väljakutsed sorteeritud hindamise liigi järgi.
         1. Iga väljakutsetega seotud unikaalse hindamise liigi kohta kuvatakse vaates eraldi veerg, kus kasutaja näeb vastava kategooria väljakutseid. 
            1. PM: API: AssessmentChallenge: GET /planning-api/assessment-challenges.response.assessmentChallenges.assessment.assessmentType
      2. Kui väljakutsed puuduvad, kuvatakse vastav infoteade.
         1. Hindamise liikide/teemade veerge sellisel juhul ei kuvata.
   6. Eesmärgiga seotud väljakutsete eeltäitmine:
      1. Kui tegemist on Väljakutsete eesmärgile lisamise modaaliga (avaneb vaates PM: UC: Eesmärkide kirjeldamine (lisamine/muutmine) "Lisa väljakutse" nupu vajutamisel):  
         
         1. Kui modaal avatakse salvestatud eesmärgi vahelehelt, siis:
            1. Süsteem pärib eesmärgiga seotud väljakutsed: PM: API: Goal: GET /planning-api/goals/{goalId}. Päringu sisend: goalId = eesmärgi ID.
         2. Kui modaal avatakse Uue eesmärgi lisamise vormilt, siis:
            1. Kasutajaliides eeltäidab väljakutsete märgised vastavalt valikutele, mida kasutaja viimati tegi eesmärgi lisamise voo 1. või 2. sammus.
      2. Kui tegemist on vaatega PM: UC: Väljakutsete eesmärgile lisamine/muutmine:
         1. Kui kasutaja ei ole pärast viimast eesmärgi lisamise alustamist selles vaates (eesmärgi lisamise voo 1. sammus) veel uut eesmärki loonud, siis:
            1. Kuvatakse eelvalituna samasugused väljakutsed, mida ta viimati valis voo 1. või 2. sammus. 
         2. Kui eelmine eesmärk on juba loodud ja kasutaja ei jätka poolelijäänud lisamist, siis:
            1. Vaates ei ole ühtegi eelvalitud väljakutset - kasutaja alustab uue eesmärgi loomist nullist.
2. Kasutajal on võimalik muuta, mille alusel väljakutsed veergudesse gruppeeritakse:
   1. Hindamise liikide alusel - käitub nagu eelnevalt kirjeldatud.
   2. Teemade alusel - kuvatakse kõik tagastatud väljakutsetega seotud unikaalsed teemad eraldi veergudena:
      1. PM: API: AssessmentChallenge: GET /planning-api/assessment-challenges.response.assessmentChallenges.elements.id.selectedEhisClassifierItems.name, mille elements.code = "TOPIC".
   3. Veergude järjestus hindamise liikide alusel gruppeerimisel:
      1. Kui kasutaja ei ole veergude järjekorda varem muutunud, kasutatakse järgmist loogikat:
         1. Esiteks järjestatakse veerud liigiga seotud valdkonna alusel tähestikulises järjekorras:
            • PM: API: AssessmentChallenge: GET /planning-api/assessment-challenges.response.assessmentChallenges.assessment.domain
         2. Seejärel klassifikaatori järjekorranumbri (ASSESSMENT_TYPE.seqNo) alusel.
            1. Kui mõnel valdkonna liigil puudub järjekorra number, kuvatakse see selle valdkonna liikide lõpus, tähestikulises järjekorras liigi nimetuse järgi.
            2. Kui mõne valdkonna puhul ei ole ühelgi selle valdkonna liigil järjekorra numbrit, järjestatakse kõik selle valdkonna liigid tähestikulises järjekorras liigi nimetuse järgi. 
      2. Kui kasutaja on veergude järjekorda muutnud:
         1. PM: API: AssessmentChallenge: GET /planning-api/assessment-challenges-column-settings tagastas objekti assessmentChallengeColumnSettings, mille groupingType = "ASSESSMENT_TYPE". 
         2. Kuvatakse need täpselt sellises järjekorras, nagu kasutaja need viimati paigutas. 
            1. PM: API: AssessmentChallenge: GET /planning-api/assessment-challenges-column-settings.response.assessmentChallengeColumnSettings.columns, mille groupingType = "ASSESSMENT_TYPE"
         3. Kui uuel sisselogimisel tagastatakse väljakutse, mille hindamise liik puudub kasutaja seadistustes, lisatakse see tähestikulises järjekorras olemasolevate veergude lõppu.
            1. PM: API: AssessmentChallenge: GET /planning-api/assessment-challenges.response.assessmentChallenges.assessment.assessmentType
   4. Veergude järjestus teemade alusel gruppeerimisel:
      
      1. Kui kasutaja ei ole teemade järjestust muutnud, kehtib vaikimisi järgmine loogika:
         1. Veerud järjestatakse klassifikaatori järjekorranumbri HSILM_THEME_LABEL.seqNo alusel. 
         2. Teemad, millel puudub järjekorra number, kuvatakse tähestikulises järjekorras järjekorra lõpus.
      2. Kui kasutaja on teemade järjestust muutnud:
         1. PM: API: AssessmentChallenge: GET /planning-api/assessment-challenges-column-settings tagastas objekti assessmentChallengeColumnSettings, mille groupingType = "THEME".  
         2. Kuvatakse need täpselt samas järjekorras, nagu kasutaja need viimati paigutas.
            1. PM: API: AssessmentChallenge: GET /planning-api/assessment-challenges-column-settings.response.assessmentChallengeColumnSettings.columns, mille groupingType = "THEME". 
         3. Uued teemad lisatakse tähestikulises järjekorras olemasolevate veergude lõppu.
            1. PM: API: AssessmentChallenge: GET /planning-api/assessment-challenges.response.assessmentChallenges.elements.id.selectedEhisClassifierItems.name
3. Kasutajal on võimalik hindamise liikide / teemade veergude järjestust muuta, liigutades neid ükshaaval vasakule või paremale. 
   1. Vastava veeru päises nooleikoonile vajutamisel käivitatakse päring: PM: API: AssessmentChallenge: POST /planning-api/assessment-challenges-column-settings.
      
      1. Päringu sisend:
         1. Kui kasutaja rolliks on asutus:
            1. institutionId = Kasutaja poolt valitud rolliga seotud asutuse ID
         2. Kui kasutaja rolliks on ametikoht:
            1. institutionId = Kasutaja poolt valitud rolliga seotud asutuse ID
            2. jobsite = Kasutaja poolt valitud rolliga seotud ametikoha tunnus
         3. groupingType =
            1. "ASSESSMENT_TYPE" - kui kasutaja on muutnud hindamise liikide veergude järjestust;
            2. "THEME" - kui kasutaja on muutnud teemade veergude järjestus. 
         4. columns nimekirja lisatakse kõik vaates kuvatavad hindamise liigid / teemad sellises järjekorras, nagu kasutaja need paigutas.
            1. Iga hindamise liigi / teema kohta lisatakse selle kood, mis:
               1. hindamise liigi puhul vastab EHIS klassifikaatori ASSESSMENT_TYPE.code väärtusele
               2. teema puhul vastab HSILM_THEME_LABEL.code väärtusele
   2. Selgitus:
      1. Veergude järjekorra muudatused salvestatakse rollis valitud asutuse- / ametikoha- ja kasutajapõhiselt – iga kasutaja iga asutuse/ametikoha vaates näeb veerge järgmisel sisselogimisel samas järjekorras, nagu ta need viimati paigutas.

      2. Uued veerud salvestatakse kasutaja seadistusse alles siis, kui ta muudab mõne veeru asukohta.

      3. Järjestuse salvestamisel võetakse arvesse ainult need veerud, mis on vaates nähtavad (st millele vastavad väljakutsed eksisteerivad).
      4. Salvestamisel ei muudeta olemasolevat järjestust, vaid nähtavate veergude uus järjekord kirjutatakse seadistustesse üle.
4. Väljakutsed on veerus järjestatud olulisuse alusel kahanevalt. Sama olulisusega väljakutsed järjestatakse nimetuse järgi tähestilikulises järjekorras. 
   
   1. PM: API: AssessmentChallenge: GET /planning-api/assessment-challenges.response.assessmentChallenges.elements.scale.selectedValue, mille elements.code = "IMPORTANCE"
   2. PM: API: AssessmentChallenge: GET /planning-api/assessment-challenges.response.assessmentChallenges.elements.textAreaValue, mille elements.code = "CHALLENGE"
5. Kasutajal on võimalik muuta väljakutse olulisust.
   1. Väljakutse olulisuse salvestamiseks tehakse päring: PM: API: AssessmentChallenge: PATCH /planning-api/assessment-challenges/{assessmentChallengeId}/elements/{elementId}/selected-scale-value.
      1. Päringu sisend:
         1. assessmentChallengeId = Väljakutse ID, mille olulisuse hinnangut muudetakse
         2. elementId = Väljakutse elemendi ID, milles hoitakse olulisuse hinnangut
         3. selectedValue = Kasutaja poolt valitud väljakutse olulisuse uus väärtus
   2. Teemade alusel sorteerides võib sama väljakutse kuuluda mitme teema alla ja sel juhul peaks ühes kohas olulisuse muutmine uuendama väärtust igal pool, kus sama väljakutse kuvatud.
6. Kasutajal on võimalik märkida väljakutseid, mida soovib eesmärgiga siduda.
   1. Kasutaja ei pea ühtegi väljakutset eesmärgile valima, või võib valida nii palju kui soovib.
   2. Teemade alusel sorteerides võib sama väljakutse kuuluda mitme teema alla ja sel juhul peaks ühes kohas linnutamine/linnukese eemaldamine uuendama väärtust igal pool, kus sama väljakutse kuvatud.
7. Kasutajale kuvatakse paremal all ääres mitu erinevat väljakutset linnutatud on.
   1. Teemade alusel sorteerides võib sama väljakutse olla kuvatud mitme teema veerus, kuid seda loetakse üheks väljakutseks.
8. Klassifikaatori ridade tekstide kuvamiseks kasutatakse teenust GET ClassifierItems või GET ClassifierItem.
9. Ainult vaates:
   1. Kasutaja saab lehe päises ja jaluses kuvatavate sammude kaudu liikuda erinevate eesmärgi kirjeldamise sammude vahel.
      
      1. Visuaalselt on eristatud samm, milles kasutaja hetkel asub.

Andmed

Kasutaja tegevused