NSILM

Sisukord

Üldkirjeldus 

Selle kasutajaliidese funktsionaalsuse sisuks on kirjeldada kvaliteedi hindamise enesehindamise andmete lisamist ja poolelioleva muutmist
Kasutaja jõuab KOV-i enesehindamise töövahendi kuvamise vormile järgnevalt:

  • enesehindamise lisamine/muutmine - valib hindamisplaanil "Edasi hindamisvormile"

NSIL-351 - Getting issue details... STATUS NSIL-363 - Getting issue details... STATUS NSIL-376 - Getting issue details... STATUS NSIL-405 - Getting issue details... STATUS NSIL-524 - Getting issue details... STATUS NSIL-619 - Getting issue details... STATUS NSIL-622 - Getting issue details... STATUS NSIL-690 - Getting issue details... STATUS NSIL-1212 - Getting issue details... STATUS NSIL-1316 - Getting issue details... STATUS NSIL-1360 - Getting issue details... STATUS NSIL-1372 - Getting issue details... STATUS

Kasutajaliides

Disainid

Uue enesehindamise lisamine (KOV-i enesehindamise töövahendi avamisel suletud kõik akordionid):

https://www.figma.com/file/C2WEcl6vxM34BNvy0VQCel/NAPO?type=design&node-id=1958-9141&mode=design&t=HDVeOtY7maKRsUwj-4

Uue enesehindamise lisamine (avatud akordionid):

https://www.figma.com/file/C2WEcl6vxM34BNvy0VQCel/NAPO?type=design&node-id=2041-8175&mode=design&t=HDVeOtY7maKRsUwj-4

Poolelioleva enesehindamise muutmine: 

https://www.figma.com/file/C2WEcl6vxM34BNvy0VQCel/NAPO?type=design&node-id=2125-9022&mode=design&t=HDVeOtY7maKRsUwj-4

Poolelioleva enesehindamise muutmine (KOV-i välishindamise töövahendi kuvalt saadetud tagasi täiendamiseks): 

https://www.figma.com/file/C2WEcl6vxM34BNvy0VQCel/NAPO?type=design&node-id=2951-9698&mode=design&t=HDVeOtY7maKRsUwj-4

Enesehindamise vaade, kui täiendamise kommentaarid on lisatud: https://www.figma.com/file/mPPdrh04luwBeiX856NQPP/NAPO-TWN?type=design&node-id=6637-49346&mode=design&t=DyXmCE7ihiPs4HFa-4


Täiendamise kommentaaride modaal: https://www.figma.com/file/mPPdrh04luwBeiX856NQPP/NAPO-TWN?type=design&node-id=6637-49343&mode=design&t=DyXmCE7ihiPs4HFa-4


Enesehindamise vorm pildi lisamise võimalusega: https://www.figma.com/design/mPPdrh04luwBeiX856NQPP/NAPO---TWN?node-id=6474-13365&t=eUPGSiwT15Rcp1tL-4


Enesehindamise vorm kasutaja poolt lisatud piltidega: https://www.figma.com/design/mPPdrh04luwBeiX856NQPP/NAPO---TWN?node-id=6474-14151&t=eUPGSiwT15Rcp1tL-4


Enesehindamise vorm muudetavana koos mudeli haldaja poolt lisatud piltide, vabateksti ja veebilinkidega: https://www.figma.com/design/mPPdrh04luwBeiX856NQPP/NAPO---TWN?node-id=6474-16226&t=eUPGSiwT15Rcp1tL-4


Enesehindamise vorm mittemuudetavana koos piltidega: https://www.figma.com/design/mPPdrh04luwBeiX856NQPP/NAPO---TWN?node-id=6474-16956&t=eUPGSiwT15Rcp1tL-4


Enesehindamise vorm muudetavana PBI aruanne elemendi sisestamiseks:

https://www.figma.com/design/mPPdrh04luwBeiX856NQPP/NAPO---TWN?node-id=7933-69871&node-type=canvas



Enesehindamise vorm muudetavana, kui PBI aruanne element on täidetud, saab lisada elemendi alla uut näitajat ja olemasolevat näitajat muuta ja kustutada:

https://www.figma.com/design/mPPdrh04luwBeiX856NQPP/NAPO---TWN


 

Enesehindamise vorm muudetavana, kui PBI aruanne elemendi kirjeldus on täidetud maksimaalsete tähemärkidega:

https://www.figma.com/design/mPPdrh04luwBeiX856NQPP/NAPO---TWN

Eeltingimused

  • Kui tegemist on asutusepõhise hindamisega (GS: Assessment: API: GET /quality-api/assessments/{id}.response.assessmentScope = INSTITUTIONAL):
  • Kui tegemist on isikupõhise hindamisega (GS: Assessment: API: GET /quality-api/assessments/{id}.response.assessmentScope = INDIVIDUAL):
  • Kui kasutaja on hindamise meeskonna liige (Kehtib asutusepõhistel ja isikupõhistel hindamistel).
    • Kasutajal peab olema hindamise valdkonnaga seotud enesehindamise andmete vaatamise või muutmise õigus töödeldava hindamisega seoses ja kasutaja peab olema seotud hindamisega. 
        • GS: Assessment: API: GET /quality-api/assessments/{id}/team-members.response.teamMembers.personalCode = Päringu käivitanud isiku isikukood.
        • AssessmentTeamMember.objectStatus = CURRENT
        • Classifier.classifierItemCode = Assessment.domain
        • Classifier.classifierAttributeDefinitionCode = ASSESSMENT_SELF_ASSESSMENT_VIEW_PRIVILEGE või ASSESSMENT_SELF_ASSESSMENT_MANAGE_PRIVILEGE
        • Classifier.attributeValue = Kasutaja poolt valitud rolli privileegide hulgas olev privileeg.

Funktsionaalsus

Selgitused

  1. Kasutaja avab enesehindamise.
  2. Süsteem käivitab hindamise andmete saamiseks päringu GS: Assessment: API: GET /quality-api/assessments/{id}. Sisend:
    • id = Avatud hindamine.
  3. Süsteem käivitab hindamise etappide saamiseks päringu GS: Assessment: API: GET /quality-api/assessments/{id}/phases. Sisend:
    • id = Avatud hindamine.
  4. Süsteem käivitab hindamise aruannete vahelehtede nimetuste saamiseks päringu GS: Assessment: API: GET /quality-api/assessments/{id}/assessment-component/report-tabs. Sisend:
    • id = Avatud hindamine.
  5. Süsteem käivitab meeskonnaliikmete nimekirja saamiseks päringu GS: Assessment: API: GET /quality-api/assessments/{id}/team-members. Sisend:
    • id = Avatud hindamine.
  6. Süsteem käivitab sektsioonide nimekirja saamiseks päringu GS: Assessment: API: GET /quality-api/assessments/{id}/assessment-component/sections. Sisend:
    • id = Avatud hindamine.
  7. Süsteem käivitab hindamise elementide saamiseks päringu GS: Assessment: API: GET /quality-api/assessments/{assessmentId}/assessment-component/elements. Sisend:
    • assessmentId = Avatud hindamine.
    • phaseTypes = SELF_ASSESSMENT
  8. Süsteem käivitab hindamise komponentide järjekorra saamiseks päringu GS: Assessment: API: GET /quality-api/assessments/{assessmentId}/assessment-component/order. Sisend:
    • assessmentId = Avatud hindamine
  9. Süsteem käivitab täiendamise kommentaaride nimistu saamiseks päringu GS: Assessment: API: GET /quality-api/assessments/{assessmentId}/phase-assignments. Sisend:
    • assessmentId = Avatud hindamine
  10. Süsteem käivitab hindamise etappide ja meeskonnaliikmete aliaste nimekirja saamiseks päringu GS: Assessment: API: GET /quality-api/assessments/{id}/aliases. Sisend:
    • id = Avatud hindamine.
  11. Süsteem käivitab piltide kuvamiseks päringu GS: Assessment: API: GET /quality-api/assessments/{assessmentId}/assessment-component/elements/{elementId}/files/{fileId}/download. Iga elemendi faili kohta tehakse eraldi päring. Sisend:
  12. Süsteem käivitab hindamise kokkuvõtete nimekirja saamiseks päringu GS: AssessmentSummary: API: GET /quality-api/assessments/{assessmentId}/assessment-summaries. Sisend:
    • assessmentId = Avatud hindamine
  13. Kui tegemist on hierarhilise hindamise peamise hindamisega, siis käivitab süsteem vastajate nimekirja saamiseks päringu.
  14. Süsteem kuvab enesehindamise andmed.

Andmed

Elemendi nimetus

Selgitus

Tehniline info

Päis

Lehe päis


Päis → {year}: Enesehindamise töövahend

Lehe pealkiri.

Päis → Progressiriba

Progressiriba. Kuvatakse hindamisega seotud etapid.

Päis → Aruannete vahelehtede nimetused

Aruannete vahelehtede nimetused (figmas kui tulemusindikaatorid ja kokkuvõte).

Meeskond

Hindamisega seotud meeskonna andmed.

  • Meeskonna sektsioonis kuvatakse ainult need meeskonna liikmed, kelle roll on vaikimisi roll
  • Esimesel real kuvatakse hindamise meeskonnajuhid ja enesehindajad. 
    • Esmalt kuvatakse meeskonnajuhid nime järgi kasvavas järjekorras, kui nimi puudu, siis kuvatakse esmalt nimega meeskonnajuhid kasvavas järjekorras ja seejärel isikukoodiga juhid kasvavas järjekorras.
    • Meeskonnajuhtidega samal real kuvatakse ka enesehindajad nime järgi kasvavas järjekorras peale meeskonnajuhte. Kui nimi puudu, siis kuvatakse esmalt nimega enesehindajad kasvavas järjekorras ja seejärel isikukoodiga enesehindajad kasvavas järjekorras.
    • Kui juhte ja enesehindajad on rohkem kui ühele reale mahub, siis kuvab süsteem juhid ja enesehindajad järgmistel ridadel.
  • Eraldi real on kuvatud välishindajad. Kui neid on rohkem rohkem kui ühele reale mahub, siis kuvab süsteem juhid ja enesehindajad järgmistel ridadel.
    • Välishindajad kuvatakse nime järgi kasvavas järjekorras. Kui nimi puudu, siis kuvatakse esmalt nimega välishindajad kasvavas järjekorras ja seejärel isikukoodiga välishindajad  kasvavas järjekorras.
  • Kui tegemist on hindamise alahindamisega, siis sektsiooni ei kuvata.
Meeskond → Haldan meeskonda

Võimalus vaadata meeskonna liikmete andmeid ja hallata neid.

Nupule vajutamine käivitab PL: UC: Meeskonnaliikmete andmete haldamine enesehindamise ja välishindamise etapis
Meeskond → Liikme avatar

Liikme avatar.

Meeskond → Liikme nimi või isikukood

Liikme nimi või isikukood.

Meeskond → Liikme roll

Liikme roll.

Vastajad

Peamise hindamisega seotud alahindamiste meeskonnaliikmete andmed

Vastajad → Haldan vastajad

Võimalus hallata vastajaid.

Vastajad → Vastajate grupp

Vastajate grupi nimetus ja grupi avatar ja vastanud isikute arv, nõutud isikute arv.

Tagasiside

Võimalus avada täiendamise kommentaaride nimistu.

Tagasiside → Täiendamise kommentaaride modaal

Täiendamise kommentaaride modaal

Tagasiside → Täiendamise kommentaaride modaal → Kommentaari kuupäev ja kellaaegKommentaari kuupäev ja kellaaeg

 

Tagasiside → Täiendamise kommentaaride modaal → Silt "Uus"Silt "Uus"
  • Silti kuvatakse esimesel kommentaaril, kui enesehindamine on kinnitamata. Kui enesehindamine on kinnitatud või kommentaar ei ole nimistus esimene kommentaar, siis siliti ei kuvata.
Tagasiside → Täiendamise kommentaaride modaal → KommentaarKommentaar

 

Tagasiside → Täiendamise kommentaaride modaal → Kommentaari lisajaKommentaari lisaja

 

Hindamise vahelehtede karusell

Hindamise vahelehtede karusell

Hindamise vahelehtede karusell → Tabi nimetus

Hindamismudelis määratud komponendile vahelehtede karussellid kuvatav nimetus

Hindamise vahelehtede karusell → Hinnang

Enesehindamise alameesmärkidele määratud hinnangute keskmine väärtus

Hindamise vahelehtede karusell → Edenemine

Enesehindamisevormil täidetud andmeväljade ja täitmist vajavate andmeväljade suhe. Nt. kujul "5/15"

Sektsioonid

Hindamise komponentide sektsioonid.

Sektsioonid → {parentLevelSectionSeqNo[]}.{sectionSeqNo }

Sektsiooni järjekorra number. Näiteks 1.2.4

  • Kui tegemist on esimese taseme sektsiooniga, siis ülemtaseme sektsiooni järjekorra numbreid ei kuvata.
  • parentLevelSectionSeqNo[] = Süsteem arvutab ise sektsioonide põhjal sektsiooni ülema järjekorra, aga eemaldab järjekorra arvutamisel elementide järjekorra. Näiteks kui vastuses on järjekord selline: 1. element (seq=1), 2. sektsioon (seq=2), 3. element (seq=3) ja 4. sektsioon (seq=4), siis sektsioonide järjekord on 1.sektsioon (seq = 2), 2. sektsioon (seq=4). Süsteem kuvab parentLevelSectionSeqNo väärtuseks 1, 2, mitte 2 ja 4.
  • sectionSeqNo = Süsteem arvutab ise sektsioonide põhjal sektsiooni ülema järjekorra, aga eemaldab järjekorra arvutamisel elementide järjekorra. Näiteks kui vastuses on järjekord selline: 1. element (seq=1), 2. sektsioon (seq=2), 3. element (seq=3) ja 4. sektsioon (seq=4), siis sektsioonide järjekord on 1.sektsioon (seq = 2), 2. sektsioon (seq=4). Süsteem kuvab parentLevelSectionSeqNo väärtuseks 1, 2, mitte 2 ja 4.
Sektsioonid → Sektsiooni nimetus

Sektsiooni pikk nimetus,

GS: Assessment: API: GET /quality-api/assessments/{id}/assessment-component/sections.response.sections.name

 

Sektsioonid → Sektsiooni selgitus

Sektsiooni selgitus.

Sektsioonid → Elemendid

Sektsiooni elemendid

Sektsioonid → Elemendid → Element → Elemendi nimetus

Elemendi nimetus.

Sektsioonid → Elemendid → Element → Elemendi tooltip

Elemendi tooltip.

Sektsioonid → Elemendid → Element  → Elemendi väärtus(ed)

Elemendi väärtused.

Sektsioonid → Elemendid → Element  → Lisa sisu

Võimalus lisada multielemente

  • Nuppu kuvatakse iga elemendi järel, sh multielemendi järel, kui kasutajal on võimalus elemendi andmeid muuta (vaata Sektsioonid → Elemendid).
  • Nupule vajutades avaneb kasutajale menüü, kust kasutaja saab valida:
    • Lisa tekstiala
    • Lisa pilt
    • Lisa fail
    • Lisa näitaja juhtimislaualt
  • Kui kasutaja teeb menüüst valiku, siis:
    1. Süsteem käivitab multielemendi loomiseks päringu GS: Assessment: API: POST /quality-api/assessments/{assessmentId}/assessment-component/elements. Sisend:
      • assessmentId = Avatud hindamise id.
      • sectionId = Sektsioon kuhu multielement lisatakse.
      • previousComponent.id = Eelmise elemendi id.
      • previousComponent.type = ELEMENT
      • inputType
        • Tekstiala = TEXT_AREA 
        • Pilt = IMAGE
        • Fail = FILE 
        • Näitaja juhtimislaualt = REPORT
      • phaseType = SELF_ASSESSMENT 
    2. Süsteem kuvab kasutajale loodud multielemendi.
    3. Süsteem kuvab kasutajale teate muldielemendi lisamise kohta.
    4. Multielemendi täitmine jätkub nagu mudeli haldaja poolt lisatud elemendi muutmine (Vaata Sektsioonid → Elemendid → Element  → Elemendi väärtus(ed)  →  Sisuelemendi tüüp on "Kasutaja sisend")
  • Lisatud multielemente saab kasutaja kustutada. Mudelihaldaja poolt lisatud elemente kustutada ei saa.
  • Kui kasutaja algatab elemendi kustutamise, siis:
    1. Süsteem kuvab kasutajale kustutamise kinnitamise vaate.
    2. Kasutaja kinnitab kustutamise.
    3. Süsteem käivitab elemendi kustutamiseks päringu GS: Assessment: API: DELETE /quality-api/assessments/{assessmentId}/assessment-component/elements/{elementId}. Sisend:
      • assessmentId = Avatud hindamise id.
      • elementId = Kustutatava elemendi id.
    4. Süsteem eemaldab kustutatud multielemendi vormilt.
    5. Süsteem kuvab kasutajale teate multielemendi kustutamise kohta.
Enesehindamise jalus

Enesehindamise jalus


Enesehindamise jalus → Lähtesta hindamineVõimalus lähtestada hindamine
  • Kui tegemist on hindamise alahindamisega, siis sektsiooni ei kuvata.
  • Nupp on kuvatud, kui hindamine ei ole lõppenud ja kasutajal on hindamise haldamise õigus hindamisega seotud asutuse juures. Muudel juhtudel ei kuvata nuppu.
  • Kui kasutaja vajutab nupule, siis:
    1. Süsteem kuvab kasutajale hindamise lähtestamise kinnitamise modaali.
    2. Kasutaja kinnitab hindamise lähtestamise.
      1. Kasutaja saab katkestada hindamise lähtestamise.
    3. Süsteem käivitab hindamise lähtestamiseks päringu GS: Assessment: API: POST /quality-api/assessment-reset. Sisend: 
      • assessmentId = Avatud hindamise id.
        1. Kui hindamise lähtestamine ebaõnnestub, siis kuvab süsteem selle kohta veateate ja info, et tuleks võtta ühendust kasutajatoega.
    4. Süsteem avab loodud hindamise vormi.
    5. Süsteem kuvab teate hindamise lähtestamise kohta.
Enesehindamise jalus → JagamineVõimalus hallata hindamise jagamisi.
Enesehindamise jalus → Tagasi hindamisplaanileVõimalus avada töölaud.
Enesehindamise jalus → KinnitaVõimalus kinnitada enesehindamine.
  • Nupp on kuvatud, kui enesehindamine on kinnitamata ja kasutajal on enesehindamise haldamise õigus. Muudel juhtudel ei kuvata nuppu.
  • Kui kasutaja vajutab nupule, siis:
    1. Süsteem kontrollib, kas mudeli haldaja poolt määratud (source = ASSESSMENT_MODEL) kohustuslikud elemendid on nõuetekohaselt täidetud.
          • Kui enesehindamise vormielemendi tüüp on mitmikvalik ja tegemist on kohustusliku elemendiga, siis peab olema vähemalt üks variant valitud.
          • Kui enesehindamise vormielemendi tüüp on vabatekst ja tegemist on kohustusliku elemendiga, siis peab olema vähemalt 3 tähemärki sisestatud.
          • Kui enesehindamise vormielemendi tüüp on üksikvalik ja tegemist on kohustusliku elemendiga, siis peab olema täpselt üks variant valitud.
          • Kui enesehindamise vormielemendi tüüp on arv ja tegemist on kohustusliku elemendiga, siis peab olema arv sisestatud.
          • Kui enesehindamise vormielemendi tüüp on osakaal ja tegemist on kohustusliku elemendiga, siis peab olema osakaal täidetud.
          • Kui enesehindamise vormielemendi tüüp on veebi link ja tegemist on kohustusliku elemendiga, siis peab olema vähemalt üks veebilink lisatud.
          • Kui enesehindamise vormielemendi tüüp on skaala ja tegemist on kohustusliku elemendiga, siis peab olema täpselt üks skaala element valitud.
          • Kui enesehindamise vormielemendi tüüp on pilt ja tegemist on kohustusliku elemendiga, siis peab olema täpselt üks pilt lisatud.
          • Kui enesehindamise vormielemendi tüüp on PBI aruanne ja tegemist on kohustusliku elemendiga, siis peab olema täpselt üks näitaja lisatud.
          • Kui enesehindamise vormielemendi tüüp on tabel ja tegemist on kohustusliku elemendiga, siis peab olema lisatud vähemalt üks rida andmeid ja kõikide tabelite kõikidel kohustuslikes veergudes peab kõikidel ridadel olema väärtus lisatud. Kui tabeli täitmine on kohustuslik, aga ükski veerg ei ole kohustuslik, siis peab olema lisatud vähemalt üks rida ja vähemalt ühe lahtri väärtus.
            1. Kui elementide andmed ei vasta nõuetele, siis kuvab süsteem vastava elemendi juures veateate.
    2. Kui tegemist on hierarhilise hindamise peamise hindamisega, siis kontrollib süsteem, kas nõutud hulk alahindamisi on tehtud.
    3. Süsteem kuvab kasutajale enesehindamise kinnitamise vaate.
    4. Kasutaja kinnitab enesehindamise.
      1. Kasutaja saab ka loobuda hindamisplaani kinnitamisest. Kui kasutaja keeldub, siis suletakse modaal ja kuvatakse hindamisplaan.
    5. Süsteem käivitab enesehindamise kinnitamiseks päringu GS: Assessment: API: PATCH /quality-api/assessments/{id}/phases/{phaseId}/confirmation-time. Sisend:
    6. Kui tegemist on hindamise alahindamisega, siis: 
    7. Süsteem kuvab kasutajale teate enesehindamise kinnitamise kohta.
Enesehindamise jalus → Edasi vormile "{etapi nimetus}"Võimalus avada välishindamise vorm.
  • Kui tegemist on hindamise alahindamisega, siis sektsiooni ei kuvata.
  • Nupp on kuvatud, kui enesehindamine on kinnitatud ja kasutajal on välishindamise haldamise või vaatamise õigus hindamisega seotud asutuse juures ja hindamisel on välishindamise etapp. Kui kõik tingimused ei ole täidetud, siis nuppu ei kuva.
    • Õigused:
      • Kasutajal peab olema hindamisega seotud asutuse juures ASSESSMENT_EXTERNAL_ASSESSMENT_VIEW_PRIVILEGE või ASSESSMENT_EXTERNAL_ASSESSMENT_MANAGE_PRIVILEGE õigus.
      • Kui tegemist on asutusepõhise hindamisega (GS: Assessment: API: GET /quality-api/assessments/{id}.response.assessmentScope = INSTITUTIONAL):
      • Kui tegemist on isikupõhise hindamisega (GS: Assessment: API: GET /quality-api/assessments/{id}.response.assessmentScope = INDIVIDUAL):
      • Kui kasutaja on hindamise meeskonna liige (Kehtib asutusepõhistel ja isikupõhistel hindamistel).
        • Kasutajal peab olema hindamise valdkonnaga seotud välishindamise andmete vaatamise või muutmise õigus töödeldava hindamisega seoses ja kasutaja peab olema seotud hindamisega. 
            • GS: Assessment: API: GET /quality-api/assessments/{id}/team-members.response.teamMembers.personalCode = Päringu käivitanud isiku isikukood.
            • AssessmentTeamMember.objectStatus = CURRENT
            • Classifier.classifierItemCode = Assessment.domain
            • Classifier.classifierAttributeDefinitionCode = ASSESSMENT_SELF_ASSESSMENT_VIEW_PRIVILEGE või ASSESSMENT_SELF_ASSESSMENT_MANAGE_PRIVILEGE
            • Classifier.attributeValue = Kasutaja poolt valitud rolli privileegide hulgas olev privileeg.
    • Kinnitatud enesehindamine:
  • Nupp on kuvatud, kui enesehindamine on kinnitatud ja kasutajal on ensesehindamise haldamise või vaatamise õigus hindamisega seotud asutuse juures ja välishindamine on kinnitatud ja hindamisel on välishindamise etapp.
  • {etapi nimetus} = Välishindamine
  • Nupule vajutamine avab välishindamise vormi.
Enesehindamise jalus → Edasi vormile "{etapi nimetus}"Võimalus liikuda hindamise tulemuste vormile.
Enesehindamise jalus → Kinnitamata alahindamiste modaalKinnitamata alahindamiste modaal

Enesehindamise jalus → Kinnitamata alahindamiste modaal → Vastajate grupp

Vastajate grupi nimetus ja täitmise ikoon, nõutud isikute arv ja vastanud isikute arv.

Enesehindamise jalus → Kinnitamata alahindamiste modaal → SulgeModaali sulgemine
  • Nupule vajutamine sulgeb modaali ja kuvab kasutajale enesehindamise vormi.