GS Juhtimislaua komponendi lisamine/muutmine

Sisukord

Üldkirjeldus

Kasutajal on võimalik lisada ja muuta juhtimislaua komponendi (valdkonna või valdkonna näitaja) seadistusi.

Kasutaja saab juhtimislaua komponendi seadistuste lisamise või muutmise modaalakna avada juhtimislaua komponentide vaatest vastavale nupule vajutades. Juhtimislaua komponendi seadistuste lisamine või muutmine on võimalik kui kasutajal on juhtimislaua valdkonna administreerimise õigus.

Kasutajaliides

Disainid

Uue juhtimislaua komponendi lisamine: https://www.figma.com/file/C2WEcl6vxM34BNvy0VQCel/NAPO?type=design&node-id=5171-24147&mode=design&t=5Wi9LBfA0oy0osab-4
Juhtimislaua komponendi andmete muutmine - vahelehe andmete muutmine: https://www.figma.com/file/C2WEcl6vxM34BNvy0VQCel/NAPO?type=design&node-id=6251-17331&mode=design&t=5Wi9LBfA0oy0osab-4
Juhtimislaua komponendi andmete muutmine - näitaja andmete muutmine: https://www.figma.com/file/C2WEcl6vxM34BNvy0VQCel/NAPO?type=design&node-id=5171-24065&mode=design&t=5Wi9LBfA0oy0osab-4

Eeltingimused

Kasutaja on sisse loginud,
kasutajal on õigus lisada/muuta juhtimislaudu (omab juhtimislaua valdkonnale vastavat kasutusõigust- vt täpsemalt Kasutusõigused).

Funktsionaalsus

Selgitused

Kasutajaliides teeb juhtimislaua komponendi seadistuste vormi eeltäitmiseks päringu: GS API Juhtimislaua komponendi päring
1. Kui andmeelemendile päringu tulemustes ei ole väärtuse vastet, siis vastavat välja sisestusvormil ei kuvata/eeltäideta.
Klassifikaatori ridade tekstide kuvamiseks kasutatakse teenust GET ClassifierItems või GET ClassifierItem.
Juhtimislaua komponendi andmete salvestamiseks kasutatakse päringut: GS API Juhtimislaua komponendi salvestamine

Andmed

Kasutatavad andmeolemid:

Elemendi nimetus	Selgitus/Näide
Id	Juhtimislaua komponendi identifikaator Mittemuudetav
Ülemkomponent	Juhtimislaua komponent, mille alamkomponendiks lisatav/muudetav komponent määratakse. Kui ülemkomponent puudub, siis on lisatav/muudetav komponent kõige ülemise taseme komponent ehk siis juhtimislaua valdkond. Kuvatakse: Rippmenüü: Valikus kõik juhtimislauale seadistatud komponendid v.a. lisatav/muudetav komponent päringuga: GS API Juhtimislaua komponentide päring Iga komponendi kohta kuvatakse rippmenüüs järjekorra number ja nimetus. Korraga saab teha ühe valiku. Väärtused kuvatakse juhtimislaua komponentide järjekorra numbri järjestuses.
Järgneb komponendile	Juhtimislaua komponent, millele lisatava/muudetav komponent järgneb. Kasutatakse juhtimislaua komponendi järjekorra numbri määramiseks ja kuvamise järjekorra seadistamiseks. Kuvatakse rippmenüü: Valikus kõik sama ülemkomponendi alla kuuluvad juhtimislaua komponendid (kui ülemkomponent puudub, siis kõik ülemise taseme komponendid) päringuga: GS API Juhtimislaua komponentide päring Lisaks kuvatakse valik "On esimene". Iga komponendi kohta kuvatakse rippmenüüs järjekorra number ja nimetus. Korraga saab teha ühe valiku. Väärtused kuvatakse juhtimislaua komponentide järjekorra numbri järjestuses. Vaikimisi väärtuseks kuvatakse järjestuses kõige viimast juhtimislaua komponenti. Kohustuslik.
Järgneb komponendile	Andmete päringu reeglid Kasutaja peab olema sisse loginud ja tal peab olema juhtimislaua valdkonna juhtimislaua administreerimise õigus. Juhtimislaua valdkond tuleb seosest juhtimislaua liigiga (vt. täpsemalt DASHBOARD_TYPE) Igal valdkonnal on eraldi administreerimisõigus (vt. täpsemalt Kasutusõigused)
Näitaja nimetus	Juhtimislaua näitaja nimetus. Tekstiala Kohustuslik.
Infotekst	Juhtimislaua komponendi selgitav infotekst. Tekstiala
Vahelehe nimetus	Juhtimislaua komponendile vahelehtede karusellis kuvatav juhtimislaua valdkonna nimetus. Kasutatakse ainult kõige ülemise taseme komponentidel, st. juhul kui komponendil ei ole ülemkomponente. Vabatekstiväli Võib sisestada maksimaalselt 20 tähemärki. Kuvatakse juhul kui "Ülemkomponent" väärtus puudub.
Näitaja filtrid - filtrid, mida rakendatakse kõigile näitaja aruannetele (peidetud lõppkasutajale)
Filter	Näitaja filtri kood. Tekstiala Kohustuslik.
Väärtus	Näitaja filtri väärtus. Tekstiala Kohustuslik.

Andmete salvestamise reeglid

Kasutaja peab olema sisse loginud ja tal peab olema juhtimislaua valdkonna juhtimislaua administreerimise õigus.
- Juhtimislaua valdkond tuleb seosest juhtimislaua liigiga (vt. täpsemalt DASHBOARD_TYPE)
- Igal valdkonnal on eraldi administreerimisõigus (vt. täpsemalt Kasutusõigused)
Kohustuslikud andmed: järgneb komponendile, näitaja nimetus (kui ülemkomponendi väärtus olemas), vahelehe nimetus (kui ülemkomponendi väärtus puudub)
Süsteemi poolt automaatselt lisatavad väärtused:
- juhtimislaua komponendi id - süsteem genereerib unikaalse koodi esmasel salvestamisel
Vahelehe nimetus võib sisaldada maksimaalselt 20 tähemärki.
Järgneb komponendile väärtuse põhjal määratakse järjekorra number väärtuseks sellest ühe võrra suurem ning uuendatakse ka kõigi järgnevate sama ülemkomponendi alla kuuluvate komponentide järjekorra numbrid ühe võrra suuremaks.
- Kui väärtuseks on määratud "On esimene", siis järjestatakse komponent sama ülemkomponendi alla kuuluvate komponentide seas esimeseks.

Kasutaja tegevused

Tegevuse nimetus	Selgitus
Nupu "Lisa filter" vajutamine	Nupule vajutamisel süsteem tekitab tabelisse Näitaja filtrid uue rea muudetavate andmeväljadega filter ja väärtus.
Nupu "Katkesta" ja "X" vajutamine	Nupule vajutamisel sulgeb süsteem juhtimislaua komponendi seadistuste modaalakna. Sisestatud andmeid ei salvestata.
Nupu "Salvesta" vajutamine	Nupule vajutamisel käivitab süsteem juhtimislaua komponendi andmete salvestamise, sulgeb modaalakna ja kuvab uuendatud juhtimislaua komponentide vaate.