NSILM

PM: API: DevelopmentPlan: GET /planning-api/development-plans

Muutja: Natalja Selivjorstova · 2025-08-06

Üldkirjeldus

Teenus võimaldab pärida asutuse või ametikoha muudetavat arengukava.

Seotud andmeobjektid:

Seotud Jira taskid

NSIL-990 - 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 vaatamise õigus. 
      • DevelopmentPlan.institution.id = Kasutaja poolt valitud rolliga seotud asutus
      • Õigust reguleerib privileeg: HSILM_PLANNING_DEV_PLAN_VIEW.
  • Kui tegemist on isikupõhise arengukavaga (developmentPlan.developmentPlanScope = INDIVIDUAL):
    • Kasutaja peab olema arengukava omanik.
      • DevelopmentPlan.personalCode = Päringu käivitanud kasutaja isikukood.
    • Eraldi privileegi ei ole vaja.
  • Meeskonnaliikme rolli valinud kasutajal ei ole antud funktsionaalsusele ligipääsu.

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

developmentPlanScope

1

String
  • Võimalikud väärtused:
    • INSTITUTIONAL
    • INDIVIDUAL

Määrab arengukava ulatuse:

  • INSTITUTIONAL — asutusepõhine arengukava
  • INDIVIDUAL — isikupõhine arengukava

institutionId 

1

String
  • Peab vastama kasutaja rollis valitud asutuse ID-le.
Viide asutusele, mille arengukava päritakse.

jobsite

0..1

String
  • Peab vastama kasutaja rollis valitud ametikoha ID-le.
  • Väärtus peab kuuluma EHIS klassifikaatorisse PEDAGOOG_AMETIKOHT.
  • Kohustuslik, kui developmentPlanScope = "INDIVIDUAL".
  • Ei tohi olla määratud, kui developmentPlanScope = "INSTITUTIONAL".
Viide kasutaja ametikohale, mille arengukava päritakse. 

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 õ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 otsib arengukava vastavalt sisendis esitatud andmetele:
    1. Otsitakse Objektid#DevelopmentPlan objekti, mille:
      1. developmentPlanScope = sisendis esitatud developmentPlanScope väärtus
      2. institution.id = sisendis esitatud institutionId väärtus
      3. editable = true
      4. Kui developmentPlanScope = "INDIVIDUAL", siis:
        1. personalCode = päringu käivitanud kasutaja isikukood
        2. jobsite = sisendis esitatud jobsite väärtus
    2. Kui arengukava ei leita, tagastatakse tühi vastus.
  4. Süsteem otsib arengukava sektsioone:
    1. Otsitakse Objektid#DevelopmentPlanSection objekte, mille:
      1. developmentPlanId = leitud Objektid#DevelopmentPlan.id väärtus.
  5. Süsteem tagastab leitud arengukava andmed.