PM: UC: Eesmärgi mõõdiku lisamine/muutmine

Sisukord

Üldkirjeldus

Kasutajal on võimalik:

• lisada eesmärgile mõõdik juhtimislaualt valitud näitaja põhjal,
• sisestada ja muuta mõõdiku kirjeldust,
• määrata sihttasemed iga aasta kohta eraldi.

Kasutaja saab mõõdiku lisamise või muutmise algatada vaates PM: UC: Eesmärkide kirjeldamine (lisamine/muutmine).

Asutuspõhisele eesmärgile mõõdiku lisamiseks või selle muutmiseks peab kasutajal EHIS-es olema vastava asutuse juures eesmärkide lisamise ja muutmise õigus. 

Õiguse lisada mõõdik enda isikupõhisele eesmärgile annab kasutajale EHIS-es määratud ametikoht ning seos asutusega.

Arhiveeritud eesmärkide mõõdikuid ei saa muuta. 

Seotud Jira taskid

NSIL-891 - Getting issue details... STATUS

Kasutajaliides

Disainid

Eesmärgile mõõdiku lisamise modaalaken:
Uue mõõdiku lisamine, kui juhtimislaud on valitud, kuvatud on alateemad, filtrid ja näitajad, avatud on ühe näitaja detailvaade:
Uue mõõdiku lisamine/muutmine, kui detailvaates on näitaja valitud ning see on "Valitud näitajad" plokis kuvatud:

Eeltingimused

Kasutaja on sisse loginud ja valinud sobiva rolli:

• Asutus:
  • Tegemist on asutusepõhise eesmärgiga (Goal.goalScope = INSTITUTIONAL):
    • Kasutajal on seos eesmärgi asutusega ja sama asutuse eesmärkide lisamise ja muutmise õigus. 
      • Goal.institution.id = Kasutaja poolt valitud rolliga seotud asutus
      • Õigust reguleerib privileeg: HSILM_PLANNING_GOAL_MANAGE.
• Ametikoht: 
  • Tegemist on isikupõhise eesmärgiga (Goal.goalScope = INDIVIDUAL):
    • Kasutaja on eesmärgi omanik ja tal on seos eesmärgi asutuse ja ametikohaga.
      
      • Goal.personalCode = Kasutaja isikukood. 
      • Goal.institution.id = Kasutaja poolt valitud rolliga seotud asutus
      • Goal.jobsite = Kasutaja poolt valitud rolliga seotud ametikoht
    • Eraldi privileegi ei ole vaja.
• Meeskonnaliikme ja arhiivi rollis kasutajatel puudub õigus eesmärgi mõõdikuid hallata, 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 muudetava mõõdiku andmete saamiseks: PM: API: Goal: GET /planning-api/goals/{goalId}/metrics/{goalMetricsId}.
      1. Sisend:
         1. goalMetricsId = muudetava mõõdiku ID
         2. goalId = eesmärgi ID, mille vaates mõõdiku muutmine algatati
   2. Kasutajaliides teeb päringu eesmärgiga seotud (rollis valitud) asutuse juhtimislaudade loetelu saamiseks: GS: DashboardDefinition: API: GET /dashboard-api/dashboards
      1. Sisend: institutionId = eesmärgi (rollis valitud) asutuse ID
         1. PM: API: Goal: GET /planning-api/goals.response.goals.institution.id.
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. 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. 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. Sisend:
            1. userPersonalCode = kasutaja isikukood
            2. dashboardDefinitionId = kasutaja valitud juhtimislaua ID
            3. institutionId = eesmärgi 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.
           • 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. Näitaja detailvaates saab kasutaja näitaja valida, vajutades vastavat nuppu.
   5. Mõõdikule peab valima vähemalt ühe näitaja. Maksimaalselt saab valida kuni 3 näitajat, mis võivad pärineda erinevatelt juhtimislaudadelt. 
   6. Valitud näitajad kuvatakse kasutajale eraldi nimekirjas ("Valitud näitajad" plokis).
3. Mõõdiku sihtasemete määramine: 
   1. Kasutaja saab mõõdikule lisada sihttasemed, määrates neid aastate kaupa.
      1. Sihttaseme lisamine ei ole kohustuslik, kuid kui sihttaseme rida lisatakse, siis on kohustulik täita nii aasta kui ka kirjeldus.
      2. Iga lisatud sihttase kuvatakse eraldi real, kirjeid aasta kaupa ei gruppeerita. 
      3. Sama aasta kohta saab lisada mitu sihttaset. 
4. Muutmisvaates saab kasutaja teostada kõiki samu tegevusi nagu lisamisevaates,
   1. sealhulgas: 
      1. muuta mõõdiku kirjeldust
      2. lisada mõõdikule PBI aruandeid
      3. eemaldada olemasolevaid aruandeid.
   2. Andmete salvestamisel kirjutatakse mõõdikuga seotud aruannete nimekiri üle. 
5. Mõõdiku andmete salvestamine:
   1. Uue mõõdiku lisamiseks käivitatakse päring: PM: API: Goal: POST /planning-api/goals/{goalId}/metrics.
      1. Sisend:
         1. goalId = eesmärgi ID, mille vaates mõõdiku muutmine algatati
         2. description = välja "Mõõdiku kirjeldus" sisestatud väärtus
         3. reports nimekirja lisatakse kasutaja poolt valitud näitajad. Iga näitaja kohta täidetakse järgmised atribuudid:
            1. reports.workspaceId = valitud PBI aruande tööruumi ID
            2. reports.reportId = valitud PBI aruande ID
            3. reports.bookmark = aruandes tehtud valikud (nt vahelehe filtrid, näitaja filtrid, aruande pealt valitud filtrid)
         4. targets nimekirja lisatakse kasutaja poolt lisatud sihttasemed. Iga sihttaseme kohta täidetakse järgmised atribuudid:
            1. targets.year = välja "Aasta" väärtus
            2. targets.description = välja "Sihttaseme kirjeldus" väärtus
   2. Olemasoleva mõõdiku andmete muutmiseks käivitatakse päring: PM: API: Goal: PUT /planning-api/goals/{goalId}/metrics/{goalMetricsId}.
      1. Sisend:
         1. goalMetricsId =  muudetava mõõdiku ID
         2. Ülejäänud andmed täidetakse samamoodi nagu mõõdiku lisamise päringu puhul. 

Andmed

Kasutaja tegevused