NSILM

PM: API: Goal: DELETE /planning-api/goals/{goalId}/assessment-challenges/{assessmentChallengeId}

Muutja: Natalja Selivjorstova · 2025-06-10

Üldkirjeldus

Teenus võimaldab kustutada eesmärgilt väljakutse.

Seotud andmeobjektid:

Seotud Jira task

NSIL-906 - Getting issue details... STATUS

NSIL-974 - Getting issue details... STATUS

NSIL-1169 - Getting issue details... STATUS

Eeltingimused ja kasutusõigused

  • Kui tegemist on asutusepõhise eesmärgiga (Goal.goalScope = INSTITUTIONAL):
    • Kasutajal on seos väljakutse ja eesmärgi asutusega ja sama asutuse eesmärkide lisamise ja muutmise õigus. 
      • Goal.institution.id = Kasutaja poolt valitud rolliga seotud asutus
      • AssessmentChallenge.assessment.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 väljakutse ja eesmärgi omanik ja tal on seos väljakutse ja 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
      • AssessmentChallenge.personalCode = Kasutaja isikukood
      • AssessmentChallenge.assessment.institution.id = Kasutaja poolt valitud rolliga seotud asutus
      • AssessmentChallenge.assessment.jobsite = Kasutaja poolt valitud rolliga seotud ametikoht
      • Eraldi privileegi ei ole vaja.
  • 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 = 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

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

assessmentChallengeId

1

String
  • Väljakutse peab olema seotud eesmärgiga.
    • assessmentChallengeId peab esinema Goal.assessmentChallengeIds nimekirjas.
Väljakutse unikaalne identifikaator.

goalId

1

String
  • Eesmärk peab eksisteerima ja ei tohi olla arhiveeritud.
    • Goal.id = goalId
    • Goal.archived = false
Eesmärgi identifikaator, millelt väljakutse eemaldatakse.

Väljundid

AtribuutKohustuslikkus, mitmesusTüüpKirjeldus, täiendav info

Samad mis teenusel PM: API: Goal: POST /planning-api/goals#V%C3%A4ljundid.

Tegevused

  1. Süsteem kontrollib, kas kasutajal on õigust päringut teostada.
    1. Kui õigust pole, 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 selle andmeid hallata.
    1. Kontroll viiakse läbi 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 väljakutse on seotud eesmärgiga:
    1. Süsteem otsib Objektid#Goal objekti, mille:
      1. id = sisendis esitatud "goalId" väärtus
    2. Süsteem kontrollib, kas sisendis esitatud "assessmentChallengeId" on leitud eesmärgi "assessmentChallengeIds" nimekirjas. 
    3. Kui väljakutset pole eesmärgi väljakutsete nimekirjas, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  5. Süsteem eemaldab eesmärgilt väljakutse:
    • Süsteem uuendab Objektid#Goal objekti andmeid:
      • aiDescription = null
      • assessmentChallengeIds = Eemaldatakse "assessmentChallengeId" väärtus.
      • audit = audit (muutmine)
  6. Süsteem tagastab muudetud andmed.