NSILM

PM: API: Goal: DELETE /planning-api/goals/{goalId}/metrics/{goalMetricsId}

Muutja: Natalja Selivjorstova · 2025-06-10

Üldkirjeldus

Teenus võimaldab kustutada eesmärgilt mõõdiku koos sellega seotud näitajate ja sihttasemetega.

Seotud andmeobjektid:

Seotud Jira taskid

NSIL-787 - Getting issue details... STATUS

NSIL-914 - Getting issue details... STATUS

NSIL-974 - 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.
  • 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 = Kasutaja isikukood
      • Goal.institution.id = Kasutaja poolt valitud rolliga seotud asutus
      • Goal.jobsite = Kasutaja poolt valitud rolliga seotud ametikoht
    • Eraldi privileegi ei ole vaja.
  • Eesmärgi meeskonnaliikmel ei ole õigust mõõdikuid kustutada.

Planeerimise mooduli kasutusrollide ja õiguste kohta saab täpsemalt infot leida lehelt Kasutusõigused ja rollid.

Sisendid

Atribuut

Kohustuslikkus, mitmesus

TüüpVaikeväärtus, valideerimineKirjeldus, täiendav info

goalMetricsId

1

String
  • Peab eksisteerima ja olema seotud eesmärgiga. 
    • GoalMetrics.id = goalMetricsId
    • GoalMetrics.goalId = goalId
Eemaldatava mõõdiku unikaalne identifikaator.

goalId

1

String
  • Eesmärk peab eksisteerima ja ei tohi olla arhiveeritud.
    • Goal.id = goalId
    • Goal.arhived = false
Viide eesmärgile, mille mõõdik eemaldatakse.

Väljundid

Atribuut

Kohustuslikkus, mitmesus

TüüpKirjeldus, täiendav info

Samad mis teenusel PM: API: Goal: POST /planning-api/goals/{goalId}/metrics.

Tegevused

  1. Süsteem kontrollib, kas kasutajal on õigust päringut teostada.
    1. Kui kasutajal ei ole õigust, 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 eesmärk (goalId) eksisteerib ja kas päringu käivitanud kasutajal on õigus hallata selle andmeid.
    1. Kontroll teostatakse 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.
  4. Süsteem kontrollib, kas sisendis esitatud mõõdik eksisteerib ja kas see on seotud eesmärgiga:
    1. Süsteem otsib Objektid#GoalMetrics objekti järgmiste tingimuste alusel:
      1. id =  Sisendis esitatud "goalMetricsId" väärtus
      2. goalId = Sisendis esitatud "goalId" väärtus
    2. Kui mõõdikut ei leita, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  5. Süsteem eemaldab mõõdiku:
    1. Süsteem kustutab leitud Objektid#GoalMetrics objekti andmebaasist jäädavalt.
  6. Süsteem tagastab kustutatud mõõdiku andmed.