PM: UC: Väljakutsete nimekirja kuvamine

Sisukord

Üldkirjeldus

Kasutajal on võimalik vaadata hindamise tulemustes sõnastatud väljakutsete nimekirja hindamise liikide või teemade kaupa gruppeeritult. Iga väljakutse kohta on võimalik vaadata sellega seotud pooleliolevate ja aktiivsete eesmärkide nimekirja.

Kasutaja jõuab väljakutsete nimekirja vaatesse töölaualt kui tal on planeerimise moodulis eesmärkide vaatamise õigus, kuid ei ole eesmärkide lisamise ja muutmise õigust.

Ametikoha rolli valinud kasutaja kunagi sellesse vaatesse ei jõua, kuna tal on vaikimisi õigus hallata oma ametikohaga seotud planeerimisi. Seega suunatakse teda töölaual lingile "Väljakutsete" vajutamisel alati vaatesse PM: UC: Väljakutsete eesmärgile lisamine/muutmine.

Seotud Jira taskid

NSIL-780 - Getting issue details... STATUS

NSIL-837 - Getting issue details... STATUS

NSIL-1178 - Getting issue details... STATUS

NSIL-1151 - Getting issue details... STATUS

Kasutajaliides

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 vaatamise õ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_VIEW.
2. Arhiiv:
   1. Väljakutsed ja eesmärgid on isikupõhised ning seotud kasutaja isikukoodiga.
      1. AssessmentChallenge.assessment.assessmentScope = INDIVIDUAL
      2. AssessmentChallenge.assessment.personalCode = Kasutaja isikukood
      3. Goal.goalScope = INDIVIDUAL
      4. Goal.personalCode = Kasutaja isikukood
   2. Eraldi privileegi ei ole vaja.
3. Ametikoha rolli valinud kasutaja kunagi sellesse vaatesse ei jõua, kuna tal on vaikimisi õigus hallata oma ametikohaga seotud planeerimisi. Seega suunatakse teda töölaual lingile "Väljakutsete" vajutamisel alati vaatesse PM: UC: Väljakutsete eesmärgile lisamine/muutmine.
4. Meeskonnaliikme 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 avamisel:
   1. Sõltuvalt kasutaja valitud rollist - kas asutus või arhiiv - pärib kasutajaliides vastavad väljakutsed ja eesmärgid.
      1. Väljakutsete nimekirja saamiseks tehakse päring: 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 arhiiv:
               1. Päringu sisend:
                  1. jobsite = Arhiivi töölaualt valitud ametikoha tunnus
                  2. institutionId = Valitud ametikohaga seotud asutuse ID
      2. 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 arhiiv:
               1. jobsite = Arhiivi töölaualt valitud ametikoha tunnus
               2. institutionId = Valitud ametikohaga seotud asutuse ID
   2. 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 arhiiv:
            1. jobsite = Arhiivi töölaualt valitud kasutaja lõppenud ametikoha tunnus
            2. institutionId = Arhiivi töölaualt valitud ametikohaga seotud asutuse ID
   3. 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.
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. groupingType =
            1. "ASSESSMENT_TYPE" - kui kasutaja on muutnud hindamise liikide veergude järjestust;
            2. "THEME" - kui kasutaja on muutnud teemade veergude järjestus. 
         3. 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. Klassifikaatori ridade tekstide kuvamiseks kasutatakse teenust GET ClassifierItems või GET ClassifierItem.

Andmed

Kasutaja tegevused