PM: UC: Eesmärgi märkmete vaatamine

Sisukord

Üldkirjeldus

Kasutajal on võimalik vaadata kõiki eesmärgi, selle tegevuste või tööülesannete kohta lisatud märkmeid ning vastava õiguse olemasolul muuta ja kustutada neid.

Eesmärgi märkmete modaalakna saab kasutaja avada vastava eesmärgi PM: UC: Eesmärkide tegevuste ja ülesannete kirjeldamine (lisamine/muutmine) vaatest või PM: UC: Eesmärkide vaatamine vaatest.

Asutuspõhiste eesmärkide märkmete vaatamiseks peab kasutajal olema seos vastava asutusega ning eesmärkide vaatamise õigus. 

Õigust vaadata enda isiklikke eesmärkide märkmeid (sh arhiivis) annab kasutajale tema ametikoht.

Kasutaja, kelle rolliks on "Planeerimise meeskonna liige", saab vaadata märkmeid vaid nende eesmärkide puhul, mis kuuluvad asutusele / ametikohale, mille tal on eelnevalt Planeerimise meeskonna liikme töölaual valinud, ning mille meeskonna liige ta on. Lisaks peab Planeerimise meeskonnaliikme rollil olema eesmärkide vaatamise õigus.

Seotud Jira taskid

NSIL-1149 - Getting issue details... STATUS

NSIL-1174 - 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 vaatamise õigus. 
    • Goal.institution.id = kasutaja poolt valitud rolliga seotud asutus
    • Õigust reguleerib privileeg: HSILM_PLANNING_GOAL_VIEW.
• Ametikoht / Arhiiv:
  
  • Kasutaja on eesmärgi omanik.
    • Goal.personalCode = kasutaja isikukood
    • Eraldi privileegi ei ole vaja.
• Planeerimise meeskonna liige:
  • Kasutaja on eesmärgi meeskonnas ja planeerimise meeskonna liikme rollil on eesmärkide vaatamise õigus.
    • Goal.goalScope = INSTITUTIONAL või INDIVIDUAL
    • Goal.teamMembers.id = GoalTeamMember.id, mille personalCode = kasutaja isikukood
    • Õigust reguleerib privileeg: HSILM_PLANNING_GOAL_VIEW.

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

Funktsionaalsus

Selgitused

1. Vaate avamisel:
   1. Kasutajaliides teeb märkmete kuvamiseks päringu: PM: API: Goal: GET /planning-api/goals/{goalId}/notes.
      1. Päringu sisend:
         1. goalId = eesmärgi ID, mille vaates märkmete vaatamise tegevus algatati
      2. Selgitus: 
         1. Päringuga tagastatakse eesmärgi märkmed vastavalt neile märgitud nähtavusele.
            1. Kõik märkmed, mille nähtavus "Avalik planeerimiskeskkonnas", tagastatakse alati.
            2. Kõik märkmed, mille nähtavus on "Privaatne (nähtav ainult mulle)", tagastatakse ainult juhul kui andmeid pärib kasutaja, kes märkme lisas.
   2. Süsteem kuvab päringuga saadud märkmed.
      1. "Kuva märkmed" rippmenüüs on eelvalitud valik "Kõik".
      2. Märkmed järjestatakse muutmise aja järgi kahanevas järjekorras (uuemad eespool).
         1. PM: API: Goal: GET /planning-api/goals/{goalId}/notes.response.goalNotes.modifiedAt
      3. Kui märge on lisatud tegevusele või tööülesandele, kuvatakse enne märkme teksti vastava tegevuse või tööülesande pealkiri. 
         1. PM: API: Goal: GET /planning-api/goals/{goalId}/notes.response.goalNotes.goalActivityId != NULL
         2. VÕI
         3. PM: API: Goal: GET /planning-api/goals/{goalId}/notes.response.goalNotes.goalActivityTaskId != NULL
2. Kasutajal saab märkmeid filtreerida järgmiste parameetrite alusel:
   1. Kõik - kuvatakse kõik märkmed, mille tagastas päring PM: API: Goal: GET /planning-api/goals/{goalId}/notes.
   2. Eesmärk - kuvatakse ainult eesmärgile endale lisatud märkmed, st märkmed, mille puhul:
      • PM: API: Goal: GET /planning-api/goals/{goalId}/notes.response.goalNotes.goalActivityId = NULL
      • JA
      • PM: API: Goal: GET /planning-api/goals/{goalId}/notes.response.goalNotes.goalActivityTaskId = NULL
   3. Tööülesanded - kuvatakse ainult tööülesannetele lisatud märkmed, st märkmed, mille puhul:
      • PM: API: Goal: GET /planning-api/goals/{goalId}/notes.response.goalNotes.goalActivityTaskId != NULL
   4. Tegevused - kuvatakse ainult tegevustele lisatud märkmed, st märkmed, mille:
      • PM: API: Goal: GET /planning-api/goals/{goalId}/notes.response.goalNotes.goalActivityId != NULL
   5. Korraga saab valida ainult ühe valiku.
   6. Kui valitud kategoorias märkme puuduvad, saab kasutaja siiski selle valiku teha. Sellisel juhul kuvatakse märkmete nimekirja asemel tühi teade.
3. Kasutajal on võimalik märkmetega toimetada järgmiselt:
   1. Üldtingimused:
      1. Allpool kirjeldatud tegevused on võimalikud (kasutaja saab avada märkme juurest tegevuste menüü) ainult järgmiste tingimuste täitmisel:
         1. Kasutaja valitud roll EI OLE "Arhiiv" - lõppenud ametikohtadega seotud planeerimise andmeid ei ole lubatud muuta.
         2. Eesmärk ei ole arhiveeritud.
            1. PM: API: Goal: GET /planning-api/goals/{goalId}.response.archived = false
         3. Kasutajal on õigus muuta märkmeid:
            1. Kui tegemist on asutusepõhise eesmärgiga (Goal.goalScope = INSTITUTIONAL):
               • Kasutajal on sama asutuse eesmärkide lisamise ja muutmise õigus. 
                 • Õigust reguleerib privileeg: HSILM_PLANNING_GOAL_MANAGE.
            2. Kui tegemist on isikupõhise eesmärgiga (Goal.goalScope = INDIVIDUAL):
               •  Kasutaja on eesmärgi omanik ja tal on seos eesmärgi asutuse ja 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.
            3. Või kasutaja on eesmärgi meeskonnas ja planeerimise meeskonna liikme rollil on eesmärkide lisamise ja muutmise õigus. 
   2. Märkme muutmine:
      1. Märkme kirjelduse muudetud teksti salvestamiseks 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 märkmeid vaates kuvatakse
            3. description = väljal "Märkme kirjeldus" sisestatud väärtus
   3. Märkme kustutamine:
      1. Märkme kustutamiseks kasutatakse päringut: 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 märkmeid vaates kuvatakse
      2. Kui kustutatakse viimane allesjäänud märge, sulgub modaalaken automaatselt.

Andmed

Kasutaja tegevused