PM: UC: Eesmärgi, tegevuse või tööülesande märkme lisamine/muutmine

Sisukord

Üldkirjeldus

Kasutajal on võimalik lisada eesmärgile, tegevusele või tööülesandele märkme ja vajadusel seda hiljem muuta.

Kasutaja saab märkme lisamise/muutmise modaalakna avada PM: UC: Eesmärkide tegevuste ja ülesannete kirjeldamine (lisamine/muutmine) vaatest.

Asutuspõhise eesmärgi puhul peab kasutajal märkme lisamiseks või muutmiseks olema seos vastava asutusega ning õigus eesmärkide lisamiseks ja muutmiseks. 

Õigust lisada või muuta enda isiklikke eesmärkide märkmeid annab kasutajale tema ametikoht.

Kasutaja, kes on valinud meeskonnaliikme rolli, saab märkmeid lisada ja muuta ainult nende eesmärkide puhul, mille meeskonda ta kuulub. Lisaks peab Planeerimise meeskonnaliikme rollil olema eesmärkide lisamise ja muutmise õigus.

Arhiveeritud eesmärkide märkmeid ei saa muuta.

Seotud Jira taskid

NSIL-1146 - Getting issue details... STATUS

NSIL-1147 - Getting issue details... STATUS

NSIL-1148 - Getting issue details... STATUS

Kasutajaliides

Disainid

Eeltingimused

Kasutaja on sisse loginud ja valinud rolliks:

• Asutus:
  • Kasutajal on seos eesmärgi asutusega ja sama asutuse eesmärkide lisamise ja muutmise õigus. 
    • Goal.institution.id = kasutaja poolt valitud rolliga seotud asutus
    • Õigust reguleerib privileeg: HSILM_PLANNING_GOAL_MANAGE.
• Ametikoht:
  
  • Kasutaja on eesmärgi omanik ja tal on seos nii eesmärgi asutuse kui ka ametikohaga.
    • Goal.personalCode = kasutaja isikukood
    • Goal.institution.id = kasutaja poolt valitud rolliga seotud asutus
    • Goal.jobsite = kasutaja poolt valitud rolliga seotud ametikoht
    • Eraldi privileegi ei ole vaja.
• Planeerimise meeskonna liige:
  • Kasutaja on eesmärgi meeskonnas ja planeerimise meeskonna liikme rollil on eesmärkide lisamise ja muutmise õigus.
    • Goal.goalScope = INSTITUTIONAL või INDIVIDUAL
    • Goal.teamMembers.id = GoalTeamMember.id, mille personalCode = kasutaja isikukood
    • Õigust reguleerib privileeg: HSILM_PLANNING_GOAL_MANAGE.
• Eesmärk ei ole staatuses "Arhiveeritud" – arhiveeritud eesmärkide andmeid ei saa muuta.
  • Goal.archived = false
• Kasutajal, kes on valinud "Arhiiv" rolli, ei ole sellele vaatele ligipääsu. 

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

Funktsionaalsus

Selgitused

1. Modaalakna avamisel, kui toimub märkme muutmine:
   1. Kasutajaliides teeb muudetava märkme andmete kuvamiseks päringu: PM: API: Goal: GET /planning-api/goals/{goalId}/notes/{goalNoteId}.
      
      1. Päringu sisend:
         1. goalNoteId = muudetava märkme ID
         2. goalId = eesmärgi ID, mille vaates märkme muutmine algatati
   2. Kasutajale kuvatakse märkme muutmisvorm, kus väljad on eeltäidetud päringuga saadud andmetega.
2. Andmete sisestamine/muutmine:
   1. Uue märkme lisamisel saab kasutaja määrata, kas märge on nähtav kõigile kasutajatele, kellel ligipääs planeerimismoodulisse, või ainult märkme lisajale. 
   2. Märkme muutmisel ei ole võimalik märkme nähtavust muuta.
3. Märkme andmete salvestamine:
   1. Uue märkme lisamiseks käivitatakse päring: PM: API: Goal: POST /planning-api/goals/{goalId}/notes.
      1. Uue märkme lisamisel salvestatakse selle juurde vastav seos olenevalt sellest, kas lisamine algatati eesmärgi, tegevuse või tööülesande juurest.
      2.  Päringu sisend:
         1. goalId = eesmärgi ID, mille vaates märkme lisamine algatati
         2. visibilityType = väljas "Nähtavus" valitud väärtus
         3. description = väljal "Märkme kirjeldus" sisestatud väärtus
         4. Kui märkme lisamine algatati tegevuse või tööülesande juurest, lisatakse sisendisse ka üks järgmistest väljadest:
            1. goalActivityId = tegevuse ID, millele märge lisatakse
            2. goalActivityTaskId = tööülesande ID, millele märge lisatakse
   2. Olemasoleva tegevuse andmete muutmiseks kasutatakse päringut: PM: API: Goal: PUT /planning-api/goals/{goalId}/notes/{goalNoteId}.
      1. Päringu sisend:
         1. goalNoteId = muudetava märkme ID
         2. goalId = eesmärgi ID, mille vaates märkme muutmine algatati
         3. description = väljal "Märkme kirjeldus" sisestatud väärtus
4. Kasutajal on võimalik märge kustutada.
   
   1. Vastava nupu vajutamisel kävitatakse päring: PM: API: Goal: DELETE /planning-api/goals/{goalId}/notes/{goalNoteId}.
      1. Päringu sisend:
         1. goalNoteId = kustutava märkme ID
         2. goalId = eesmärgi ID, mille vaates märkme kustutamine algatati.

Andmed

Kasutaja tegevused