PM: UC: Arengukava sektsiooni näitaja lisamine/muutmine

Sisukord

Üldkirjeldus

Kasutaja saab lisada arengukava sektsioonile näitaja juhtimislaualt ja sisestada selle kirjelduse.

Kasutaja saab näitaja lisamise algatada vaates PM: UC: Arengukava lisamine/muutmine, valides sektsiooni sees näitaja tüüpi vormielemendi lisamise. Selleks peab tal olema arengukava lisamise ja muutmise õigus.

Seotud Jira taskid

NSIL-1194 - Getting issue details... STATUS

Kasutajaliides

Disainid

Arengukava sektsiooni näitaja lisamine:  https://www.figma.com/design/mPPdrh04luwBeiX856NQPP/NAPO---TWN?node-id=9085-39593&t=R416ydiWeqrRBQIR-1
Uue näitaja lisamine, kui juhtimislaud on valitud, kuvatud on alateemad, filtrid ja näitajad, avatud on ühe näitaja detailvaade: https://www.figma.com/design/mPPdrh04luwBeiX856NQPP/NAPO---TWN?node-id=12522-61186&t=S8Kz64vJZpKGjT2t-1
Uue näitaja lisamine, kui detailvaates on näitaja valitud ning see on "Valitud näitajad" plokis kuvatud: https://www.figma.com/design/mPPdrh04luwBeiX856NQPP/NAPO---TWN?node-id=12522-62155&t=R416ydiWeqrRBQIR-1

Eeltingimused

Kasutaja on sisse loginud ja valinud sobiva rolli:

• Asutus:
  • Kasutajal on seos nii arengukava asutusega ning tal on selle asutuse arengukava lisamise ja muutmise õigus.  
    • DevelopmentPlan.institution.id = Kasutaja poolt valitud rolliga seotud asutus
    • Õigust reguleerib privileeg: HSILM_PLANNING_DEV_PLAN_MANAGE.
• Ametikoht:
  • Kasutaja on nii arengukava omanik ning seotud 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
• Meeskonnaliikme ja arhiivi rollis kasutajatel puudub õigus arengukava luua ja muuta, mistõttu ei ole neil sellele vaatele ligipääsu.

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

Funktsionaalsus

Selgitused

1. Modaalakna avamisel:
   1. Kasutajaliides teeb päringu arengukavaga seotud asutuse juhtimislaudade loetelu saamiseks: GS: DashboardDefinition: API: GET /dashboard-api/dashboards
      1. Päringu sisend: institutionId = arengukava asutuse ID
         1. PM: API: DevelopmentPlan: GET /planning-api/development-plans.response.institutionId.
2. Näitaja(te) ülevaade ja valik:
   1. Kasutaja valib juhtimislaua.
      1. Kasutajaliides pärib juhtimislaua vahelehed (esimese taseme komponendid) ja alamteemad (teise taseme komponendid): 
         1. Selleks käivitatakse esmalt päring GS: DashboardDefinitionSection: API: GET /dashboard-api/dashboards/{dashboardId}/components-order
            1. Päringu sisend: dashboardId = kasutaja valitud juhtimislaua ID. 
         2. Tagastatud andmetest filtreeritakse esimese ja teise taseme komponentide ID-d: 
            1. GS: DashboardDefinitionSection: API: GET /dashboard-api/dashboards/{dashboardId}/components-order.response.components.id, mille puhul components.type = SECTION ja (components.level = 1 või components.level = 2)
         3. Süsteem pärib nimetused komponentidele:
            1. Süsteem käivitab päringu juhtimislaua sektsioonide loetelu saamiseks: GS: DashboardDefinitionSection: API: GET /dashboard-api/dashboards/{dashboardId}/sections 
               1. Päringu sisend: dashboardId = kasutaja valitud juhtimislaua ID. 
            2. Tagastatud sektsioonide seast filteeritakse need, mille ID-d vastavad varem leitud komponentide ID-dele:
               1. GS: DashboardDefinitionSection: API: GET /dashboard-api/dashboards/{dashboardId}/sections.response.name, mille id = GS: DashboardDefinitionSection: API: GET /dashboard-api/dashboards/{dashboardId}/components-order.response.components.id, mille components.type = SECTION ja (components.level = 1 või components.level = 2)
      2. Kasutajaliides pärib kasutaja poolt juhtimislaual esiletõstetud aruanded: GS: UserDashboardElement: API: GET /dashboard-api/user-dashboard-elements.
         1. Päringu sisend:
            1. userPersonalCode = kasutaja isikukood
            2. dashboardDefinitionId = kasutaja valitud juhtimislaua ID
            3. institutionId = arengukava asutuse ID
   2. Näitajate (aruannete) ülevaatamiseks valib kasutaja juhtimislaua vahelehe.
   3. Soovi korral saab kasutaja kitsendada nimekirja, valides alamteema. Valiku tegemise järel:
      1. Kasutajaliides pärib valitud vahelehe või alamteema näitajad ja kuvab nende eelvaated.
      2. Kasutajale kuvatakse ainult need näitajad, mis on märgitud kui põhiaruanded.
         • Selgitus: Ühel näitajal (aruande komponendil) võib olla mitu aruannet, kuid põhiaruandeks saab määrata ainult ühe neist.
         • Kasutajaliides teeb päringu GS: DashboardDefinitionSection: API: GET /quality-api/dashboard-definitions/{dashboardDefinitionId}/elements/{elementId}/reports.
           • Päringu sisend:
             • dashboardDefinitionId = kasutaja valitud juhtimislaua ID
             • elementId = juhtimislaualt valitud vahelehe või alamteema ID
         • Päringu tulemustest filtreeritakse ainult põhiaruanded:
           
           • GS: DashboardDefinitionSection: API: GET /quality-api/dashboard-definitions/{dashboardDefinitionId}/elements/{elementId}/reports.response.reports, mille reports.mainReport = true
   4. Kasutaja saab näitaja valida, vajutades vastava nuppu näitaja detailvaates.
   5. Korraga saab valida maksimaalselt ühe näitaja. 
   6. Valitud näitajad kuvatakse kasutajale eraldi nimekirjas ("Valitud näitajad" plokis).
3. Muutmisvaates saab kasutaja teostada kõiki samu tegevusi nagu lisamisvaates,
   1. sealhulgas: 
      1. muuta näitaja kirjeldust
      2. lisada näitajale PBI aruandeid
      3. eemaldada olemasolevaid aruandeid.
   2. Andmete salvestamisel kirjutatakse näitajaga seotud aruannete nimekiri üle. 
4. Näitaja andmete salvestamine:
   1. Kui kasutaja lisab uue näitaja:  
      1. Käivitatakse päring uue aruande tüüpi vormielemendi lisamiseks: PM: API: DevelopmentPlan: POST /planning-api/development-plans/{developmentPlanId}/sections/{sectionId}/elements. 
         1. Päringu sisend:
            1. sectionId = sektsiooni ID, millele lisatakse uus vormielement
               1. PM: API: DevelopmentPlan: GET /planning-api/development-plans.response.sections.id
               2. PM: API: DevelopmentPlan: POST /planning-api/development-plans.response.sections.id
            2. developmentPlanId = arengukava ID, mille andmeid muudetakse
            3. previousElementId = vormielemendi ID, mille alla arengukava vormil uus vormielement lisatakse.
               1. Kui sektsioonile lisatakse kõige esimene element või uus element lisatakse kuvamiseks esimesena, siis atribuudi väärtuseks määratakse NULL.
            4. inputType = "REPORT" (viide klassifikaatori INPUT_TYPE väärtusele)
      2. Tegevuse õnnestumisel käivitatakse järgmine päring valitud PBI aruannete lisamiseks loodud vormielemendile: PM: API: DevelopmentPlan: PUT /planning-api/development-plans/{developmentPlanId}/sections/{sectionId}/elements/{elementId}.
         1. 1. elementId = just loodud vormielemendi ID / muudetava vormielemendi ID
            2. sectionId = sektsiooni ID, kuhu muudetav vormielement kuulub
            3. developmentPlanId = arengukava ID, mille andmeid muudetakse
            4. report.description = välja "Näitaja kirjeldus" väärtus
            5. report.selectedreports nimekirjasse lisatakse kasutaja valitud PBI aruanded. Iga aruande kohta lisatakse eraldi kirje, kus täidetakse järgmised andmed: 
               1. workspaceId = kasutaja valitud PBI aruande tööruumi ID
               2. reportId = valitud PBI aruande ID
               3. bookmark = valikud, mis on tehtud PBI aruandes (nt vahelehe filtrid, näitaja filtrid, aruande pealt valitud filtrid)
   2. Kui muudetakse varem lisatud näitaja andmeid:
      1. Andmete salvestamisel käivitatakse vormielemendi andmete salvestamise päring: PM: API: DevelopmentPlan: PUT /planning-api/development-plans/{developmentPlanId}/sections/{sectionId}/elements/{elementId}.
      2. Sisend sama nagu on uue näitaja lisamise puhul.

Andmed

Kasutaja tegevused