PM: API: DevelopmentPlan: POST /planning-api/development-plans/{developmentPlanId}/logos
Üldkirjeldus
Teenus võimaldab lisada arengukavale logo.
Seotud andmeobjektid:
Seotud Jira taskid
NSIL-991 - Getting issue details... STATUS
Eeltingimused ja kasutusõigused
- Kui tegemist on asutusepõhise arengukavaga (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.
- Kasutajal peab olema seos arengukava asutusega ning sama asutuse arengukava lisamise ja muutmise õigus.
- Kui tegemist on isikupõhise arengukavaga (developmentPlanScope = INDIVIDUAL):
- Kasutaja peab olema arengukava omanik ja tal peab olema seos nii arengukava asutuse kui ka ametikohaga.
- DevelopmentPlan.personalCode = Päringu käivitanud kasutaja isikukood
- DevelopmentPlan.institution.id = Kasutaja poolt valitud rolliga seotud asutus
- DevelopmentPlan.jobsite = Kasutaja poolt valitud rolliga seotud ametikoht
- Eraldi privileegi ei ole vaja.
- Kasutaja peab olema arengukava omanik ja tal peab olema seos nii arengukava asutuse kui ka ametikohaga.
- Arhiivi ja meeskonnaliikme rolli valinud kasutaja ei saa luua arengukava.
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 |
|---|---|---|---|---|
developmentPlanId | 1 | String |
| Arengukava unikaalne identifikaator. |
| logo | 1 |
| Elemendiga seotud fail. |
Väljundid
| Atribuut | Kohustuslikkus, mitmesus | Tüüp | Kirjeldus, täiendav info |
|---|---|---|---|
| id | 1 | UUID | Faili objekti id (UUID). |
| fileName | 1 | String | Faili nimetus koos faililaiendiga. Näiteks "minu pilt.png". |
| mimeType | 1 | String | Faili mime tüüp. Näiteks "image/x-png". |
| size | 1 | Integer | Faili suurus baitides. |
Tegevused
- Süsteem kontrollib, kas kasutajal on õigust päringut teostada.
- Kui kasutajal puudub õigus, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
- Süsteem kontrollib, kas sisendandmed vastavad nõuetele.
- Kui andmed ei vasta nõuetele, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
Süsteem kontrollib, kas sisendis esitatud arengukava (developmentPlanId) eksisteerib ja on muudetav:
- Süsteem otsib Objektid#DevelopmentPlan objekti, mille:
- id = sisendis esitatud developmentPlanId väärtus
- editable = true
- Kui vastavat arengukava ei leita, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
- Süsteem otsib Objektid#DevelopmentPlan objekti, mille:
- Süsteem kontrollib, kas arengukaval on juba olemas logo:
- Kui logo on olemas (Objektid#DevelopmentPlan.logoFileId != NULL), kustutatakse see.
- Süsteem kustutab andmebaasist jäädavalt Objektid#File objekti, mille:
- id = Objektid#DevelopmentPlan.logoFileId
- Süsteem kustutab andmebaasist jäädavalt Objektid#File objekti, mille:
- Kui logo on olemas (Objektid#DevelopmentPlan.logoFileId != NULL), kustutatakse see.
- Süsteem kontrollib viiruse kontrolliga, kas sisendis esitatud fail on viirusega nakatunud.
- Kui fail on nakatunud, siis lõpetab süsteem päringu töötlemise, tagastab http veakoodi ja info, et fail on viirusega nakatunud.
- Süsteem salvestab faili failisüsteemi.
- Süsteem salvestab failiga seotud metaandmed.
- Süsteem loob Objektid#File objekti järgmiste andmetega:
- id = UUID
- Faili asukoha andmestik failisüsteemis
- fileName = Faili nimetus koos faililaiendiga (nt. "minu pilt.png")
- mimeType = Faili mime tüüp (nt. "image/x-png")
- size = Faili suurus baitides
- audit (loomine) = audit (loomine)
- Süsteem loob Objektid#File objekti järgmiste andmetega:
- Süsteem seob faili arengukavaga.
- Süsteem uuendab Objektid#DevelopmentPlan objekti, mille id = sisendis esitatud developmentPlanId väärtus, määrates:
- logoFileId = just loodud Objektid#File.id
- Süsteem uuendab Objektid#DevelopmentPlan objekti, mille id = sisendis esitatud developmentPlanId väärtus, määrates:
- Süsteem tagastab arengukavale logona lisatud faili andmed.