PM: API: Goal: PUT /planning-api/goals/{goalId}
Üldkirjeldus
Teenus võimaldab muuta eesmärgi andmeid. Kui eesmärgi kirjeldust muudetakse, eemaldatakse eelmisele kirjeldusele genereeritud ChatGPT hinnang.
Seotud andmeobjektid:
Seotud Jira taskid
NSIL-789 - Getting issue details... STATUS
NSIL-911 - 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 lisamise ja muutmise õigus.
- Goal.institution.id = Kasutaja poolt valitud rolliga seotud asutus
- Õigust reguleerib privileeg: HSILM_PLANNING_GOAL_MANAGE.
- Kasutajal on seos eesmärgi asutusega ja sama asutuse eesmärkide lisamise ja muutmise õigus.
- 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 = Päringu käivitanud 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ärgi omanik ja tal on seos eesmärgi asutuse ja ametikohaga.
- Või kasutaja on eesmärgi 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 = Päringu käivitanud kasutaja isikukood
- Õigust reguleerib privileeg: HSILM_PLANNING_GOAL_MANAGE.
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ärgi identifikaator, mille andmeid muudetakse. |
name | 0..1 | String |
| Eesmärgi nimetus. |
description | 0..1 | String |
| Eesmärgi kirjeldus. |
Väljundid
| Atribuut | Kohustuslikkus, mitmesus | Tüüp | Kirjeldus, täiendav info |
|---|---|---|---|
Samad mis teenusel PM: API: Goal: POST /planning-api/goals#V%C3%A4ljundid | |||
Tegevused
- Süsteem kontrollib, kas kasutajal on õigust päringut teostada.
- Kui kasutajal ei ole õigust, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
- Süsteem kontrollib, kas sisendandmed vastavad nõuetele.
- 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 hallata selle andmeid.
- Kontroll teostatakse vastavalt üldreeglites kirjeldatud loogikale.
- Kui eesmärki ei leita või see ei vasta üldreeglitele, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
- Süsteem uuendab leitud eesmärgi andmeid.
- Süsteem uuendab leitud Objektid#Goal objekti andmeid:
- name = Sisendis esitatud "name" väärtus.
- description = Sisendis esitatud "description" väärtus.
- audit = audit (muutmine)
- Süsteem kontrollib, kas eesmärgi kirjeldus on muutunud võrreldes viimati salvestatud väärtusega.
Kui description != Sisendis esitatud "description" väärtusega, määratakse "aiSmartScoreRaiting" väärtuseks NULL.
- Süsteem uuendab leitud Objektid#Goal objekti andmeid:
- Süsteem tagastab muudetud andmed.