PM: UC: Eesmärgi tööülesande lisamine/muutmine

Sisukord

Üldkirjeldus

Kasutaja saab lisada eesmärgi tegevusele uue tööülesande või olemasolevat tööülesannet muuta, märkida lõpetatuks või kustutada.

Eesmärgi tööülesande lisamise/muutmise moodalakna saab avada vaates PM: UC: Eesmärkide tegevuste ja ülesannete kirjeldamine (lisamine/muutmine). 

Asutuspõhise eesmärgi puhul peab kasutajal tööülesande lisamiseks või muutmiseks olema seos vastava asutusega ning õigus eesmärkide lisamiseks ja muutmiseks. 

Õigust lisada või muuta enda isiklikke eesmärkide tööülesandeid annab kasutajale tema ametikoht.

Kasutaja, kes on valinud meeskonnaliikme rolli, saab tööülesandeid 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 tööülesandeid ei saa muuta. 

Seotud Jira taskid

NSIL-1116 - Getting issue details... STATUS

NSIL-1006 - 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 arhiveeritud.
  • Goal.archived = false
• Kui toimub tööülesande muutmine, ei tohi tööülesanne olla lõpetatud. 
  • PM: API: Goal: GET /planning-api/goals/{goalId}/activities/{goalActivityId}/tasks/{activityTaskId}.response.done = false

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

Funktsionaalsus

Selgitused

1. Modaalakna avamisel:
   1. Kasutajaliides teeb eesmärgi tegevuste nimekirja saamiseks päringu: PM: API: Goal: GET /planning-api/goals/{goalId}/activities.
      1. Päringu sisend:
         1. goalId = eesmärgi ID, mille vaates tööülesande lisamine/muutmine algatati
   2. Kasutajaliides teeb eesmärgi meeskonnaliikmete nimekirja saamiseks päringu: PM: API: Goal: GET /planning-api/goals/{goalId}/team-members.
      1. Päringu sisend:
         1. goalId = eesmärgi ID, mille vaates tööülesande lisamine/muutmine algatati
2. Modaalakna avamisel, kui toimub tööülesande muutmine:
   1. Tööülesande muutmisvaate avamine - ja seeläbi kõigi allpool kirjeldatud tegevuste teostamine - on võimalik ainult juhul, kui tööülesanne ei ole märgitud lõpetatuks. 
      1. PM: API: Goal: GET /planning-api/goals/{goalId}/activities/{goalActivityId}/tasks/{activityTaskId}.response.done = false  
   2. Kasutajaliides teeb tööülesande andmete kuvamiseks päringu: PM: API: Goal: GET /planning-api/goals/{goalId}/activities/{goalActivityId}/tasks/{activityTaskId}.
      1. Päringu sisend:
         1. goalActivityTaskId = muudetava tööülesande ID
         2. goalActivityId = tegevuse ID, millega tööülesanne on seotud
         3. goalId = eesmärgi ID, mille vaates tööülesande muutmine algatati
3. Andmete sisestamine/muutmine:
   1. Tööülesande lisamisel ja muutmise vormil saab muuta samu tööülesande andmeid.
      1. Tööülesandele ei saa määrata lõpukuupäeva, mis on varasem kui tööülesande alguskuupäev ega hilisem kui seotud tegevuse lõpukuupäev. 
         1. PM: API: Goal: GET /planning-api/goals/{goalId}/activities.response.goalActivities.endDate
   2. Kasutaja saab tööülesandele lisada rahastuse allikaid aastate kaupa.
      
      1. Rahastuse allikate lisamine ei ole kohustuslik, kuid kui rahastuse allika rida lisatakse, siis on kohustulik täita aasta ja summa.
      2. Sama aasta kohta saab lisada mitu rahastuse allikat. 
      3. Iga lisatud rahastuse allikas kuvatakse eraldi real, kirjeid aasta kaupa ei gruppeerita. 
      4. Kui vähemalt üks rahastuse allikas on olemas, kuvatakse rahastuse allikate tabeli lõpus rida "Kokku", kuhu on summeeritud summa veerg.
4. Tööülesande andmete salvestamine:
   1. Uue tööülesande lisamiseks kasutatakse päringut: PM: API: Goal: POST /planning-api/goals/{goalId}/activities/{goalActivityId}/tasks.
      1. Päringu sisend:
         1. goalId = eesmärgi ID, mille vaates tööülesande muutmine algatati
         2. taskName = välja "Tööülesande pealkiri" sisestatud väärtus
         3. goalActivityId = "Tegevus" rippmenüüst valitud väärtus
         4. goalTeamMemberId = "Vastutaja" rippmenüüst valitud väärtus
         5. startDate = väljas "Algus" valitud väärtus
         6. endDate = väljas "Lõpp" valitud väärtus
         7. taskDescription = välja "Tööülesande selgitus" sisestatud väärtus
         8. fundings nimekirja lisatakse rahastuse allikate tabelisse lisatud kirjed. Iga kirje kohta täidetakse järgmised atribuudid: 
            1. fundings.year = välja "Aasta" väärtus
            2. fundings.amount = välja "Summa" väärtus
            3. fundings.description = välja "Rahastuse selgitus" väärtus
   2. Olemasoleva tööülesande andmete muutmiseks kasutatakse päringut: PM: API: Goal: PUT /planning-api/goals/{goalId}/activities/{goalActivityId}/tasks/{activityTaskId}.
      1. URL-i parameetrid täidetakse järgmiselt:
         1. {goalId} = eesmärgi ID, mille vaates tööülesande muutmine algatati
         2. {goalActivityId} = tegevuse ID, millega tööülesanne on hetkel seotud
         3. {activityTaskId} = muudetava tööülesande ID
      2. Päringu sisend:
         1. goalActivityTaskId = muudetava tööülesande ID
         2. newGoalActivityId = "Tegevus" rippmenüüst valitud väärtus
         3. Ülejäänud andmed täidetakse samamoodi nagu tööülesande lisamise päringu puhul. 
5. Muutmisvaates on kasutajal võimalik:
   1. Tööülesanne kustutada:
      1. Vastava nupu vajutamisel käivitatakse päring: PM: API: Goal: DELETE /planning-api/goals/{goalId}/activities/{goalActivityId}/tasks/{activityTaskId}.
         1. Päringu sisend:
            1. goalActivityTaskId = eemaldatava tööülesande ID
            2. goalActivityId = tegevuse ID, millega tööülesanne on seotud
            3. goalId = eesmärgi ID, mille vaates tööülesande muutmine algatati
   2. Märkida tööülesanne lõpetatuks:
      1. Tööülesande muutmisvaate avamisel on vastav nupp vaikimisi aktiivne, kuna seda vaadet saab avada ainult siis, kui tööülesanne ei ole veel lõpetatud.  
      2. Nupule vajutamisel käivitatakse päring: PM: API: Goal: PATCH /planning-api/goals/{goalId}/activities/{goalActivityId}/tasks/{activityTaskId}/done.
         1. Päringu sisend:
            1. goalActivityTaskId = muudetava tööülesande ID
            2. goalActivityId = tegevuse ID, millega tööülesanne on seotud
            3. goalId = eesmärgi ID, mille vaates tööülesande muutmine algatati
            4. done = true
            5. Selgitus: 
               1. Selle päringuga märgitakse tööülesanne lõpetatuks (GoalActivityTask.done = true).
               2. Kui tööülesande lõpu kuupäev (GoalActivityTask.endDate) on tulevikus, kirjutatakse see üle jooksva kuupäevaga.
               3. Kui lõppkuupäev on minevikus või täna, jääb see muutmata.

Andmed

Kasutaja tegevused