PM: UC: Eesmärkide tegevuste ja ülesannete kirjeldamine (lisamine/muutmine)
Sisukord
Üldkirjeldus
Kasutajal on võimalik liikuda erinevate eesmärkide vahelehtedele ja vaadata eesmärgiga seotud tegevuste ja tööülesannete kalendrit, lisada ja muuta märkmeid, meeskonnaliimeid ning meeskonna tegevusi ja tööülesandeid.
Eesmärgi tegevuste ja ülesannete lisamise või muutmise vaatesse jõuab kasutaja:
- töölaualt,
- PM: UC: Väljakutsete eesmärgile lisamine/muutmine vaatest,
- PM: UC: Eesmärkide kirjeldamine (lisamine/muutmine) vaatest.
Asutuspõhiste eesmärkide tegevuste ja ülesannete kirjeldamiseks peab kasutajal olema seos vastava asutusega ning eesmärkide lisamise ja muutmise õigus.
Õigust lisada või muuta tegevusi või tööülesandeid enda isiklikkel eesmärkidel annab kasutajale tema ametikoht.
Kasutaja, kelle rolliks on "Planeerimise meeskonna liige", näeb vaates ja saab muuta ainult neid eesmärke, mis kuuluvad asutusele / ametikohale, mille tal on eelnevalt Planeerimise meeskonna liikme töölaualt valinud, ning mille meeskonna liige ta on. Lisaks peab Planeerimise meeskonnaliikme rollil olema eesmärkide lisamise ja muutmise õigus.
Kasutajal, kes on valinud "Arhiiv" rolli, ei ole sellele vaatele ligipääsu.
Arhiveeritud eesmärke ei saa muuta.
Seotud Jira taskid
NSIL-1082 - Getting issue details... STATUS
NSIL-1120 - Getting issue details... STATUS
NSIL-1124 - Getting issue details... STATUS
NSIL-1002 - Getting issue details... STATUS
NSIL-1006 - Getting issue details... STATUS
NSIL-1123 - Getting issue details... STATUS
NSIL-1097 - Getting issue details... STATUS
NSIL-1147 - Getting issue details... STATUS
NSIL-1154 - Getting issue details... STATUS
Kasutajaliides
Jäljerida
Avaleht → Töölaud → Eesmärgid
Disainid
Eeltingimused
Kasutaja on sisse loginud ja valinud rolliks:
- Asutus:
- Kasutajal on seos eesmärkide 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.
- Kasutajal on seos eesmärkide asutusega ja sama asutuse eesmärkide lisamise ja muutmise õigus.
- Ametikoht:
- Kasutaja on eesmärkide omanik ja tal on seos nii eesmärkide 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.
- Kasutaja on eesmärkide omanik ja tal on seos nii eesmärkide asutuse kui ka ametikohaga.
- Planeerimise meeskonna liige:
- Kasutaja on eesmärkide 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.
- Kasutaja on eesmärkide meeskonnas ja planeerimise meeskonna liikme rollil on eesmärkide lisamise ja muutmise õigus.
- 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
- Vaate avamisel:
- Eesmärkide karuselli kuvamine:
- Kasutajaliides teeb päringu eesmärkide karuselli kuvamiseks: PM: API: Goal: GET /planning-api/goals.
- Eesmärgid filtreeritakse kasutaja rolli alusel.
- Otsitakse ainult kehtivaid eesmärke, st need, mis on staatuses "Pooleliolev" ja "Aktiivne".
- Kui kasutaja rolliks on asutus, siis päringu sisendiks on:
- goalScope = "INSTITUTIONAL"
- institutionId = Kasutaja poolt valitud rolliga seotud asutuse ID
- statuses = "INCOMPLETE"; "ACTIVE"
- Kui kasutaja rolliks on ametikoht, siis päringu sisendiks on:
- goalScope = "INDIVIDUAL"
- institutionId = Kasutaja poolt valitud rolliga seotud asutuse ID
- jobsite = Kasutaja poolt valitud rolliga seotud ametikoht
- statuses = "INCOMPLETE"; "ACTIVE".
- Kui kasutaja rolliks on asutus, siis päringu sisendiks on:
- Kui kasutaja rolliks on valitud "Planeerimise meeskonna liige", käivitatakse eesmärki karuselli kuvamiseks päring: PM: API: Goal: GET /planning-api/team-member-goals.
- Päringu sisend:
- goalScope = kui kasutaja on valinud Planeerimise meeskonna liikme töölaual asutuse, siis "INSTITUTIONAL"; kui ta on valinud teise isiku ametikoha, siis "INDIVIDUAL".
- institutionId = Planeerimise meeskonna liikme töölaual valitud asutuse ID
- personalCode = Planeerimise meeskonna liikme töölaual valitud isiku isikukood
- jobsite = Planeerimise meeskonna liikme töölaual valitud ametikoht
- statuses = "INCOMPLETE"; "ACTIVE"
- Päringu sisend:
- Eesmärgid järjestatakse karusellis järjekorranumbri järgi, mis määratakse eesmärgile previousGoalId parameetri alusel.
- PM: API: Goal: GET /planning-api/goals.response.goals.previousGoalId
- PM: API: Goal: GET /planning-api/team-member-goals.response.goals.previousGoalId
- Kui eesmärk on staatuses "Pooleliolev" (vt. PM Eesmärgi staatused tööprotsessis), kuvatakse vahelehe sildil hüüumärgi ikoon koos tooltip-iga: "Eesmärgi kirjeldus on pooleli. Lisage vähemalt üks tegevus.".
- PM: API: Goal: GET /planning-api/goals.response.goals.statusType
- PM: API: Goal: GET /planning-api/team-member-goals.response.goals.statusType
- Kui kasutaja kerib lehte allapoole, liigub karuselli vahelehtede pealkiri vaatega kaasa.
- Kui päring tagastab ainult ühe eesmärki, siis karuselli ega vahelehte ei kuvata.
- Kasutajaliides teeb päringu eesmärkide karuselli kuvamiseks: PM: API: Goal: GET /planning-api/goals.
- Kui kasutaja jõuab antud vaatesse (eesmärgi lisamise voo 3. sammu):
- vaatest PM: UC: Väljakutsete eesmärgile lisamine/muutmine (voo 1. sammust) - kuvatakse karusellis vaikimisi avatuna kõige väiksema järjekorranumbriga eesmärgi vaheleht.
- PM: API: Goal: GET /planning-api/goals.respose.goals.previousGoalId = NULL
- vaatest PM: UC: Eesmärkide kirjeldamine (lisamine/muutmine) (voo 2. sammust) - kuvatakse vaikimisi avatuna selle eesmärgi vaheleht, mida kasutaja viimati vaatas voo 2. sammus.
- Kui voo 2. sammus oli viimati avatud Uue eesmärgi lisamise vorm, kuid kasutaja ei ole veel uut eesmärki loonud (pärast viimast eesmärgi lisamise alustamist voo 1. sammus), siis:
- Karusellis kuvatakse vaikimisi avatuna kõige väiksema järjekorranumbriga eesmärgi vaheleht.
- PM: API: Goal: GET /planning-api/goals.response.goals.previousGoalId = NULL
- Karusellis kuvatakse vaikimisi avatuna kõige väiksema järjekorranumbriga eesmärgi vaheleht.
- Kui voo 2. sammus oli viimati avatud Uue eesmärgi lisamise vorm, kuid kasutaja ei ole veel uut eesmärki loonud (pärast viimast eesmärgi lisamise alustamist voo 1. sammus), siis:
- vaatest PM: UC: Väljakutsete eesmärgile lisamine/muutmine (voo 1. sammust) - kuvatakse karusellis vaikimisi avatuna kõige väiksema järjekorranumbriga eesmärgi vaheleht.
- Eesmärkide karuselli kuvamine:
- Vaate avamisel / eesmärgi vahelehe valimisel pärib kasutajaliides eesmärgi andmed, käivitades päringud:
- Eesmärgi põhiandmete saamiseks: PM: API: Goal: GET /planning-api/goals/{goalId}.
- Eesmärgi meeskonnakiimete saamiseks: PM: API: Goal: GET /planning-api/goal-team-members/{goalId}
- Eesmärgi tegevuste saamiseks: PM: API: Goal: GET /planning-api/goals/{goalId}/activities
- Eesmärgi tööülesannete saamiseks: PM: API: Goal: GET /planning-api/goals/{goalId}/tasks
- Eesmärgi märkmete saamiseks: PM: API: Goal: GET /planning-api/goals/{goalId}/notes
- Päringute sisendiks on karusellis avatud eesmärgi ID.
- Kasutajaliides salvestab enda mällu viimati kuvatud eesmärgi ID.
- Eesmärgi andmete kuvamine:
- Kirjeldus ja mõõdikud:
- Kuvatakse eesmärgi pealkiri ja kirjeldus.
- PM: API: Goal: GET /planning-api/goals/{goalId}.response.name
- PM: API: Goal: GET /planning-api/goals/{goalId}.response.description
- Kuvatakse eesmärgi pealkiri ja kirjeldus.
- Tegevused:
- Tegevuste nimekiri:
- Kuvatakse kõik eesmärgile lisatud tegevused.
- PM: API: Goal: GET /planning-api/goals/{goalId}/activities.response.goalActivities
- Kui eesmärgil ei ole veel ühtegi tegevust, kuvatakse vastav teade.
- Tegevused on nimekirjas järjestatud vastavalt neile määratud järjekorrale.
- PM: API: Goal: GET /planning-api/goals/{goalId}/activities.response.goalActivities.previousActivityId
- Iga tegevuse all kuvatakse selle eest vastutava isiku nimi.
- PM: API: Goal: GET /planning-api/goals/{goalId}/activities.response.goalActivities.goalTeamMemberName
- Kui tegevusele on lisatud märge, kuvatakse selle juures vastav ikoon.
- PM: API: Goal: GET /planning-api/goals/{goalId}/notes.response.goalNotes, mille goalActivityId = real kuvatava tegevuse ID
- Kuvatakse kõik eesmärgile lisatud tegevused.
- Tegevuste ja tööülesannete kalender:
- Kasutajal saab valida järgmiste kalendrivaadete vahel: nädal, kuu, kvartal või aasta.
- Vaikimisi kuvatakse eesmärgi vahelehe avamisel nädala vaade, mille päises on esimesena nähtaval jooksev nädal.
- Kalendris kuvatakse eesmärgi tegevused horisontaalsete ribadena.
- Iga tegevuse all kuvatakse samuti horisontaalsete ribadena kõik sellega seotud tööülesanded.
- PM: API: Goal: GET /planning-api/goals/{goalId}/tasks.response.goalActivityTasks, mille goalActivityId = tegevuse ID
- Iga tegevuse all kuvatakse samuti horisontaalsete ribadena kõik sellega seotud tööülesanded.
- Tegevuse/tööülesande riba algab nädalal, kuhu jääb selle alguskuupäev ja lõpeb nädalal, kuhu jääb lõpukuupäev.
- PM: API: Goal: GET /planning-api/goals/{goalId}/activities.response.goalActivities.startDate
- PM: API: Goal: GET /planning-api/goals/{goalId}/tasks.response.goalActivityTasks.startDate
- PM: API: Goal: GET /planning-api/goals/{goalId}/activities.response.goalActivities.endDate
- PM: API: Goal: GET /planning-api/goals/{goalId}/tasks.response.goalActivityTasks.endDate
- Tegevuse riba värv määratakse juhuslikult alltoodud värvide hulgast:
- #14AAAD - teal
- #468CDF - sinine
- #9467BD - lilla
- #E377C2 - roosa
- #FF7F0E - oranž
- #E6BC05 - kollane
- #2CA02C - roheline
- #7F7F7F - hall
- #8C564B - pruun
- #D62728 - punane
- #B44FB0 - soe lilla
- #1F77B4 - soe sinine
- #BCBD22 - soe roheline
- #D17805 - ooker
- Vaate vahetamisel uuenevad nii kalendri päis kui ka tegevuste ja tööülesannete ribade pikkus vastavalt valitud vaatele.
- Kalendrivaate muutmisel jääb nähtavale sama nädal, mis oli eelnevas vaates esimesena kuvatud.
- Kasutaja saab liikuda vaates edasi ja tagasi (nädala / kuu / kvartali / aasta kaupa), kus kuvatakse vastava perioodi tegevused ja tööülesanded.
- Liikumine on võimalik ainult eesmärgi perioodi piires - alates kõige varasema tegevuse alguskuupäevast kuni kõige hilisema tegevuse lõpukuupäevani.
- Lõpetatud tööülesannetele kuvatakse vastav märge.
- PM: API: Goal: GET /planning-api/goals/{goalId}/tasks.response.goalActivityTasks.done
- Tegevuste nimekiri:
- Meeskond:
- Kuvatakse eesmärgi meeskonnaliikmete nimekiri.
- PM: API: Goal: GET /planning-api/goals/{goalId}/team-members.response.goalTeamMembers
- Selgitus: Eesmärgil ei saa esineda olukorda, kus meeskonnaliikmete nimekiri on tühi, kuna eesmärgi lisaja lisatakse vaikimisi meeskonda. Viimast meeskonnaliiget ei ole võimalik eesmärgilt eemaldada.
- "Protsessijuht" rolliga meeskonnaliikmed kuvatakse nimekirjas esimesena. Nende juures kuvatakse vastav ikoon.
- Kui protsessijuhte on mitu, järjestatakse nad nime järgi tähestikulises järjekorras.
- Samal põhimõttel järjestatakse ka kõik ülejäänud meeskonnaliikmed.
- Kuvatakse eesmärgi meeskonnaliikmete nimekiri.
- Märkmed:
- Kuvatakse maksimaalselt kolm viimati lisatud märget, mis on seotud eesmärgi, tegevuse või tööülesandega. Kogu nimekirja vaatamiseks tuleb avada eraldi märkmete modaalaken.
- PM: API: Goal: GET /planning-api/goals/{goalId}/notes.response.goalNotes
- Selgitus: Päring tagastab kõik selle eesmärgi, selle tegevuste ja tööülesannetega seotud avalikud märkmed (st märkmed, mis on nähtavad kõigile, kellel on ligipääas selle eesmärgile). Privaatsetest märkmetest tagastatakse ainult need, mille kasutaja on ise lisanud.
Märkmed järjestatakse muutmise aja järgi kahanevas järjekorras (uuemad eespool).
- PM: API: Goal: GET /planning-api/goals/{goalId}/notes.response.goalNotes.modifiedAt
- Kui märkmed puuduvad, kuvatakse tühi teade.
- Kuvatakse maksimaalselt kolm viimati lisatud märget, mis on seotud eesmärgi, tegevuse või tööülesandega. Kogu nimekirja vaatamiseks tuleb avada eraldi märkmete modaalaken.
- Tööülesanded:
- Kuvatakse kõik eesmärgile lisatud tööülesanded, grupeerituna akordionitesse vastavalt tegevustele, mille alla need kuuluvad.
- PM: API: Goal: GET /planning-api/goals/{goalId}/tasks.response.goalActivityTasks
- Kui eesmärgile ei ole veel ühtegi tööülesannet lisatud, siis ühtegi tegevuste akordionit ei kuvata. Plokis kuvatakse tühi teade.
- Tegevuste akordionid on järjestatud vastavalt tegevusele määratud järjekorrale.
- PM: API: Goal: GET /planning-api/goals/{goalId}/activities.response.goalActivities.previousActivityId
- Kui tööülesandele on lisatud märge, kuvatakse selle juures vastav ikoon.
- PM: API: Goal: GET /planning-api/goals/{goalId}/notes.response.goalNotes, mille goalActivityTaskId = real kuvatava tööülesande ID
- Vaikimisi on kõik tegevuste akordionid suletud.
- Kui tööülesanne on lõpetatud, kuvatakse see linnutatuna.
- Tööülesannete kuvamise loogika on täpsemalt kirjeldatud peatükis "Andmed".
- Kuvatakse kõik eesmärgile lisatud tööülesanded, grupeerituna akordionitesse vastavalt tegevustele, mille alla need kuuluvad.
- Kirjeldus ja mõõdikud:
- Kasutajal on võimalik (vastavad nupud on kuvatud / aktiivsed):
- Eesmärgi põhiandmed:
- Muuta eesmärgi nimetust ja kirjeldust:
- Vastava ikooni vajutamisel suunatakse kasutaja eesmärgi lisamise voo 2. sammu.
- Kui kasutaja rolliks on Planeerimise meeskonna liige, siis ei ole tal õigust eesmärgi kirjeldust muuta ning seetõttu seda ikooni ei kuvata.
- Muuta eesmärgi positsiooni eesmärkide karusellis, s.t. asutuse / ametikoha pooleliolevate ja aktiivsete eesmärkide järjekorras.
- Seda tegevust saab teha ainult kasutaja, kellel on valitud rolliks asutus või ametikoht. Planeerimise meeskonnaliikme rollis kasutajal ei ole võimalik eesmärkide järjekorda muuta.
- Eesmärgi uue järjekorranumbri salvestamiseks kasutatakse päringut: PM: API: Goal: PATCH /planning-api/goals/{goalId}/move.
- Päringu sisend:
- goalId = eesmärgi ID, mille positsiooni muudetakse
- targetGoalId = eesmärgi ID, millega liigutatav eesmärk vahetab asukohta
- Päringu sisend:
- Muuta eesmärgi nimetust ja kirjeldust:
- Meeskonnaliikmed:
- Lisada eesmärgile uus meeskonnaliige ja kustutada olemasolev meeskonnaliige.
- Vastavad nupud on kuvatud ainult juhul, kui on täidetud üks järgmistest tingimustest:
- Tegemist on asutusepõhise eesmärgiga ja kasutajal on rollis valitud asutuse juures meeskonnaliikmete haldamise õigus.
- Goal.goalScope = INSTITUTIONAL
- Õigust reguleerib privileeg: HSILM_PLANNING_TEAM_MEMBER_MANAGE.
- VÕI tegemist on isikupõhise eesmärgiga ja kasutaja on eesmärgi omanik.
- Goal.goalScope = INDIVIDUAL
- Goal.personalCode = Kasutaja isikukood
- Eraldi privileegi ei ole vaja.
- VÕI kasutaja on eesmärgi meeskonnas ja planeerimise meeskonna liikme rollil on meeskonnaliikmete haldamise õigus.
- Goal.goalScope = INSTITUTIONAL või INDIVIDUAL
- Goal.teamMembers.id = GoalTeamMember.id, mille personalCode = Kasutaja isikukood
- Tegemist on asutusepõhise eesmärgiga ja kasutajal on rollis valitud asutuse juures meeskonnaliikmete haldamise õigus.
- Meeskonnaliikme lisamise tegevuse valimisel kuvab süsteem kasutajale meeskonnaliikme lisamise modaalakna: PM: UC: Meeskonnaliikme vaatamine/lisamine/muutmine.
- Meeskonnaliikme juures kustutamise nupu vajutamisel käivitab süsteem päringu: PM: API: Goal: DELETE /planning-api/team-members/{teamMemberId}.
- Päringu sisend:
- teamMemberId = eesmärgilt eemaldatava meeskonnaliikme ID
- goalId = eesmärgi ID, mille vaates tegevus algatati
- Päringu sisend:
- Vastavad nupud on kuvatud ainult juhul, kui on täidetud üks järgmistest tingimustest:
- Vaadata kõigi meeskonnaliikmete andmeid ning muuta enda andmeid ja vastava õiguse olemasolul ka teiste meeskonnaliikmete andmeid:
- Meeskonnaliikme reale vajutamisel avaneb modaalaken kõigi eesmärgi meeskonnaliikmete andmetega, kus vaikimisi on avatud valitud meeskonnaliikme akordion: PM: UC: Meeskonnaliikme vaatamine/lisamine/muutmine.
- Selgitus:
- Kui kasutaja vajutab enda isikukoodiga meeskonnaliikme reale, kuvatakse tema andmed avanenud meeskonnaliikmete modaalaknas muudetavatena.
- Kui vajutatakse mõnda teise meeskonnaliikme reale, saab tema ja ka teise meeskonnaliikmete andmed muuta ainult juhul, kui kasutajal on samad õigused, mis on vajalikud meeskonnaliikme lisamiseks ja kustutamiseks.
- Selgitus:
- Meeskonnaliikme reale vajutamisel avaneb modaalaken kõigi eesmärgi meeskonnaliikmete andmetega, kus vaikimisi on avatud valitud meeskonnaliikme akordion: PM: UC: Meeskonnaliikme vaatamine/lisamine/muutmine.
- Vaadata, milliste teiste eesmärkidega on eesmärgi meeskonnaliikmed seotud:
- Vastava nupu vajutamisel kuvab süsteem kasutajale meeskonnaliikmete eesmärkide nimekirja vaate: PM: UC: Meeskonnaliikmete eesmärkide nimekirja kuvamine.
- Lisada eesmärgile uus meeskonnaliige ja kustutada olemasolev meeskonnaliige.
- Tegevused:
- Lisada eesmärgile tegevus.
- Vastava nupu vajutamisel kuvab süsteem kasutajale modaalakna tegevuse lisamiseks: PM: UC: Eesmärgi tegevuse lisamine/muutmine.
- Vaadata tegevuse kohta sisestatud andmed.
- Tegevuste nimekirjas tegevuse rea tekstile vajutamisel kuvab süsteem kasutajale modaalakna tegevuse andmetega: PM: UC: Eesmärgi tegevuse vaatamine.
- Tegevuste kalendris tegevuse perioodi ribale vajutamisel avab süsteem eraldi aknas tegevuse detailandmed.
- Muuta tegevuse andmeid.
- Vastava nupu vajutamisel kuvab süsteem kasutajale modaalakna tegevuse andmete muutmiseks: PM: UC: Eesmärgi tegevuse lisamine/muutmine.
- Lisada tegevusele märge.
- Vastava nupu vajutamisel kuvab süsteem kasutajale modaalakna märkme lisamiseks: PM: UC: Eesmärgi, tegevuse või tööülesande märkme lisamine/muutmine.
- Muuta tegevuse positsiooni tegevuste nimekirjas:
- Vastava nupu vajutamisel käivitatakse päring: PM: API: Goal: PATCH /planning-api/goals/{goalId}/activities/{goalActivityId}/move.
- Päringu sisend:
- goalActivityId = tegevuse ID, mille positsiooni muudetakse
- targetGoalActivityId = eesmärgi ID, millega liigutatav tegevus vahetab asukohta
- goalId = eesmärgi ID, mille vaates tegevus algatati
- Päringu sisend:
- Vastava nupu vajutamisel käivitatakse päring: PM: API: Goal: PATCH /planning-api/goals/{goalId}/activities/{goalActivityId}/move.
- Lisada eesmärgile tegevus.
- Tööülesanded:
- Lisada eesmärgi tegevusele uus tööülesanne.
- Vastava nupu vajutamisel kuvab süsteem kasutajale modaalakna tööülesande lisamiseks: PM: UC: Eesmärgi tööülesande lisamine/muutmine.
- Vaadata tööülesande kohta sisestatud andmed.
- Tööülesannete nimekirjas tööülesande rea tekstile vajutamisel kuvab süsteeem kasutajale modaalakna tööülesande andmetega: PM: UC: Eesmärgi tööülesande vaatamine.
- Tegevuste kalendris tööülesande perioodi ribale vajutamisel avab süsteem eraldi aknas tööülesande detailandmed. Vaata peatükis "Andmed" ploki"Tegevuse või tööülesande detailandmed".
- Märkida tööülesanne lõpetatuks või eemaldada lõpetamise märge.
- Tööülesande linnutamisel või linnukese eemaldamisel käivitatakse päring: PM: API: Goal: PATCH /planning-api/goals/{goalId}/activities/{goalActivityId}/tasks/{activityTaskId}/done.
- Päringu sisend:
- goalActivityTaskId = muudetava tööülesande ID
- goalActivityId = tegevuse ID, millega tööülesanne on seotud
- goalId = eesmärgi ID, mille vaates tööülesande muutmine algatati
- done = true, kui tööülesandele lisati lõpetamise linnuke; false - kui linnuke eemaldati
- Selgitus:
- Kui tööülesanne märgitakse lõpetatuks ning selle lõpukuupäev on tulevikus, siis kirjutab päring lõpukuupäeva üle jooksva kuupäevaga.
- Kui lõppkuupäev on minevikus või täna, jääb see muutmata.
- Lõpetamise märge eemaldamisel tööülesande kuupäevi ei muudeta.
- Päringu sisend:
- Tööülesande linnutamisel või linnukese eemaldamisel käivitatakse päring: PM: API: Goal: PATCH /planning-api/goals/{goalId}/activities/{goalActivityId}/tasks/{activityTaskId}/done.
- Järgmised tegevused on lubatud (tööülesande juurest saab kasutaja avada tegevuste menüü) ainult siis, kui tööülesanne ei ole märgitud lõpetatuks:
- PM: API: Goal: GET /planning-api/goals/{goalId}/tasks.response.goalActivityTasks.done = false, mille goalActivityTaskId = real kuvatava tööülesande ID
- Muuta varem lisatud tööülesande andmeid:
- Vastava valiku valimisel kuvab süsteem kasutajale modaalakna tööülesande andmete muutmiseks: PM: UC: Eesmärgi tööülesande lisamine/muutmine.
- Lõpetatud tööülesande muutmiseks tuleb kasutajal esmalt eemaldada "Tehtud" linnuke.
- Lisada tööülesandele märge:
- Tegevuse valimisel kuvab süsteem kasutajale modaalakna märkme lisamiseks: PM: UC: Eesmärgi, tegevuse või tööülesande märkme lisamine/muutmine).
- Lisada eesmärgi tegevusele uus tööülesanne.
Märkmed:
- Lisada eesmärgile märkmeid, vajadusel sidudes neid sobiva tegevuse või tööülesandega.
- Vastava nupu vajutamisel kuvab süsteem kasutajale modaalakna märkme lisamiseks: PM: UC: Eesmärgi, tegevuse või tööülesande märkme lisamine/muutmine.
Vaadata kõiki eesmärgi, selle tegevuste või tööülesannete kohta lisatud märkmeid.
- Vastav nupp on aktiivne ainult juhul, kui eesmärgil, selle tegevusel või tööülesandel, on vähemalt üks märge olemas.
- PM: API: Goal: GET /planning-api/goals/{goalId}/notes.response.goalNotes != NULL
- Kui märkmeid ei ole, kuvatakse nuppu mitteaktiivsena.
- Aktiivse nupu vajutamisel avaneb modaalaken kõigi eesmärgi märkmetega: PM: UC: Eesmärgi märkmete vaatamine.
- Vastav nupp on aktiivne ainult juhul, kui eesmärgil, selle tegevusel või tööülesandel, on vähemalt üks märge olemas.
- Märkme muutmine ja kustutamine:
- NB!
- Allpool kirjeldatud tegevused ei ole võimalikud, kui:
- Märge on seotud lõpetatud tööülesandega.
- Sellisel juhul tegevuste menüüd ei kuvata üldse.
- Allpool kirjeldatud tegevused ei ole võimalikud, kui:
- Märkme muutmine:
- Tegevuse valimisel kuvab süsteem modaalakna märkme andmete muutmiseks: PM: UC: Eesmärgi, tegevuse või tööülesande märkme lisamine/muutmine.
- Märkme kustutamine:
- Tegevuse valimisel käivitatakse päring: PM: API: Goal: DELETE /planning-api/goals/{goalId}/notes/{goalNoteId}.
- Päringu sisend:
- goalNoteId = kustutava märkme ID
- goalId = eesmärgi ID, mille vaates märkme kustutamine algatati
- Päringu sisend:
- Tegevuse valimisel käivitatakse päring: PM: API: Goal: DELETE /planning-api/goals/{goalId}/notes/{goalNoteId}.
- NB!
- Lisada eesmärgile märkmeid, vajadusel sidudes neid sobiva tegevuse või tööülesandega.
- Arhiveerida eesmärki:
- Nupp kuvatakse ainult juhul, kui on täidetud üks järgmistest tingimustest:
- Tegemist on asutusepõhise eesmärgiga ja kasutajal on rollis valitud asutuse juures eesmärkide arhiveerimise ja kustutamise õigus (HSILM_PLANNING_GOAL_ARCHIVE_DELETE)
- Goal.goalScope = INSTITUTIONAL
- Õigust reguleerib privileeg: HSILM_PLANNING_TEAM_MEMBER_MANAGE.
- VÕI tegemist on isikupõhise eesmärgiga ja kasutaja on eesmärgi omanik.
- Goal.goalScope = INDIVIDUAL
- Goal.personalCode = Kasutaja isikukood
- Eraldi privileegi ei ole vaja.
- VÕI kasutaja on eesmärgi meeskonnas ja planeerimise meeskonna liikme rollil on eesmärkide arhiveerimise ja kustutamise õigus (HSILM_PLANNING_GOAL_ARCHIVE_DELETE).
- Goal.goalScope = INSTITUTIONAL või INDIVIDUAL
- Goal.teamMembers.id = GoalTeamMember.id, mille personalCode = Kasutaja isikukood
- Tegemist on asutusepõhise eesmärgiga ja kasutajal on rollis valitud asutuse juures eesmärkide arhiveerimise ja kustutamise õigus (HSILM_PLANNING_GOAL_ARCHIVE_DELETE)
Nupule vajutamisel käivitatakse päring: PM: API: Goal: PATCH /planning-api/goals/{goalId}/archive.
- Päringu sisend:
- goalId = eesmärgi ID, mida arhiveeritakse
- Päringu sisend:
- Nupp kuvatakse ainult juhul, kui on täidetud üks järgmistest tingimustest:
- Kasutaja saab lehe päises ja jaluses kuvatavate sammude kaudu liikuda erinevate eesmärgi lisamise voo sammude vahel.
- Visuaalselt on eristatud samm, milles kasutaja hetkel asub.
- Kui kasutaja rolliks on Planeerimise meeskonna liige, siis sammude navigatsiooni ei kuvata, kuna tal puudub võimalus liikuda eesmärgi lisamise voo sammude vahel.
- Eesmärgi põhiandmed:
Andmed
| Elemendi nimetus | Selgitus/Näide |
|---|---|
| Lehe päis | |
| - |
1 Väli väljakutsed 2 Sõnasta eesmärk 3 Kirjelda tegevused ja ülesanded
|
| Vahelehed | Vahelehtedena kuvatakse eesmärkide päringuga saadud eesmärgid. Täpsem päringu loogika on kirjeldatud peatükis "Funktsionaalsus. Selgitused" punktis 1.
|
| - |
nt. 'Eesmärk 1 Luua tõhus keskkond' Mittemuudetav. |
| Eesmärgi kohta kuvatavad andmed | |
| - | Vahelehe päises kuvatakse eesmärgi nimetus. nt. 'Luua tõhus keskkond' Mittemuudetav. |
| - | Eesmärgi nimetuse all kuvatakse eesmärgi kirjeldus.
nt. 'Luua tõhus ja harmooniline meeskonnatöö keskkond, kus iga liige tunneb end kaasatuna, inspireerituna ja motiveerituna, tagades seeläbi parema koostöö tulemuste ning ühise eesmärgi saavutamise.' Mittemuudetav. |
Tegevuste kohta kuvatavad andmed | |
| - | Tegevuse pealkiri
nt. 'Koostöö põhimõtete kokkuleppimine osapooltega' Mittemuudetav. |
| Vastutaja | Tegevuse vastutajaks määratud meeskonnaliikme nimi.
nt. 'Jüri Vaarikas' Mittemuudetav. |
| Märkmete ikoon | Kuvatakse ainult juhul kui tegevusele on lisatud märkmeid.
Mittemuudetav. |
| Tegevuste kalendris tegevuste ja tööülesannete kohta kuvatavad andmed | |
| - |
|
| Tegevuse või tööülesande detailandmed | Tegevuse või tööülesande perioodi ribale vajutades avab süsteem eraldi aknas tegevuse või tööülesande detailandmed. |
| - | Tegevuse või tööülesande pealkiri.
nt. 'Töörühma koosolek' Mittemuudetav. |
| Tegevuse kirjeldus / Tööülesande kirjeldus | Tegevuse või tööülesande pikem kirjeldus.
nt. 'Esimese versiooni tutvustav koosolek' Mittemuudetav. |
| Vastutaja | Tegevuse või tööülesande vastutaja nimi.
nt. 'Jüri Vaarikas' Mittemuudetav. |
| Eeldatav kulu | Tegevuse või tööülesannete rahastuse allikate kogusumma.
nt. '1000€' Mittemuudetav. |
| Algus | Tegevuse või tööülesande algus kuupäev.
nt. '15.01.2024' Mittemuudetav. |
| Lõpp | Tegevuse või tööülesande lõpu kuupäev.
nt. '15.05.2024' Mittemuudetav. |
Meeskonnaliikmete kohta kuvatavad andmed | |
| - | Meeskonnaliikme eesnimi, perekonnanimi, profiilivärv ja protsessi juhi märge.
Mittemuudetav. |
| - | Meeskonnaliikme asutuse nimetus ja ametikoht kuvatakse sidekriipsuga eraldatuna.
nt "Pärnu Noorte Vabaajakeskus - Arendusjuht" Mittemuudetav. |
Märkmete kohta kuvatavad andmed | Kuvatakse maksimaalselt kolm viimati lisatud märget, mis on seotud eesmärgi, tegevuse või tööülesandega.
|
| - | Tegevuse või tööülesande pealkiri, mille kohta on märge lisatud. Ei kuvata, kui märge on lisatud eesmärgi kohta üldiselt.
|
| - | Märkme kirjeldus
Kuvatakse maksimaalselt 3 rida. |
| - | Märkme viimase muutmise kellaaeg, kuupäev ja muutja nimi püstkriipsudega eraldatult.
|
| - | Silma ikoon kuvatakse kui märkme nähtavus on "Privaatne (nähtav ainult mulle)".
|
| Tööülesannete kohta kuvatavad andmed | |
| - |
nt. 'Koostööpõhimõtete kokkuleppimine osapooltega' |
| Tehtud | Kuvatakse, mitu tegevuse tööülesannetest on märgitud tehtuks, võrreldes koguarvuga.
nt. '2/5' |
| Linnukese ikoon | Kuvatakse ainult juhul kui tööülesanne on märgitud tehtuks.
|
| - | Tööülesande pealkiri
nt. 'Osapoolte teavitamine' |
| Märkmete ikoon | Kuvatakse ainult juhul kui tööülesandele on lisatud märkmeid.
|
| Ikoon initsiaalidega | Tööülesande vastutaja initsiaalid ja profiilivärv
|
Kasutaja tegevused
| Tegevuse nimetus | Selgitus |
|---|---|
Lehe päises või jaluses vastavale sammule vajutamine | Sammule vajutamisel kuvatakse kasutajale vastav vaade:
|
| Eesmärkide karusellis vahelehe pealkirjale liikumine | Vahelehe pealkirjale liikudes kuvab süsteem kasutajale nooleikoonid, millega kasutajal on võimalik muuta eesmärgi positsiooni järjekorras.
Nooleikoonile vajutamisel:
|
| Eesmärkide karusellis vahelehe pealkirjale vajutamine | Vahelehe pealkirjale vajutamisel:
|
| Eesmärgi lühikirjelduse juures "Muuda" nupu vajutamine | Nupu vajutamisel suunatakse kasutaja eesmärgi lisamise voo 2. sammu: PM: UC: Eesmärkide kirjeldamine (lisamine/muutmine), kus kuvatakse avatuna selle eesmärgi vaheleht, mida kasutaja viimati vaatas voo 3. sammus. |
| Kalendris "Nädal", "Kuu", "Kvartal", "Aasta" vaadetele lülitamine | Kalendrivaate valiku muutmisel laeb süsteem tegevuste ja tööülesannete kalendri vastava vaate. |
| Kalendri päises noole ikoonile vajutamine | Noole ikoonile vajutamisel saab kasutaja liikuda kalendris nädala/kuu/kvartali/aasta kaupa edasi või tagasi. |
| Tegevuste nimekirjas nupu "Lisa" vajutamine | Nupule vajutamisel kuvab süsteem kasutajale modaalakna tegevuse lisamiseks: PM: UC: Eesmärgi tegevuse lisamine/muutmine. |
| Tegevuste nimekirjas reale liikumine | Tegevuse reale liikudes kuvab süsteem kasutajale nooleikoonid, millega kasutajal on võimalik muuta tegevuste järjekorda. Nooleikoonile vajutamisel liigub tegevus ühe koha võrra vastavas suunas (üles või alla). Seejärel käivitab süsteem päringu tegevuse uue järjekorranumbri salvestamiseks: PM: API: Goal: PATCH /planning-api/goals/{goalId}/activities/{goalActivityId}/move. |
| Tegevuste nimekirjas rea tekstile vajutamine | Rea tekstile vajutamisel kuvab süsteem kasutajale modaalakna tegevuse andmetega: PM: UC: Eesmärgi tegevuse vaatamine. |
| Tegevuste nimekirjas kolme punktiga ikooni vajutamine | Kolme punktiga ikoonile vajutamisel kuvab süsteem kasutajale võimalike tegevuste menüü valikutega "Muuda" ja "Lisa märkmed". |
"Muuda" vajutamisel kuvab süsteem kasutajale modaalakna tegevuse andmete muutmiseks: PM: UC: Eesmärgi tegevuse lisamine/muutmine. | |
"Lisa märkmed" vajutamisel kuvab süsteem kasutajale modaalakna märkme lisamiseks: PM: UC: Eesmärgi, tegevuse või tööülesande märkme lisamine/muutmine. | |
| Tegevuste kalendris tegevuse või tööülesande perioodi ribale vajutamine | Tegevuse või tööülesande perioodi ribale vajutades avab süsteem eraldi aknas tegevuse või tööülesande detailandmed. Iga uue tegevuse / tööülesande detailanandmete akna avamisel suletakse eelmisena avatud aken automaatselt. |
| Nupu "Lisa liige" vajutamine | Nupp kuvatakse ainult juhul, kui kasutajal on täidetud peatükis "Funktsionaalsus. Selgitused" kirjeldatud tingimused. Nupule vajutamisel avaneb meeskonnaliikme lisamise modaalaken: PM: UC: Meeskonnaliikme vaatamine/lisamine/muutmine. |
| Meeskonnaliikmete nimekirjas reale vajutamine | Meeskonnaliikme reale vajutamisel avaneb modaalaken kõigi eesmärgi meeskonnaliikmete andmetega. Vaikimisi on avatuna kuvatud valitud meeskonnaliikme akordion: PM: UC: Meeskonnaliikme vaatamine/lisamine/muutmine. See, kas meeskonnaliikmete andmed kuvatakse muudetavatena või ainult vaatamiseks, sõltub kasutaja õigustest, mis on kirjeldatud peatükis "Funktsionaalsus. Selgitused". |
| Meeskonnaliikmete nimekirjas prügikasti ikoonile vajutamine | Prügikasti ikoonid kuvatakse meeskonnaliikmete juures ainult juhul, kui kasutajal on täidetud peatükis "Funktsionaalsus. Selgitused" kirjeldatud tingimused. Nupule vajutamisel:
Selgitus: Meeskonnaliikme kustutamisel kantakse tema tegevused ja tööülesanded üle meeskonnaliikmele, kes teostas kustutamise. |
| Nupu "Lisa eesmärgile märkmed" vajutamine | Nupule vajutamisel kuvab süsteem kasutajale modaalakna märkme lisamiseks: PM: UC: Eesmärgi, tegevuse või tööülesande märkme lisamine/muutmine. |
| Nupu "Kõik märkmed" vajutamine | Nupp on aktiivne ainult juhul, kui eesmärgil, selle tegevusel või tööülesandel, on vähemalt üks märge olemas.
Kui märkmeid ei ole, kuvatakse nuppu mitteaktiivsena. Nupule vajutamisel avaneb modaalaken kõigi eesmärgi märkmetega: PM: UC: Eesmärgi märkmete vaatamine. |
| Märkmete nimekirja kolme punktiga ikooni vajutamine | Kasutaja saab avada tegevuste menüüd ainult juhul, kui on täidetud tingimused, mis on kirjeldatud peatükis "Funktsionaalsus. Selgitused". Kolme punktiga ikoonile vajutamisel kuvab süsteem kasutajale võimalike tegevuste menüü valikutega "Muuda" ja "Kustuta". |
"Muuda" vajutamisel kuvab süsteem kasutajale modaalakna märkme andmete muutmiseks: PM: UC: Eesmärgi, tegevuse või tööülesande märkme lisamine/muutmine. | |
Kui kasutaja valib valiku „Kustuta”:
| |
| Nupu "Lisa ülesanne" vajutamine | Nupule vajutamisel kuvab süsteem kasutajale modaalakna tööülesande lisamiseks: PM: UC: Eesmärgi tööülesande lisamine/muutmine. |
| Tööülesannete plokis tegevuse akordioni avamine | Kuvatakse valitud tegevuse alla kuuluvate tööülesannete nimekiri, mille tagastas päring PM: API: Goal: GET /planning-api/goals/{goalId}/tasks vaate avamisel / värskendamisel. |
| Tööülesannete plokis tegevuse akordioni sulgemine | Kasutajal on võimalik avatud akordion sulgeda, et peita tegevusega seotud tööülesannete andmed. |
| Tööülesande linnutamine/linnukese eemaldamine | Märkeruudu linnutamisel ja linnukese eemaldamisel käivitab süsteem päringu tegevusele lõpetatud märke lisamiseks või selle eemaldamiseks: PM: API: Goal: PATCH /planning-api/goals/{goalId}/activities/{goalActivityId}/tasks/{activityTaskId}/done. |
| Tööülesannete nimekirjas rea tekstile vajutamine | Rea tekstile vajutamisel kuvab süsteeem kasutajale modaalakna tööülesande andmetega: PM: UC: Eesmärgi tööülesande vaatamine. |
| Tööülesannete nimekirjas kolme punktiga ikooni vajutamine | Kolme punktiga ikoonile vajutamisel kuvab süsteem kasutajale võimalike tegevuste menüü valikutega "Muuda" ja "Lisa märkmed". Kasutaja saab avada tegevuste menüü ainult juhul, kui tööülesanne ei ole märgitud lõpetatuks.
|
"Muuda" vajutamisel kuvab süsteem kasutajale modaalakna tööülesande andmete muutmiseks: PM: UC: Eesmärgi tööülesande lisamine/muutmine. | |
"Lisa märkmed" vajutamisel kuvab süsteem kasutajale modaalakna märkme lisamiseks: PM: UC: Eesmärgi, tegevuse või tööülesande märkme lisamine/muutmine. | |
| Nupu "Tagasi töölauale" vajutamine | Nupule vajutamisel suunab süsteem kasutaja tagasi töölauale. |
| Nupu "Arhiveeri" vajutamine | "Arhiveeri" nupp kuvatakse ainult juhul, kui kasutajal on täidetud peatükis "Funktsionaalsus. Selgitused" kirjeldatud tingimused. Nupule vajutamisel:
Selgitus:
|
| Lingile "Viimati vaadatud" vajutamine | Lingile vajutamisel avaneb modaalaken viimati lehte vaadanud kasutajate nimekirjaga: PM: UC: Viimaste vaatamiste nimekirja kuvamine. |








