NSILM

PM: API: Team: GET /planning-api/goal-team-members/{teamMemberId}/goals

Muutja: Natalja Selivjorstova · 2025-05-29

Üldkirjeldus

Teenus võimaldab pärida meeskonnaliikme eesmärkide nimekirja, kasutades tema ID-d. Tagastatakse ainult need eesmärgid, mis ei ole arhiveeritud. 

Iga unikaalse isikukoodi puhul on ühe asutuse/ametikoha piires ainult üks meeskonnaliikme kirje.

Seotud andmeobjektid:

Seotud Jira taskid

NSIL-801 - Getting issue details... STATUS

NSIL-923 - Getting issue details... STATUS

Eeltingimused ja kasutusõigused

  • Kasutajal on seos meeskonnaliikme eesmärkide asutusega ja selle asutuse eesmärkide vaatamise õigus. 
    • Goal.institution.id = Kasutaja poolt valitud rolliga seotud asutus
    • Õigust reguleerib privileeg: HSILM_PLANNING_GOAL_VIEW.
  • Või kasutaja on meeskonnaliikme eesmärkide omanik.
    • Goal.personalCode = Päringu käivitanud kasutaja isikukood.
    • Sellisel juhul ei ole eraldi privileegi vaja.
  • Või kasutaja on meeskonnaliikme eesmärkide meeskonnas ja planeerimise meeskonna liikme rollil on eesmärkide vaatamise õigus.
    • Goal.teamMembers.id = GoalTeamMember.id, mille personalCode = Päringu käivitanud kasutaja isikukood
    • Õigust reguleerib privileeg: HSILM_PLANNING_GOAL_VIEW.

Sisendid

AtribuutKohustuslikkus, mitmesusTüüpVaikeväärtus, valideerimineKirjeldus, täiendav info

goalTeamMemberId

1

String
  • Peab eksisteerima.
Viide meeskonnaliikmele, kelle eesmärke otsitakse.

goalTeamMemberAccess

1

Boolean
  • True - Andmeid pärib planeerimise meeskonnaliikme rollis kasutaja.
  • False - Andmeid pärib asutuse või ametikoha rollis kasutaja, st kasutajal on EHIS-es seos tagastatavate eesmärkide asutuse või ametikohaga.
Märge, kas andmeid pärib planeerimise meeskonnaliikme rollis kasutaja.

Väljundid

Atribuut

Kohustuslikkus, mitmesus

TüüpKirjeldus, täiendav info

goalTeamMemberId

1

StringMeeskonnaliikme unikaalne identifikaator.

goals

1..*

Array

Meeskonnaliikme eesmärkide nimekiri.

goals.id

1

UUIDObjekti unikaalne identifikaator.
goals.name0..1String

Eesmärgi nimetus.

goals.description0..1String

Eesmärgi kirjeldus.

Tegevused

  1. Süsteem kontrollib, kas kasutajal on õigust päringut teostada.
    1. Kui õigust ei ole, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  2. 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.
  3. Süsteem kontrollib, kas sisendis esitatud meeskonnaliige eksisteerib.
    1. Süsteem otsib Objektid#GoalTeamMember objekti, mille:
      1. id =  Sisendis esitatud "goalTeamMemberId" väärtus.
    2. Kui meeskonnaliiget ei leita, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  4. Süsteem otsib meeskonnaliikmega seotud aktiivseid eesmärke. 
    1. Süsteem otsib Objektid#Goal objekte, mille:
      • teamMembers hulgas on sisendis esitatud "goalTeamMemberId" väärtus.
      • archived = false
      • Kui goalTeamMemberAccess = true, siis teamMembers hulgas on Objektid#GoalTeamMember.id, mille personalCode = kasutaja isikukood. 
    2. Kui ühtegi tingimustele vastavat eesmärki ei leita, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  5. Süsteem tagastab meeskonnaliikme eesmärkide nimekirja.