Üldkirjeldus

Teenus võimaldab pärida eesmärgi või tegevuse tööülesannete nimekirja, kasutades eesmärgi ID-d ning vajadusel ka tegevuse ID-d.

Seotud andmeobjektid:

Seotud Jira taskid

NSIL-854 - Getting issue details... STATUS

Eeltingimused ja kasutusõigused

Kui tegemist on asutusepõhise eesmärgiga (Goal.goalScope = INSTITUTIONAL):
- 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.
Kui tegemist on isikupõhise eesmärgiga (Goal.goalScope = INDIVIDUAL):
- Kasutaja on eesmärgi omanik.
  - Goal.personalCode = Päringu käivitanud kasutaja isikukood.
  - Eraldi privileegi ei ole vaja.
Või 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.

Sisendid

Atribuut	Kohustuslikkus, mitmesus	Tüüp	Vaikeväärtus, valideerimine	Kirjeldus, täiendav info
goalId	1	String	Eesmärk peab eksisteerima. Goal.id = goalId	Eesmärgi unikaalne identifikaator, mille tööülesandeid otsitakse.
goalActivityId	0..1	String	Tegevus peab eksisteerima ja olema seotud eesmärgiga. GoalActivity.id = goalActivityId GoalActivity.goalId = goalId	Viide eesmärgi tegevusele, mille tööülesandeid otsitakse.

Väljundid

Atribuut

Kohustuslikkus, mitmesus

Tüüp

Kirjeldus, täiendav info

goalActivityTasks

0..*

Array

Eesmärgi tegevuste tööülesanded.

Array objekte vaata PM: API: Goal: POST /planning-api/goals/{goalId}/activities/{goalActivityId}/tasks#Väljundid

Tegevused

Süsteem kontrollib, kas kasutajal on õigus päringut teostada.
1. Kui õigust pole, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
Süsteem kontrollib, kas sisendandmed vastavad nõuetele.
1. Kui andmed ei vasta nõuetele, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
Süsteem kontrollib, kas sisendis esitatud eesmärk (goalId) eksisteerib ja kas päringu käivitanud kasutajal on õigus selle andmeid pärida.
1. Kontroll toimub vastavalt üldreeglites kirjeldatud loogikale.
2. Kui eesmärki ei leita või see ei vasta üldreeglitele, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
Süsteem otsib sisendis esitatud eesmärgi või tegevuse tööülesandeid:
1. Kui "goalActivityId" parameeter pole sisendis määratud, otsitakse kõiki eesmärgi tööülesandeid:
  1. Süsteem otsib Objektid#GoalActivityTask objekte, mille:
    1. goalId = Sisendis esitatud "goalId" väärtus.
  2. Kui ühtegi tööülesannet ei leita, tagastatakse tühi vastus.
2. Kui "goalActivityId" parameeter on sisendis määratud, otsitakse selle tegevuse tööülesandeid:
  1. Süsteem kontrollib, kas tegevus eksisteerib ja kas see on seotud eesmärgiga:
    1. Süsteem otsib Objektid#GoalActivity objekti, mille:
      1. id = Sisendis esitatud "goalActivityId" väärtus.
      2. goalId = Sisendis esitatud "goalId" väärtus.
      3. Kui tegevust ei leita, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  2. Süsteem otsib tegevuse tööülesandeid:
    1. Süsteem otsib Objektid#GoalActivityTask objekte, mille:
      1. goalActivityId = Sisendis esitatud "goalActivityId" väärtus.
      2. goalId = Sisendis esitatud "goalId" väärtus.
    2. Kui ühtegi tööülesannet ei leita, tagastatakse tühi vastus.
Iga leitud tööülesande puhul otsib süsteem vastutava isiku nime:
1. Süsteem otsib Objektid#GoalTeamMember objekti, mille:
  1. id = üks leitud tööülesannete meeskonnaliikmetest (Objektid#GoalActivityTask.goalTeamMemberId)
2. Kui mõnda tööülesande meeskonnaliiget ei leita, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
Süsteem tagastab kõigi leitud tööülesannete andmeid koos vastutavate isikute nimedega.