PM: UC: Arhiveeritud eesmärkide vaatamine

Sisukord

Üldkirjeldus

Kasutajal on võimalik otsida arhiveeritud eesmärke, liikuda erinevate eesmärkide vahelehtedele ja vaadata iga eesmärgi koondvaadet.

Arhiveeritud eesmärkide vaatesse pääseb töölaualt kasutaja juhul, kui tema õigused vastavad peatükis „Eeltingimused“ toodud nõuetele.

Seotud Jira taskid

NSIL-1182 - Getting issue details... STATUS

Kasutajaliides

Jäljerida

Avaleht → Töölaud → Arhiiv

Disainid

Eeltingimused

Kasutaja on sisse loginud ja valinud rolliks:

1. Asutus:
   1. Eesmärgid on asutusepõhised ning seotud kasutaja asutusega. Kasutajal on sama asutuse eesmärkide vaatamise õigus.
      1. Goal.goalScope = INSTITUTIONAL
      2. Goal.institution.id = Kasutaja valitud rolliga seotud asutus
      3. Õigust reguleerib privileeg: HSILM_PLANNING_GOAL_VIEW.
2. Ametikoht / Arhiiv:
   1. Eesmärgid on isikupõhised ning seotud kasutaja isikukoodiga.
      1. Goal.goalScope = INDIVIDUAL
      2. Goal.personalCode = Kasutaja isikukood
   2. Eraldi privileegi ei ole vaja.
3. Planeerimise meeskonna liige:
   1. Kasutaja on eesmärkide meeskonnas ja planeerimise meeskonna liikme rollil on eesmärkide vaatamise õigus.
      1. Goal.goalScope = INSTITUTIONAL või INDIVIDUAL
      2. Goal.teamMembers.id = GoalTeamMember.id, mille personalCode = kasutaja isikukood

Funktsionaalsus

Selgitused

1. Kasutajaliides teeb rollis / töölaual tehtud valiku alusel päringu eesmärkide kuvamiseks.   
   1. Kui kasutaja rolliks on asutus, käivitatakse päring: PM: API: Goal: GET /planning-api/goals.
      1.  Päringu sisend on:
         1. goalScope = "INSTITUTIONAL"
         2. institutionId = Kasutaja poolt valitud rolliga seotud asutuse ID
         3. statuses = "ARCHIVED"
         4. startDate = jooksvast kuupäevast 3 aasta minevikus
         5. endDate = jooksev kuupäev
   2. Kui kasutaja rolliks on ametikoht / arhiiv: PM: API: Goal: GET /planning-api/goals.  
      1. Päringu sisend on:
         1. goalScope = "INDIVIDUAL"
         2. institutionId = Kasutaja valitud rolliga seotud / arhiivi töölaual valitud asutuse ID
         3. jobsite = Kasutaja valitud rolliga seotud / arhiivi töölaual valitud ametikoht
         4. statuses = "ARCHIVED"
         5. startDate = jooksvast kuupäevast 3 aasta minevikus
         6. endDate = jooksev kuupäev
   3. Kui kasutaja rolliks on planeerimise meeskonna liige: PM: API: Goal: GET /planning-api/team-member-goals.
      1. Päringu sisend:
         1. goalScope = Kui kasutaja on valinud Planeerimise meeskonna liikme töölaual asutuse, siis "INSTITUTIONAL"; kui ta on valinud teise isiku ametikoha, siis "INDIVIDUAL".
         2. institutionId = Planeerimise meeskonna liikme töölaual valitud asutuse ID
         3. personalCode = Planeerimise meeskonna liikme töölaual valitud isiku isikukood
         4. jobsite = Planeerimise meeskonna liikme töölaual valitud ametikoht
         5. statuses = "ARCHIVED"
         6. startDate = jooksvast kuupäevast 3 aasta minevikus
         7. endDate = jooksev kuupäev
   4. Selgitus: Päring tagastab eesmärgid, mille periood (varaseima tegevuse algus kuni hiliseima tegevuse lõpp) kattub vähemalt osaliselt otsitava perioodiga.
2. Kasutajaliides kuvab Arhiivi vaadet.  
   1. Eesmärkide otsingu filtrites on perioodiks vaikimisi valitud viimased 3 aastat.
   2. Otsingutulemuste akordion on vaikimisi avatud ning selles on kuvatud päringuga saadud eesmärgid.
   3. Otsingu tulemusena leitud eesmärgid kuvatakse ka vahelehe pealkirjadena eesmärkide karusellis.
      1. Kui eesmärgid puuduvad kuvatakse otsingu tulemuste akondionis tühi teade. Eesmärkide karuselli ega vahelehte ei kuvata. 
3. Eesmärkide lisamise ja muutmise õigusega kasutajale kuvatakse eesmärkide vahelehtedel:
   1. "Arhiveeritud" staatuses eesmärgi puhul vaade PM: UC: Eesmärkide vaatamine,
   2. "Pooleliolev" ja "Aktiivne" staatuses eesmärkide puhul vaade PM: UC: Eesmärkide tegevuste ja ülesannete kirjeldamine (lisamine/muutmine).
4. Eesmärkide vaatamise õigusega kasutajale kuvatakse eesmärkide vahelehtedel alati vaade PM: UC: Eesmärkide vaatamine.
5. Kasutajal saab eesmärke filtreerida järgmiste parameetrite alusel:
   1. Periood:
      1. Perioodi algus - otsitakse eesmärgi perioodi vähemalt osalist sisaldumist otsingu perioodis, st eesmärgi perioodi lõpp (hiliseim tegevuse lõpp) ei tohi olla varasem otsingu perioodi algusest.
      2. Perioodi lõpp - otsitakse eesmärgi perioodi vähemalt osalist sisaldumist otsingu perioodis, st eesmärgi perioodi algus (varaseim tegevuse algus) ei tohi olla hilisem otsingu perioodi lõpust.
   2. Seisund:
      1. Arhiveeritud eesmärgid - otsitakse ainult eesmärke staatuses "Arhiveeritud", st:
         1. PM: API: Goal: GET /planning-api/goals.response.goals, mille statusType = "ARCHIVED"
      2. Aktiivsed eesmärgid - otsitakse ainult eesmärke staatuses "Aktiivne", st:
         1. PM: API: Goal: GET /planning-api/goals.response.goals, mille statusType = "ACTIVE"
      3. Pooleliolevad eesmärgid - otsitakse ainult eesmärke staatuses "Pooleliolev", st:
         1. PM: API: Goal: GET /planning-api/goals.response.goals, mille statusType = "INCOMPLETE"
      4. Kõik - otsitakse kõikides staatustes eesmärgid.
      5. Korraga saab valida ainult ühe valiku.
   3. Kui kasutaja muudab väärtust mistahes ülaltoodud väljadest, käivitatakse uuesti üks punktis 1 kirjeldatud päringutest vastavalt kasutaja valitud rollile. 
      1.  Alltoodud parameetrid täidetakse päringus järgmiselt: 
         1. statuses = "Seisund" rippmenüüst valitud väärtus
         2. startDate = väljas "Perioodi algus" valitud väärtus
         3. endDate = väljas "Perioodi lõpp" valitud väärtus
6. Eesmärkide staatuste täpsem kirjeldus on kättesaadav lehel Klassifikaatorid#KlassifikaatorHSILM_GOAL_STATUS.
7. Leitud eesmärkide kuvamine otsingu tulemustes ja eesmärkide karusellis:
   1. Päringuga saadud eesmärgid järjestatakse järgmise loogika järgi:
      1. Eesmärgid järjestatakse alguskuupäeva järgi kasvavas järjekorras.
      2. Sama alguskuupäeva eesmärgid järjestatakse lõpukuupäeva järgi kasvavalt.
      3. Kui ka lõpukuupäev on sama, järjestatakse eesmärgid loomise aja järgi kasvavalt. 
      4. Eesmärgid, millistel puudub periood (st puudub algus- ja lõpukuupäev), lisatakse nimekirja lõppu ning järjestatakse omavahel loomise aja järgi kasvavalt.
   2. Järjestatud eesmärgid nummerdatakse, alustades numbrist 1. 
      1. Eesmärgile määratud järjekorranumber kuvatakse eesmärgi vahelehe pealkirjas. 
   3. Tulemuste kuvamine sõltuvalt otsingu tulemustest: 
      1. Kui filtrites määratud tingimustele ei vasta ükski eesmärk, kuvatakse otsingu tulemuste akordionis eesmärkide nimekirja asemel tühi teade. Eesmärkide karuselli ega vahelehte ei kuvata. 
      2. Kui leitakse ainult üks eesmärk, kuvatakse otsingu tulemuste all selle eesmärgi detailvaade. Eesmärkide karuselli ega vahelehte ei kuvata. 

Andmed

Kasutaja tegevused

Leitud eesmärkide vahelehtedel võimalikud kasutaja tegevused sõltuvad tema õigustest ja eesmärgi staatusest ning vastavad loogikale, mida kasutatakse vaadetes PM: UC: Eesmärkide vaatamine ja PM: UC: Eesmärkide tegevuste ja ülesannete kirjeldamine (lisamine/muutmine).