GS: UC: Juhtimislaudade haldus: Juhtimislaua jagamine

Sisukord

Üldkirjeldus

Kasutajal on võimalik näha ja muuta juhtimislaua jagamise andmeid ning muuta juhtimislaud avalikuks ja mitteavalikuks.

NSIL-495 - Getting issue details... STATUS NSIL-496 - Getting issue details... STATUS NSIL-497 - Getting issue details... STATUS NSIL-1142 - Getting issue details... STATUS NSIL-1251 - Getting issue details... STATUS

Kasutajaliides

Jäljerida

Avaleht → Juhtimislauad → Juhtimislaud

Disainid

Juhtimislaua jagamise andmete vaatamine: https://www.figma.com/file/C2WEcl6vxM34BNvy0VQCel/NAPO?type=design&node-id=6724-15782&mode=design&t=yOmt9aQmePq5ufTY-4
Juhtimislaua jagamise andmete lisamine/muutmine, kui staatuseks on "Mustand": https://www.figma.com/design/C2WEcl6vxM34BNvy0VQCel/NAPO?node-id=5223-15052&t=4ofzK96kqnWkCglk-4
Juhtimislaua jagamise andmete lisamine/muutmine, kui staatuseks on "Avalikustatud": https://www.figma.com/design/C2WEcl6vxM34BNvy0VQCel/NAPO?node-id=5312-14935&t=4ofzK96kqnWkCglk-4
Juhtimislaua jagamise andmete lisamine/muutmine, kui staatuseks on "Avalikustamata": https://www.figma.com/design/C2WEcl6vxM34BNvy0VQCel/NAPO?node-id=5312-15181&t=4ofzK96kqnWkCglk-4
Õppeasutuste liikide valimine: https://www.figma.com/design/mPPdrh04luwBeiX856NQPP/NAPO---TWN?node-id=8014-37771&t=oDykr7ybpkIxPotH-4
https://www.figma.com/design/mPPdrh04luwBeiX856NQPP/NAPO---TWN?node-id=12112-63534&t=IpB1xqfirxHUtOk9-0
Pidajale avaldamine: https://www.figma.com/design/mPPdrh04luwBeiX856NQPP/NAPO---TWN?node-id=12107-53967&t=kIZVeYgbMoQzypZA-4
HTM struktuur: https://www.figma.com/design/mPPdrh04luwBeiX856NQPP/NAPO---TWN?node-id=13734-54567&t=kIZVeYgbMoQzypZA-4

Eeltingimused ja õigused

Kasutaja on sisse loginud,
Kasutajal on ükskõik millise juhtimislaua valdkonna haldamise õigus.
- Kasutajal on olemas privileeg, mille ClassifierItems.response.attributeDefinitionValue = kasutaja privileegide hulgas olev privileeg, mille attributeDefinitionCode = DASHBOARD_MANAGE_PRIVILEGE, classifierDefinitionCode = DOMAIN
- Kasutajal puudub privileeg, mille attributeDefinitionCode = DASHBOARD_MANAGE_PRIVILEGE, classifierDefinitionCode = DOMAIN ja ClassifierItem.code = GS: DashboardDefinition: API: GET /quality-api/dashboard-definitions/{dashboardDefinitionId}.response.domainType
Juhtimislaud on loodud.

Funktsionaalsus

Tegevused

Kasutaja avab juhtimislaua jagamise vaate.
Süsteem käivitab juhtimislaua detailandmete saamiseks päringu GS: DashboardDefinition: API: GET /quality-api/dashboard-definitions/{dashboardDefinitionId}. Sisend:
- dashboardDefinitionId = Avatud juhtimislaua id.
Süsteem käivitab päringu GET ClassifierItems asutuste liikide nimekirja saamiseks. Sisend:
- classifierDefinitionCode = INSTITUTION_TYPE
Süsteem käivitab päringu GET ClassifierItems õppeasutuste liikide saamiseks. Sisend:
- classifierDefinitionCode = OPPEASUTUSE_TYYP
Süsteem käivitab õppeasutuste nimekirja saamiseks päringu GS: Classifiers: API: GET /hsilm-gateway/ehis/institutions. Sisendparameetreid ei ole.
Süsteem käivitab HTM stuktuuri saamiseks päringu GET hsilm-gateway/v1/htm-institution-structure. Sisendparameetreid ei ole.
Süsteem kuvab juhtimislaua jagamise vaate.

Andmed

Elemendi nimetus	Selgitus	Tehniline info
Päis	Lehe päis.
Päis → Juhtimislaua nimetus	Juhtimislaua nimetus	GS: DashboardDefinition: API: GET /quality-api/dashboard-definitions/{dashboardDefinitionId}.response.name
Sakid	Lehe sakid.
Sakid → Juhtimislaua komponendid	Juhtimislaua komponentide sakk.	Sakile vajutades avaneb juhtimislaua detailandmete vaade. GS: UC: Juhtimislaudade haldus: Juhtimislaua üldandmete kuvamine
Sakid → Jagamine	Juhtimislaua jagamise sakk.	Avatud sakk.
Jagamine	Jagamise andmestik
Jagamine → Avatud kasutamiseks	Asutuse tüüp, millele on juhtimislaud kasutamiseks on avaldatud.	Asutusepõhised valikud (Haridus- ja Teadusministeerium, Kohalikud omavalitsused, Õppeasutustele, Kindlatele asutustele) on vormil kuvatud checkboxidena. Väärtused: Kohalikud omavalitsused = LOCAL_GOVERNMENT Õppeasutustele = EDUCATIONAL_INSTITUTION Haridus- ja Teadusministeerium = HTM Kindlatele asutustele = null Haridus- ja Teadusministeeriumi struktuuriüksus = null Märgitud on väärtused, mis on enne vormi avamist valitud GS: DashboardDefinition: API: GET /quality-api/dashboard-definitions/{dashboardDefinitionId}.response.institutions.institutionType Kindlatele asutustele on märgitud, kui vähemalt üks asutus on lisatud GS: DashboardDefinition: API: GET /quality-api/dashboard-definitions/{dashboardDefinitionId}.response.institutions.institutionIds != null Kasutaja saab andmeid muuta, kui tal on olemas avatud juhtimislaua valdkonna andmete muutmise õigus. Kui kasutajal puudub avatud juhtimislaua valdkonna haldamise õigus, siis kuvatakse andmed mittemuudetavana. Õigused: ClassifierItems.response.attributeDefinitionValue = kasutaja privileegide hulgas olev privileeg, mille attributeDefinitionCode = DASHBOARD_MANAGE_PRIVILEGE, classifierDefinitionCode = DOMAIN ja ClassifierItem.code = GS: DashboardDefinition: API: GET /quality-api/dashboard-definitions/{dashboardDefinitionId}.response.domainType Muutmisel saab kasutaja valida mitu asutuse liiki. Kindlale asutusele valiku saab teha ka ilma teisi valikuid tegemata.
Jagamine → Täpsusta struktuuriüksus	Võimalus valida ja otsida HTM struktuuriüksuseid.	HTM struktuuriüksuseid kuvatakse, kui avatud kasutamiseks valikus on tehtud valik "Haridus- ja Teadusministeeriumi struktuuriüksus" või kui vähemalt üks struktuuriüksus on enne vormi avamist valitud. Nimekirjas kuvatakse HTM struktuuriüksused. Üksused on järjestatud nimetuse järgi kasvavas järjekorras. GET hsilm-gateway/v1/htm-institution-structure.response.name Nimekiri on mitmetasemeline puu HTM struktuuriüksustest. Alamad on seotud ülem üksustega läbi GET hsilm-gateway/v1/htm-institution-structure.response.parentId = id Vaikimisi on valitud struktuuriüksused, mis on enne vormi avamist valitud. GS: DashboardDefinition: API: GET /quality-api/dashboard-definitions/{dashboardDefinitionId}.response.htmStructureUnits Kasutaja saab otsida struktuuriüksuseid otsinguga või teha valiku struktuuriüksuste puust. Otsing teostatakse sõnaosa järgi. Kasutaja saab valida korraga mitu üksust. Ülemelemendi valimisel valitakse automaatselt kõik alamelemendid. Kõik valitud elemendid, sh ülemtaseme elemendid, millel on alamad lisatakse valides loendisse. Valikud kuvatakse siltidena valitud üksuste loendis. Siltidena kuvatakse kõik valitud elemendid, sh ülemad ja alamad. Valides "Kõik struktuuriüksused" valitakse kõik üksused. Kõik valitud elemendid, sh ülemtaseme elemendid, millel on alamad lisatakse valides loendisse. Väärtused kuvatakse klassifikaatori sisese järjestuse järgi. Kohustuslik vähemalt üks, kui avatud kasutamiseks valikust on valitud "Haridus- ja Teadusministeeriumi struktuuriüksus". Kasutaja saab andmeid muuta, kui tal on olemas avatud juhtimislaua valdkonna andmete muutmise õigus. Kui kasutajal puudub avatud juhtimislaua valdkonna haldamise õigus, siis kuvatakse andmed mittemuudetavana. Õigused: ClassifierItems.response.attributeDefinitionValue = kasutaja privileegide hulgas olev privileeg, mille attributeDefinitionCode = DASHBOARD_MANAGE_PRIVILEGE, classifierDefinitionCode = DOMAIN ja ClassifierItem.code = GS: DashboardDefinition: API: GET /quality-api/dashboard-definitions/{dashboardDefinitionId}.response.domainType
Jagamine → Täpsusta õppeasutuste liigid	Õppeasutuste liigid	Õppeasutuste liike kuvatakse, kui avatud kasutamiseks valikus on tehtud valik "Õppeasutusele". Märgitud on valikud, mis on enne vormi avamist valitud: GS: DashboardDefinition: API: GET /quality-api/dashboard-definitions/{dashboardDefinitionId}.response.institutions.specificationTypes Kasutaja saab otsida õppeasutuse liike otsinguga või teha valiku õppeasutuste puust. Otsing teostatakse sõnaosa järgi. Mitmetasemeline puu asutuse liikidest (hierarhilise klassifikaatori OPPEASUTUSE_TYYP elemendid) kuvatakse, kui asutuse liikide loetelus on valitud "Õppeasutus". Korraga saab teha mitu valikut. Ülemelemendi valimisel valitakse automaatselt kõik alamelemendid. Väärtused, millel on alamelemendid, loendisse ei lisata. Nt kui kasutaja valib 'huvikool', siis märgitakse valikuteks alamelemendid 'muusika- ja kunstikool', 'spordikool', 'tehnika-, loodus-, loome- ja huvimaja või -keskused' ja 'muu huvikool', kuid kasutajal peab olema võimalik valida ka ainult 'spordikool'. Ülemelement 'huvikool' ei lisandu valitud liikide nimekirja. See on koondliik, mis võimaldab valida mitu elementi korraga, kuid 'huvikool' ise ei sisalda ühtegi asutust. Valikud kuvatakse siltidena valitud liikide sektsioonis. Siltidena kuvatakse hierarhilistel elementidel ainult alamelemendid. Nt kui kasutaja valib 'spordikool', siis selle ülemelementi 'huvikool' siltide all ei kuvata. Valides "Kõik õppeasutuste liigid" valitakse kõik õppeasutuse liigid. Väärtused, millel on alamelemendid, loendisse ei lisata. Väärtused kuvatakse klassifikaatori sisese järjestuse järgi. Kohustuslik vähemalt üks, kui asutuse liikide loetelus on valitud "Õppeasutus". Kasutaja saab andmeid muuta, kui tal on olemas avatud juhtimislaua valdkonna andmete muutmise õigus. Kui kasutajal puudub avatud juhtimislaua valdkonna haldamise õigus, siis kuvatakse andmed mittemuudetavana. Õigused: ClassifierItems.response.attributeDefinitionValue = kasutaja privileegide hulgas olev privileeg, mille attributeDefinitionCode = DASHBOARD_MANAGE_PRIVILEGE, classifierDefinitionCode = DOMAIN ja ClassifierItem.code = GS: DashboardDefinition: API: GET /quality-api/dashboard-definitions/{dashboardDefinitionId}.response.domainType
Jagamine → Kindlale asutusele	Võimalus avaldada juhtimislaud kindlale õppeasutustele	Kui kasutaja teeb valiku (märgib checkboxi) siis: Süsteem kuvab kasutajale võimaluse sisestada asutuse nimi või registrikood. Kasutaja sisestab asutuse nime või registrikoodi. Süsteem kuvab valikus sisestatud sõnaosa järgi asutuste nimed ja registrikoodid (reg.kood on kuvatud sulgudes). Tulemustes kuvatakse asutusi, mille registrikood või nimi sisaldab sisestatud sõnaosa. Reg.kood: GS: Classifiers: API: GET /hsilm-gateway/ehis/institutions.response.educationalInstitutions.regCode Nimi: GS: Classifiers: API: GET /hsilm-gateway/ehis/institutions.response.educationalInstitutions.name Tulemusi hakatakse kuvama esimese tähemärgi sisestamisest. Tulemused on järjestatud nime järgi kasvavas järjekorras. Kasutaja saab teha otsingust ühe valiku. Mitut asutust saab lisada "Lisa veel" nupu abil, mis lisab uue asutuse otsingu. Kasutaja saab kustutada lisatud asutusi. Kasutaja saab lisada mitut asutust.
Jagamine → Juhtimislaua nähtavus: Õppeasutuse andmed nähtavad pidajale	Võimaldus avaldada juhtimislaud pidajale.	Vaikeväärtus: GS: DashboardDefinition: API: GET /quality-api/dashboard-definitions/{dashboardDefinitionId}.response.visibleToOwner true = checkbox linnutatud. false/null = checkbox linnutamata.
Jagamine → Staatus	Juhtimislaua staatus.	Väärtus: GS: DashboardDefinition: API: GET /quality-api/dashboard-definitions/{dashboardDefinitionId}.response.statusType Väärtust kasutaja muuta ei saa.
Jagamine → Avalikustamise aeg	Juhtimislaua avalikustamise aeg.	Väärtus ja andmevälja silt on kuvatud, kui juhtimislaua avalikustamise aeg on olemas. Muudel juhtudel siliti ja väärtust ei kuvata. GS: DashboardDefinition: API: GET /quality-api/dashboard-definitions/{dashboardDefinitionId}.response.publishedAt != null Väärtuseks kuvatakse juhtimislaua avalikustamise aeg kuupäeva täpsusega. GS: DashboardDefinition: API: GET /quality-api/dashboard-definitions/{dashboardDefinitionId}.response.publishedAt
Nupud	Juhtimislaua jagamise vaate nupud
Nupud → Kustuta juhtimislaud	Võimalus kustutada juhtimislaud.	Nupp on kuvatud kui kasutajal on juhtimislaua valdkonna haldamise õigus. ClassifierItems.response.attributeDefinitionValue = kasutaja privileegide hulgas olev privileeg, mille attributeDefinitionCode = DASHBOARD_MANAGE_PRIVILEGE, classifierDefinitionCode = DOMAIN ja ClassifierItem.code = GS: DashboardDefinition: API: GET /quality-api/dashboard-definitions/{dashboardDefinitionId}.response.domainType Kui kasutaja vajutab nupule siis: Süsteem kuvab kasutajale juhtimislaua kustutamise kinnitamise modaali. Kasutaja kinnitab juhtimislaua kustutamise. Kasutaja saab katkestada juhtimislaua kustutamise. Kui kasutaja katkestab kustutamise, siis sulgeb süsteem modaali ja juhtimislauda ei kustutata. Süsteem käivitab juhtimislaua kustutamiseks päringu GS: DashboardDefinition: API: DELETE /quality-api/dashboard-definitions/{dashboardDefinitionId}. Sisend: dashboardDefinitionId = Avatud juhtimislaua id. Süsteem avab kasutajale juhtimislaudade nimistu. GS: UC: Juhtimislaudade haldus: Juhtimislaudade nimistu vaatamine ja otsing Süsteem kuvab kasutajale teate juhtimislaua kustutamise kohta.
Nupud → Katkesta	Võimalus avada juhtimislaudade nimekiri.	Nupule vajutamine avab GS: UC: Juhtimislaudade haldus: Juhtimislaudade nimistu vaatamine ja otsing vaate.
Nupud → Salvesta	Võimalus salvestada kaastavate gruppide andmed.	Nupp on kuvatud kui kasutajal on juhtimislaua valdkonna haldamise õigus ja juhtimislaua staatus on "Mustand" või "Avalikustamata". Õigused: ClassifierItems.response.attributeDefinitionValue = kasutaja privileegide hulgas olev privileeg, mille attributeDefinitionCode = DASHBOARD_MANAGE_PRIVILEGE, classifierDefinitionCode = DOMAIN ja ClassifierItem.code = GS: DashboardDefinition: API: GET /quality-api/dashboard-definitions/{dashboardDefinitionId}.response.domainType Staatus: GS: DashboardDefinition: API: GET /quality-api/dashboard-definitions/{dashboardDefinitionId}.response.statusType = "Mustand" või "Avalikustamata" Kui kasutaja vajutab nupule siis: Süsteem käivitab juhtimislaua jagamise andmete salvestamiseks päringu GS: DashboardDefinition: API: PUT /dashboard-api/dashboard-definitions/{dashboardDefinitionId}/institutions. Sisend: dashboardDefinitionId = Avatud juhtimislaua id. institutionTypes = Jagamine → Avatud kasutamiseks Kui ühtegi gruppi ei ole lisatud või on valitud "Kindlale asutusele", siis päringus saadetakse väärtus null specificationTypes = Jagamine → Täpsusta õppeasutuste liigid Päringusse lisatakse ainult väärtused, millel puuduvad alamelemendid. institutions.institutionIds = Jagamine → Kindlale asutusele visibleToOwner = Jagamine → Juhtimislaua nähtavus: Õppeasutuse andmed nähtavad pidajale htmStructureUnits = Jagamine → Täpsusta struktuuriüksus Süsteem kuvab kasutajale teate andmete muutmise kohta.
Nupud → Kinnita muudatus	Võimalus salvestada kaastavate gruppide andmed.	Nupp on kuvatud kui kasutajal on juhtimislaua valdkonna haldamise õigus ja juhtimislaua staatus on "Avalikustatud". Õigused: ClassifierItems.response.attributeDefinitionValue = kasutaja privileegide hulgas olev privileeg, mille attributeDefinitionCode = DASHBOARD_MANAGE_PRIVILEGE, classifierDefinitionCode = DOMAIN ja ClassifierItem.code = GS: DashboardDefinition: API: GET /quality-api/dashboard-definitions/{dashboardDefinitionId}.response.domainType Staatus: GS: DashboardDefinition: API: GET /quality-api/dashboard-definitions/{dashboardDefinitionId}.response.statusType = "Avalikustatud" Kui kasutaja vajutab nupule siis: Süsteem käivitab juhtimislaua jagamise andmete salvestamiseks päringu GS: DashboardDefinition: API: PUT /dashboard-api/dashboard-definitions/{dashboardDefinitionId}/institutions. Sisend: dashboardDefinitionId = Avatud juhtimislaua id. institutionTypes = Jagamine → Avatud kasutamiseks Kui ühtegi gruppi ei ole lisatud või on valitud "Kindlale asutusele", siis päringus saadetakse väärtus null specificationTypes = Jagamine → Täpsusta õppeasutuste liigid Päringusse lisatakse ainult väärtused, millel puuduvad alamelemendid. institutions.institutionIds = Jagamine → Kindlale asutusele visibleToOwner = Jagamine → Juhtimislaua nähtavus: Õppeasutuse andmed nähtavad pidajale htmStructureUnits = Jagamine → Täpsusta struktuuriüksus Süsteem kuvab kasutajale teate andmete muutmise kohta.
Nupud → Salvesta ja avalikusta	Võimalus avalikustada juhtimislaud	Nupp on kuvatud kui kasutajal on juhtimislaua valdkonna haldamise õigus ja juhtimislaua staatus on "Mustand" või "Avalikustamata". Õigused: ClassifierItems.response.attributeDefinitionValue = kasutaja privileegide hulgas olev privileeg, mille attributeDefinitionCode = DASHBOARD_MANAGE_PRIVILEGE, classifierDefinitionCode = DOMAIN ja ClassifierItem.code = GS: DashboardDefinition: API: GET /quality-api/dashboard-definitions/{dashboardDefinitionId}.response.domainType Staatus: GS: DashboardDefinition: API: GET /quality-api/dashboard-definitions/{dashboardDefinitionId}.response.statusType = "Mustand" või "Avalikustamata" Kui kasutaja vajutab nupule siis: Süsteem käivitab juhtimislaua jagamise andmete salvestamiseks päringu GS: DashboardDefinition: API: PUT /dashboard-api/dashboard-definitions/{dashboardDefinitionId}/institutions. Sisend: dashboardDefinitionId = Avatud juhtimislaua id. institutionTypes = Jagamine → Avatud kasutamiseks Kui ühtegi gruppi ei ole lisatud või on valitud "Kindlale asutusele", siis päringus saadetakse väärtus null specificationTypes = Jagamine → Täpsusta õppeasutuste liigid Päringusse lisatakse ainult väärtused, millel puuduvad alamelemendid. institutions.institutionIds = Jagamine → Kindlale asutusele visibleToOwner = Jagamine → Juhtimislaua nähtavus: Õppeasutuse andmed nähtavad pidajale htmStructureUnits = Jagamine → Täpsusta struktuuriüksus Süsteem käivitab juhtimislaua avalikustamiseks päringu GS: DashboardDefinition: API: POST /quality-api/dashboard-definitions/{dashboardDefinitionId}/publish. Sisend: dashboardDefinitionId = Avatud juhtimislaua id. Süsteem kuvab kasutajale teate juhtimislaua avalikustamise kohta.
Nupud → Muuda mitte avalikuks	Võimalus muuta juhtimislaud mitte avalikuks	Nupp on kuvatud kui kasutajal on juhtimislaua valdkonna haldamise õigus ja juhtimislaua staatus on "Avalikustatud". Õigused: ClassifierItems.response.attributeDefinitionValue = kasutaja privileegide hulgas olev privileeg, mille attributeDefinitionCode = DASHBOARD_MANAGE_PRIVILEGE, classifierDefinitionCode = DOMAIN ja ClassifierItem.code = GS: DashboardDefinition: API: GET /quality-api/dashboard-definitions/{dashboardDefinitionId}.response.domainType Staatus: GS: DashboardDefinition: API: GET /quality-api/dashboard-definitions/{dashboardDefinitionId}.response.statusType = "Avalikustatud" Kui kasutaja vajutab nupule siis: Süsteem käivitab juhtimislaua jagamise andmete salvestamiseks päringu GS: DashboardDefinition: API: PUT /dashboard-api/dashboard-definitions/{dashboardDefinitionId}/institutions. Sisend: dashboardDefinitionId = Avatud juhtimislaua id. institutionTypes = Jagamine → Avatud kasutamiseks Kui ühtegi gruppi ei ole lisatud või on valitud "Kindlale asutusele", siis päringus saadetakse väärtus null specificationTypes = Jagamine → Täpsusta õppeasutuste liigid Päringusse lisatakse ainult väärtused, millel puuduvad alamelemendid. institutions.institutionIds = Jagamine → Kindlale asutusele visibleToOwner = Jagamine → Juhtimislaua nähtavus: Õppeasutuse andmed nähtavad pidajale htmStructureUnits = Jagamine → Täpsusta struktuuriüksus Süsteem käivitab juhtimislaua mitteavalikuks muutmiseks päringu GS: DashboardDefinition: API: POST /quality-api/dashboard-definitions/{dashboardDefinitionId}/unpublish. Sisend: dashboardDefinitionId = Avatud juhtimislaua id. Süsteem kuvab kasutajale teate juhtimislaua mitteavalikuks muutmise kohta.