PM: UC: Eesmärgi tegevuse lisamine/muutmine

Sisukord

Üldkirjeldus

Kasutaja saab lisada eesmärgile uue tegevuse või olemasolevat tegevust muuta, märkida lõpetatuks või kustutada.

Eesmärgi tegevuse lisamise/muutmise modaalakna saab avada vaates PM: UC: Eesmärkide tegevuste ja ülesannete kirjeldamine (lisamine/muutmine). 

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

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

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

Seotud Jira taskid

NSIL-1104 - Getting issue details... STATUS

NSIL-1002 - 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
• Kasutajal, kellel on valitud rolliks "Arhiiv", 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 tegevuse muutmine:
   1. Kasutajaliides teeb päringu tegevuse andmete kuvamiseks: PM: API: Goal: GET /planning-api/goals/{goalId}/activities/{goalActivityId}.
      1. Päringu sisend:
         1. goalActivityId = muudetava tegevuse ID
         2. goalId = eesmärgi ID, mille vaates tegevuse muutmine algatati
   2. Kasutajaliides teeb päringu tegevusega seotud tööülesannete rahastuse allikate saamiseks: PM: API: Goal: GET /planning-api/goals/{goalId}/tasks.
      1. Päringu sisend: sama, mis eelmisel päringul.
   3. Kasutajale kuvatakse tegevuse muutmisvorm, kus väljad on eeltäidetud eelnevate päringute andmetega:
      1. Tegevuse rahastuse allikad:
         1. Tegevuse rahastuse allikate tabel kuvatakse alati.
         2. Lisamisvaates:
            1. Kui kasutaja ei ole veel ühtegi rahastuse allikat lisanud, kuvatakse tabelis tühi teade. 
         3. Muutmisvaates:
            1. Tabel on eeltäidetud päringu PM: API: Goal: GET /planning-api/goals/{goalId}/activities/{goalActivityId} vastuses tagastatud fundings-objekti kirjedega.
            2. Kui tegevusel puuduvad rahastuse allikad, kuvatakse tabelis tühi teade.
               1. PM: API: Goal: GET /planning-api/goals/{goalId}/activities/{goalActivityId}.response.fundings = NULL
         4. Kui tegevusele on lisatud vähemalt üks rahastuse allikas, kuvatakse tabeli lõpus rida "Kokku", kuhu on summeeritud kõigi allikate summad.
            1. PM: API: Goal: GET /planning-api/goals/{goalId}/activities/{goalActivityId}.response.goalActivityTasks.fundings.amount
      2. Tegevuse alla kuuluvate tööülesannete rahastuse allikad: 
         1. Tabel kuvatakse ainult juhul, kui tegevusel leidub mõni tööülesanne, millele on lisatud rahastuse allikaid.
            
            1. PM: API: Goal: GET /planning-api/goals/{goalId}/tasks.response.goalActivityTasks - vähemalt ühe tagastatud tööülesande puhul on fundings != NULL
         2. Rahastuse summad kuvatakse summeerituna aastate kaupa, st iga tööülesannete päringuna tagastatud unikaalne aasta kuvatakse tabelis ainult ühe reana.
            1. PM: API: Goal: GET /planning-api/goals/{goalId}/tasks.response.goalActivityTasks.fundings.year
         3. Kasutajale kuvatakse koondtabeli lõpus rida "Kokku", kuhu on summeeritud kõigi aastate rahastuse summad.
2. Andmete sisestamine/muutmine:
   1. Tegevuse lisamise ja muutmise vormil saab muuta samu tegevuse andmeid.
   2. Kasutaja saab tegevusele 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.
3. Tegevuse andmete salvestamine:
   1. Uue tegevuse lisamiseks eesmärgile käivitatakse päring: PM: API: Goal: POST /planning-api/goals/{goalId}/activities.
      1. Päringu sisend:
         1. goalId = eesmärgi ID, mille vaates tegevuse lisamine algatati
         2. activityName = välja "Tegevuse pealkiri" sisestatud väärtus
         3. goalTeamMemberId = "Vastutaja" rippmenüüst valitud väärtus
         4. startDate = väljas "Algus" valitud väärtus
         5. endDate = väljas "Lõpp" valitud väärtus
         6. activityDescription = välja "Tegevuse selgitus" sisestatud väärtus
         7. themes nimekirja lisatakse "Teema" rippmenüüst valitud väärtused. Iga valitud teema kohta lisatakse järgmine kirje:
            1. themes.themeType = valitud teema tunnus
         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 tegevuse andmete muutmiseks kasutatakse päringut: PM: API: Goal: PUT /planning-api/goals/{goalId}/activities/{goalActivityId}.
      1. Päringu sisend:
         1. goalActivityId = muudetava tegevuse ID
         2. Ülejäänud andmed täidetakse samamoodi nagu tegevuse lisamise päringu puhul. 
4. Kasutajal on võimalik:
   1. Tegevus kustutada:
      1. Vastava nupu vajutamisel käivitatakse päring: PM: API: Goal: DELETE /planning-api/goals/{goalId}/activities/{goalActivityId}.
         1. Päringu sisend:
            1. goalActivityId = eemaldatava tegevuse ID
            2. goalId = eesmärgi ID, mille vaates tegevuse muutmine algatati
   2. Märkida tegevus lõpetatuks:

      1. Tegevuse lõpetamine on lubatud (nupp kuvatakse aktiivsena) ainult juhul, kui:

         • Tegevuse lõpukuupäev on tulevikus VÕI 
           • PM: API: Goal: GET /planning-api/goals/{goalId}/activities/{goalActivityId}.response.endDate > jooksev kuupäev
         • Vähemalt üks tegevusega seotud tööülesannetest on lõpetamata:
           • PM: API: Goal: GET /planning-api/goals/{goalId}/tasks.response.goalActivityTasks.id, mille goalActivityId = muudetava tegevuse ID ja done = false.
      2. Kui ülaltoodud tingimused ei ole täidetud, kuvatakse tegevuse lõpetamise nupp mitteaktiivsena. 
      3. Kui nupp on aktiivne ja kasutaja vajutab sellele, käivitatakse päring: PM: API: Goal: PATCH /planning-api/goals/{goalId}/activities/{goalActivityId}/done.
         1. Päringu sisend:
            1. goalActivityId = muudetava tegevuse ID
            2. goalId = eesmärgi ID, mille vaates tegevuse muutmine algatati
         2. Selgitus:
            1. Kui tegevuse lõpukuupäev on tulevikus, määratakse tegevuse lõpukuupäevaks (GoalActivity.endDate) jooksev kuupäev. 
            2. Kõik tegevusega seotud lõpetamata tööülesanded märgitakse lõpetatuks (GoalActivityTask.done = true).
            3. Kui mõnel lõpetamata tööülesandel on lõpukuupäev (GoalActivityTask.endDate) tulevikus, kirjutatakse see üle jooksva kuupäevaga.

Andmed

Kasutaja tegevused