NSILM

PM: API: DevelopmentPlan: PUT /planning-api/development-plans/{developmentPlanId}

Muutja: Natalja Selivjorstova · 2025-08-06

Üldkirjeldus

Teenus võimaldab salvestada arengukava andmed.

Seotud andmeobjektid:

Seotud Jira taskid

NSIL-992 - Getting issue details... STATUS

Eeltingimused ja kasutusõigused

  • Kui tegemist on asutusepõhise arengukavaga (DevelopmentPlan.developmentPlanScope = INSTITUTIONAL):
    • Kasutajal peab olema seos arengukava asutusega ning sama asutuse arengukava lisamise ja muutmise õigus. 
      • DevelopmentPlan.institution.id = Kasutaja poolt valitud rolliga seotud asutus
      • Õigust reguleerib privileeg: HSILM_PLANNING_DEV_PLAN_MANAGE.
  • Kui tegemist on isikupõhise arengukavaga (DevelopmentPlan.developmentPlanScope = INDIVIDUAL):
    • Kasutaja peab olema arengukava omanik ja tal peab olema seos nii arengukava asutuse kui ka ametikohaga.
      • DevelopmentPlan.personalCode = Kasutaja isikukood
      • DevelopmentPlan.institution.id = Kasutaja poolt valitud rolliga seotud asutus
      • DevelopmentPlan.jobsite = Kasutaja poolt valitud rolliga seotud ametikoht
    • Eraldi privileegi ei ole vaja.
  • Arhiivi ja meeskonnaliikme rolli valinud kasutaja ei saa muuta arengukava.

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

developmentPlanId

1

String
  • Peab eksisteerima ja olema muudetav.
    • developmentPlanId = DevelopmentPlan.id, mille editable = true
Arengukava unikaalne identifikaator.

title

1

String
  • Peab olema 3-250 tähemärki.
Arengukava pealkiri.

startDate

0..1

Date
  • Saab olla NULL. 
  • Ei saa olla hilisem lõpukuupäevast.
Arengukava perioodi alguskuupäev.

endDate

0..1

Date
  • Saab olla NULL. 
  • Ei saa olla varasem alguskuupäevast.
Arengukava perioodi lõpukuupäev.

Väljundid

AtribuutKohustuslikkus, mitmesusTüüpKirjeldus, täiendav info
Samad nagu teenusel PM: API: DevelopmentPlan: POST /planning-api/development-plans.

Tegevused

  1. Süsteem kontrollib, kas kasutajal on õigust päringut teostada.
    1. Kui kasutajal puudub õigus, 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 arengukava (developmentPlanId) eksisteerib ja on muudetav:

    1. Süsteem otsib Objektid#DevelopmentPlan objekti, mille:
      1. id =  sisendis esitatud developmentPlanId väärtus
      2. editable = true
    2. Kui vastavat arengukava ei leita, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  4. Süsteem uuendab arengukava andmed.
    1. Süsteem muudab leitud Objektid#DevelopmentPlan objekti järgmiselt:
      1. title = sisendis esitatud title väärtus
      2. startDate = sisendis esitatud startDate väärtus (kui on määratud)
      3. endDate = sisendis esitatud endDate väärtus (kui on määratud)
  5. Süsteem tagastab muudetud arengukava andmed.