Üldkirjeldus

Teenus võimaldab luua asutusele või ametikohale muudetava arengukava, kui seda ei ole veel olemas.

Seotud andmeobjektid:

Seotud Jira taskid

NSIL-1059 - 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 ning 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.
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

Atribuut	Kohustuslikkus, mitmesus	Tüüp	Vaikeväärtus, valideerimine	Kirjeldus, 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 kohta arengukava luuakse.
institutionName	1	String	Peab vastama kasutaja rollis valitud asutuse nimetusele.	Asutuse nimetus.
institutionType	1	String	Peab vastama kasutaja rollis valitud asutuse liigile.	Asutuste liik. (KOV, õppeasutus)
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 kohta arengukava luuakse.

Väljundid

Atribuut	Kohustuslikkus, mitmesus	Tüüp	Kirjeldus, täiendav info
id	1	String	Arengukava unikaalne identifikaator.
developmentPlanScope	1	String	Määrab arengukava ulatuse: INSTITUTIONAL - arengukava on koostatud asutusele tervikuna. INDIVIDUAL - arengukava on koostatud isikule seoses konkreetse ametikohaga.
institution	1	Object	Arengukavaga seotud asutuse andmed.
institution.id	1	String	Viide asutusele, millega arengukavaga on seotud.
insititution.name	1	String	Asutuse nimetus
institution.type	1	EHIS Classifier	Asutuste liik. (KOV, õppeasutus)
jobsite	0..1	String	Ametikoha tunnus, millega seoses on isikule arengukava loodud. Täidetakse ainult isikupõhise (developmentPlanScope = INDIVIDUAL) arengukava puhul.
personalCode	0..1	String	Arengukava omaniku isikukood. Täidetakse ainult isikupõhise (developmentPlanScope = INDIVIDUAL) arengukava korral.
title	1	String	Arengukava pealkiri.
logoFileId	0..1	String	Viide logo failile.
startDate	0..1	Date	Arengukava perioodi alguskuupäev.
endDate	0..1	Date	Arengukava perioodi lõpukuupäev.
sections	1..*	Array	Arengukava sektsioonide nimekiri.
sections.id	1	String	Arengukava sektsiooni unikaalne identifikaator.
sections.name	1	String	Arengukava sektsiooni pealkirjana kuvatav nimetus.
sections.previousSectionId	0..1	String	Viide sektsiooni ID-le, mis eelneb käesolevale sektsioonile arengukava sektsioonide järjestuses. Selle väärtuse alusel järjestatakse komponendid arengukavas.
sections.hidden	1	String	Määrab, kas sektsioon lisatakse arengukava PDF-i või URL-iga jagatavasse versiooni.

Ärireeglid

Igal asutusel / ametikohal võib olla ainult üks muudetav arengukava.
Arengukavasse lisatakse vaikimisi viis arengukava sektsiooni kindlas järjekorras: Sissejuhtatus, Missioon, Visioon, Põhiväärtused, Riskid.
Arengukava algus- ja lõpukuupäevasid ei eeltäideta - need jäävad vaikimisi tühjaks.

Tegevused

Süsteem kontrollib, kas kasutajal on õigust päringut teostada.
1. Kui õigust pole, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
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.
Süsteem kontrollib, et sisendis esitatud asutusel / ametikohal ei oleks juba arengukava olemas:
1. Süsteem otsib Objektid#DevelopmentPlan objekti, mille:
  1. editable = true
  2. developmentPlanScope = sisendis esitatud developmentPlanScope väärtus
  3. institution.id = sisendis esitatud institutionId väärtus
  4. Kui developmentPlanScope = "INSTITUTIONAL", siis:
    1. jobsite = NULL
    2. personalCode = NULL
  5. Kui developmentPlanScope = "INDIVIDUAL", siis:
    1. personalCode = päringu käivitanud kasutaja isikukood
    2. jobsite = sisendis esitatud jobsite väärtus
2. Kui sobiv arengukava leitakse, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
Kui arengukava ei leita, loob süsteem selle automaatselt järgmist loogikat järgides:
1. Süsteem loob Objektid#DevelopmentPlan objekti järgmiste parameetritega:
  1. id = UUID
  2. editable = true
  3. title = "Arengukava"
  4. developmentPlanScope = sisendis esitatud developmentPlanScope väärtus
  5. institution.id = sisendis esitatud institutionId väärtus
  6. institution.name = sisendis esitatud institutionName väärtus
  7. institution.type = sisendis esitatud institutionType väärtus
  8. Kui developmentPlanScope = "INSTITUTIONAL":
    1. personalCode = NULL
    2. jobsite = NULL
  9. Kui developmentPlanScope = "INDIVIDUAL":
    1. personalCode = päringu käivitanud kasutaja isikukood
    2. jobsite = sisendis esitatud jobsite väärtus
  10. startDate = NULL
  11. endDate = NULL
  12. logoFileId = NULL
2. Süsteem lisab loodud arengukavale vaikimisi 5 sektsiooni vastavas järjekorras: Sissejuhtatus, Missioon, Visioon, Põhiväärtused, Riskid.
  1. Iga sekstiooni kohta luuakse üks Objektid#DevelopmentPlanSection objekt vastavalt järgmisele loogikale:
    1. id = UUID
    2. developmentPlanId = vastloodud arengukava ID (Objektid#DevelopmentPlan.id)
    3. name = üks eeltoodud nimedest vastavas järjekorras
    4. previousSectionId = esimesele sektsioonile määratakse väärtuseks NULL, iga järgmiste sektsiooni puhul määratakse selleks eelmise loodud sektsiooni ID (Objektid#DevelopmentPlanSection.id)
    5. hidden = false
Süsteem tagastab loodud arengukava andmed.

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