PM: UC: Arengukava PDF-i genereerimine

Sisukord

Üldkirjeldus

Kasutajal on võimalus luua arengukava hetkeseisu kajastav PDF-versioon, mis salvestatakse süsteemi ja laaditakse alla kasutaja arvutisse.

Soovi korral saab kasutaja sama PDF-faili uuesti alla laadida vaates PM: UC: Arengukava kehtivate jagamiste vaatamine ja kustutamine.

PDF-i genereerimist saab algatada ja kehtivate jagamiste nimekirja avada vaates PM: UC: Arengukava lisamine/muutmine.

• Asutusepõhise arengukava puhul peab kasutajal olema vastava asutuse arengukava lisamise ja muutmise õigus.
• Isikupõhise arengukava puhul annab kasutajale õiguse luua ja alla laadida oma kehtivate ja lõppenud ametikohtadega seotud arengukavade PDF-versioone tema isikukood.

Seotud Jira taskid

NSIL-1068 - Getting issue details... STATUS

NSIL-1062 - Getting issue details... STATUS

Disainid

Eeltingimused

Kasutaja on sisse loginud ja valinud sobiva rolli:

• Kui tegemist on asutusepõhise arengukavaga (DevelopmentPlan.developmentPlanScope = "INSTITUTIONAL"):
  • Arengukava peab olema muudetav ja sellele peab olema määratud periood.
    • DevelopmentPlan.editable = TRUE,
    • DevelopmentPlan.startDate != NULL,
    • DevelopmentPlan.endDate != NULL.
  • Kasutajal peab olema seos arengukava asutusega ning selle asutuse arengukava lisamise ja muutmise õigus. 
    • DevelopmentPlan.institution.id = kasutaja valitud rolliga seotud asutus,
    • Õigust reguleerib privileeg: HSILM_PLANNING_DEV_PLAN_MANAGE.
• Kui tegemist on isikupõhise arengukavaga (DevelopmentPlan.developmentPlanScope = "INDIVIDUAL"):
  
  • Arengukava peab olema muudetav ja sellele peab olema määratud periood.
    • DevelopmentPlan.editable = TRUE,
    • DevelopmentPlan.startDate != NULL,
    • DevelopmentPlan.endDate != NULL.
  • Kasutaja peab olema arengukava omanik.
    • DevelopmentPlan.personalCode = kasutaja isikukood
  • Eraldi privileegi ei ole vaja - õiguse annab kasutaja kehtiv ametikoht. 
• Planeerimise meeskonnaliikme ja arhiivi rolli kasutajatel puudub ligipääs - nende kasutajatel ei ole õigust luua arengukavadest PDF-versioone.

Planeerimise mooduli kasutusrollide ja õiguste kohta saab täpsemalt infot leida lehelt Kasutusõigused ja rollid.

Funktsionaalsus

1. Arengukava PDF-versiooni genereerimiseks kasutatakse päringut: PM: API: DevelopmentPlan: POST /planning-api/development-plans/{developmentPlanId}/pdf-versions.
   1. Päringu sisend:
      1. developmentPlanId = muudetava arengukava ID, mille andmete põhjal uus PDF-versioon genereeritakse
         1. PM: API: DevelopmentPlan: GET /planning-api/development-plans.response.id
         2. PM: API: DevelopmentPlan: POST /planning-api/development-plans.response.id
   2. Selgitused:
      1. PDF-versiooni saab genereerida ainult muudetava (editable = true) arengukava põhjal. 
      2. Päringu tulemusel genereeritakse PDF-fail, mis sisaldab kõiki PM: UC: Arengukava lisamine/muutmine vaates kuvatavaid arengukava andmeid.
      3. Arengukava PDF-faili tiitellehel kuvatakse päritolu ja genereerimise aeg.
         1. nt. 'Haridussilm 18.11.2023 12:20:14'
      4. PDF-i ei lisata neid sektsioone, millele on märgitud "Peida dokumendis".
         1. Samuti ei lisata sektsiooni alla kuuluvaid vormielemente.
      5. Genereeritud PDF-fail salvestatakse failisüsteemi.
      6. Andmebaasis lisatakse uus PDF-versiooni kirje, mis sisaldab:
         1. viide kasutajale, kes genereerimise algatas,
         2. PDF-i loomise aega,
         3. viidet loodud failile.
      7. Andmebaasi eraldi koopiat arengukava andmetest ei salvestata.

Andmed

Arengukava PDF-faili andmed on analoogsed vaatega: PM: UC: Arengukava lisamine/muutmine / PM: UC: Arengukava vaatamine.