NSILM

Sisukord

Üldkirjeldus

Kasutajal on võimalik muuta hindamise komponendi vormielemendi või aruande seadistusi.

NSIL-331 - Getting issue details... STATUS NSIL-367 - Getting issue details... STATUS NSIL-606 - Getting issue details... STATUS

Kasutajaliides

Jäljerida

Avaleht → Hindamismudelid → Hindamismudel

Disainid

Vormielemendi muutmine kui sisendi formaat "mitmikvalik" ja hindamismudel on staatuses "Mustand" või "Kinnitatud": https://www.figma.com/file/C2WEcl6vxM34BNvy0VQCel/NAPO?type=design&node-id=1770-8034&mode=design&t=3KinDqU3ZUVDZ4C0-4

Vormielemendi muutmine kui sisendi formaat "mitmikvalik" hindamismudel on staatuses "Kehtiv": https://www.figma.com/file/mPPdrh04luwBeiX856NQPP/NAPO-TWN?type=design&node-id=6625-44720&mode=design&t=IcvRsd6M41S2X1Sb-0

Vormielemendi muutmine kui sisendi formaat "osakaal" ja hindamismudel on staatuses "Mustand" või "Kinnitatud": https://www.figma.com/file/C2WEcl6vxM34BNvy0VQCel/NAPO?type=design&node-id=2201-9997&mode=design&t=3KinDqU3ZUVDZ4C0-4

Vormielemendi muutmine kui sisendi formaat "skaala" ja hindamismudel on staatuses "Mustand" või "Kinnitatud": https://www.figma.com/file/C2WEcl6vxM34BNvy0VQCel/NAPO?type=design&node-id=2201-10216&mode=design&t=3KinDqU3ZUVDZ4C0-4

Aruande muutmine kui hindamismudel on staatuses "Mustand" või "Kinnitatud": https://www.figma.com/file/C2WEcl6vxM34BNvy0VQCel/NAPO?type=design&node-id=1785-7163&mode=design&t=3KinDqU3ZUVDZ4C0-4

Aruande muutmine kui hindamismudel on staatuses "Kehtiv": https://www.figma.com/file/C2WEcl6vxM34BNvy0VQCel/NAPO?type=design&node-id=1835-7247&mode=design&t=3KinDqU3ZUVDZ4C0-4

Eeltingimused

  1. Kasutaja on sisse loginud,
  2.  Hindamismudeli äriline staatus on "Mustand" või "Kinnitatud" või "Kehtiv" ja kasutajal on hindamismudeli haldamise õigus. 

Funktsionaalsus

Selgitused

  1. Kasutaja avab vormielemendi või aurande muutmise vaate.
  2. Süsteem käivitab sisendi formaatide nimekirja saamiseks päringu GET ClassifierItems. Sisend:
    • classifierDefinitionCode = INPUT_TYPE
  3. Süsteem käivitab elementide tüüpide nimekirja saamiseks päringu GET ClassifierItems. Sisend:
  4. Süsteem käivitab hindamismudeli andmete saamiseks päringu GS: AssessmentModel: API: GET /quality-api/assessment-models/{id}. Sisend:
    • id = Avatud hindamismudeli id.
  5. Süsteem käivitab hindamise etappide nimetuste aliaste saamiseks päringu GS: AssessmentModel: API: GET /quality-api/assessment-models/{modelId}/aliases. Sisend:
    • modelId = avatud hindamismudeli id.
  6. Süsteem käivitab iga lisatud pildi pisipildi kuvamiseks päringu GS: AssessmentModel: API: GET /quality-api/assessment-models/{assessmentModelId}/assessment-component/elements/{elementId}/files/{fileId}/download. Sisend:
  7. Süsteem kuvab vormielemendi või aruande muutmise vaate.

Andmed

Elemendi nimetus

Selgitus

Tehniline info

Elemendi tüüp

Elemendi tüüp

Järgneb komponendile/elemendile

Määrab, millisele elemendile või sektsioonile element järgneb

Silt

Vormielemendi silt.

Silt  → Näita silti hindamise vormil

Võimalus määrata, kas silti näidatakse hindamise vormil või mitte.

  • Lubatud alati muuta.
  • Lubatud väärtused: 
    • true
    • false
Selgitus

Vormielemendi selgitus/abitekst.

Elemendi vorm

Nimekiri vormidest, kus elementi kuvatakse.

Sisendi formaat

Vormielemendi sisendi formaat

  • Rippmenüü.
  • Kui kasutaja lisab elemendi tüüpi "Kasutaja sisend", siis kuvatakse nimekirjas klassifikaatori INPUT_TYPE elemente, mille ADMIN_CONTEXT (attributeDefinitionCode) = ASSESSMENT (attributeDefinitionValue) ja CONTENT_TYPE = USER_INPUT.
  • Kui kasutaja lisab elemendi tüüpi "Mudeli haldaja sisend", siis kuvatakse nimekirjas klassifikaatori INPUT_TYPE elemente, mille ADMIN_CONTEXT (attributeDefinitionCode) = ASSESSMENT (attributeDefinitionValue) ja CONTENT_TYPE = ADMIN_INPUT.
  • Saab teha ühe valiku.
  • Kohustuslik.
  • Kuvatakse klassifikaatori INPUT_TYPE elemendid klassifikaatori sisese järjestuse järgi.
  • Kui sisendi formaat on tekstiala, arv või veebileht, siis lisavälju ei kuvata.
  • Kui elemendi tüüp on "Kasutaja sisend" ja sisendi formaat on mitmikvalik, üksikvalik, osakaal või skaala, siis kuvatakse iga sisendi spetsiifilised andmeväljad peale andmevälju "Täitmine kohustuslik" ja "On tulemusindikaator". Kui elemendi tüüp on "Kasutaja sisend" ja sisendi formaat ei ole eelpool nimetatute hulgas, siis spetsiifilisi andmevälju peale andmevälju "Täitmine kohustuslik" ja "On tulemusindikaator" ei kuvata. 
  • Kui elemendi tüüp on "Mudeli haldaja sisend", siis kuvatakse iga sisendi spetsiifilised andmeväljad peale andmevälja "Sisendi formaat".
  • Vaikimisi väärtus GS: AssessmentModel: API: GET /quality-api/assessment-models/{assessmentModelId}/assessment-component/elements.response.inputType
  • Kasutaja saab väärtust muuta, kui hindamismudeli staatus on "Mustand" või "Kinnitatud". Muudel juhtudel kuvatakse väärtus.
Täitmine kohustuslik

Näitab, kas vormielemendi täitmine on kohustuslik või mitte.

On tulemusindikaator

Näitab, kas vormielemendi väärtused sünkroniseeritakse andmelattu või mitte.

Vastusevariandid

Vastusevariantide nimistus kuvatakse vastusevariantide tekstide loetelu.

  • Kuvatakse kui elemendi tüüp on "Kasutaja sisend" ja "Sisendi formaat" väärtuseks on "mitmikvalik" või "üksikvalik".
  • Kasutaja saab lisada ja kustutada vastusevariante.
  • Variandi pikkus peab olema 3 - 250 tähemärki.
  • Vähemalt üks vairant peab olema lisatud, kui sisendi formaat on mitmikvalik või üksikvalik.
  • Vaikimisi väärtus GS: AssessmentModel: API: GET /quality-api/assessment-models/{assessmentModelId}/assessment-component/elements.response.optionTexts
  • Kasutaja saab väärtust muuta, kui hindamismudeli staatus on "Mustand" või "Kinnitatud". Muudel juhtudel kuvatakse väärtus.
Sihttase

Sihttase.

Skaala → Alates

Skaala alates.

  • Kuvatakse kui elemendi tüüp on "Kasutaja sisend" ja "Sisendi formaat" väärtuseks on "Skaala".
  • Nimekirjas kuvatakse väärtused 0-10. Mõlemad väärtused on kaasaarvatud.
  • Alates peab olema väiksem või võrdne kuni väärtusega.
  • Kohustuslik ja lubatud valida üks väärtus kui "Sisendi formaat" väärtuseks on "Skaala".
  • Vaikimisi väärtus GS: AssessmentModel: API: GET /quality-api/assessment-models/{assessmentModelId}/assessment-component/elements.response.scale.valuesFrom
  • Kasutaja saab väärtust muuta, kui hindamismudeli staatus on "Mustand" või "Kinnitatud". Muudel juhtudel kuvatakse väärtus.
Skaala → Kuni

Skaala kuni.

  • Kuvatakse kui elemendi tüüp on "Kasutaja sisend" ja "Sisendi formaat" väärtuseks on "Skaala".
  • Nimekirjas kuvatakse väärtused 0-10. Mõlemad väärtused on kaasaarvatud.
  • Alates peab olema väiksem või võrdne kuni väärtusega.
  • Kohustuslik ja lubatud valida üks väärtus kui "Sisendi formaat" väärtuseks on "Skaala".
  • Vaikimisi väärtus GS: AssessmentModel: API: GET /quality-api/assessment-models/{assessmentModelId}/assessment-component/elements.response.scale.valuesUntil
  • Kasutaja saab väärtust muuta, kui hindamismudeli staatus on "Mustand" või "Kinnitatud". Muudel juhtudel kuvatakse väärtus.
Skaala → Skaala väärtused

Skaala väärtused

  • Kuvatakse kui elemendi tüüp on "Kasutaja sisend" ja "Sisendi formaat" väärtuseks on "Skaala" ja skaala alates ning kuni on määratud.
  • Nimekirjas kuvatakse kõik väärtused, mis jäävad skaala alguse ja lõpu vahele. Skaala algus ja lõpp on kaasaarvatud.
  • Kui kasutaja muudab skaala alates või kuni väärtust, siis kuvab süsteem lisandunud skaala elementide väärtused. Kui kasutaja muutis skaalat lühemaks, siis eemaldatakse skaala elemendid, mis vahemiku ei kuulu. Skaala väärtuste muutmine kustutab ka skaala väärtuse selgituse.
  • Vaikimisi väärtus GS: AssessmentModel: API: GET /quality-api/assessment-models/{assessmentModelId}/assessment-component/elements.response.scale.values.value
  • Kasutaja saab väärtust muuta, kui hindamismudeli staatus on "Mustand" või "Kinnitatud". Muudel juhtudel kuvatakse väärtus.
Skaala → Skaala väärtused → Skaala väärtuste selgitused

Skaala väärtuste selgitused.

Tööruumi idTööruumi id
Aruande idAruande id
Teksti sisend

Mudeli haldaja poolt kirjutatud tekst.

  • Andmeväli on kuvatud, kui elemendi tüüp on "Mudeli haldaja sisend" ja sisendi formaat on "Tekstiala".
  • Kohustuslik sisestada 3-2500 tähemärki.
  • Vaikimis väärtus: GS: AssessmentModel: API: GET /quality-api/assessment-models/{assessmentModelId}/assessment-component/elements.response.textAreaValue
  • Kasutaja saab väärtust muuta, kui hindamismudeli staatus on "Mustand" või "Kinnitatud". Muudel juhtudel kuvatakse väärtus.
  • Vabatekstivälja saab kasutaja lisada väärtust WYSIWYG editoris.
  • WYSIWYG editoris saab kasutaja:
    • sisestada teksti.
    • muuta teksti osasid boldiks (b).
    • muuta teksti osasid kaldkirja (i).
    • allajoonida teksti osasid (i).
    • luua järjestatud nimekirju (ol).
    • luua bullet nimekirju (ul)
    • lisada veebilehe linke teksti.
    • lisada tabeleid (kuni 7 veergu, ridade arv ei ole piiratud). Kasutaja saab lisada mitu rida ja veergu, muuta veergude sisu ja pealkirju, kustutada ja lisada veerge ja pealkirju.
  • Tekstivälja kuvamisel rakendatakse WYSIWYG editoris määratud stiile. Lisatud veebilehe lingid avanevad brauseri uues tabis.
Veebilehe link

Mudeli haldaja poolt lisatud veebilingid.

  • Andmeväli on kuvatud, kui elemendi tüüp on "Mudeli haldaja sisend" ja sisendi formaat on "Veebilink".
  • Vähemalt ühe lingi lisamine on kohustuslik.
  • Kasutaja saab lisada ja kustutada veebilinke.
  • Kasutaja saab lisada iga veebilingi kohta järgnevad andmed:
    • Lingi nimetus
      • Kohustuslik.
      • Peab olema 3-250 tähemärki pikk.
    • Lingi URL
      • Kohustuslik.
      • Peab vastama veebilehe lingi nõuetele.
  • Kui kasutaja lisab veebilingi, siis kuvatakse kasutajale lingi nimetus, millele vajutades avatakse veebilehitseja uues sakis lisatud link.
  • Vaikimis väärtused: GS: AssessmentModel: API: GET /quality-api/assessment-models/{assessmentModelId}/assessment-component/elements.response.hyperlinks.name + hyperlinks.url
  • Kasutaja saab väärtust muuta, kui hindamismudeli staatus on "Mustand" või "Kinnitatud". Muudel juhtudel kuvatakse väärtus.
Pilt

Mudelihaldaja saab lisada pilte.

Näidisfail/Fail

Võimalus lisada faili või näidisfaili

Tabeli veerud (kuni 7 veergu)

Nimekiri tabeli veergudest.

Sektsioon on kuvatud, kui elemendi tüüp on "Kasutaja sisend" ja sisendi formaat on "Tabel".

Tabeli veerud (kuni 7 veergu) → Veeru nimetused

Veeru nimetus.

Tabeli veerud (kuni 7 veergu) → Täitmine kohustuslik

Võimalus määrata, kas veeru täitmine on hindamises kohustuslik või mitte.

Tabeli veerud (kuni 7 veergu) → Kustutamine

Võimalus kustutada veergu.

  • Kasutaja saab veerge eemaldada üksikul või kõik veerud korraga. 
  • Kustutamise nupud on kuvatud kui hindamismudeli äriline staatus on "Mustand" või "Kinnitatud" ja kasutajal on hindamismudeli haldamise õigus. Muudel juhtudel nuppe ei kuvata.. 
Tabeli veerud (kuni 7 veergu) → Tabeli veeru lisamine

Tabeli veeru nimetus.

  • Vähemalt ühe veeru lisamine on kohustuslik.
  • Saab lisada kuni 7 veergu. Kui 7 veergu on lisatud, siis sisestusvälja labelit, sisestusvälja ja "Lisa" nuppu ei kuvata. 
  • Peab sisestama vähemalt ühe tähemärgi.
  • Uue veeru lisamisel lisatakse veerud nimekirja lõppu.
  • Lisamise funktsionaalsus on kuvatud kui hindamismudeli äriline staatus on "Mustand" või "Kinnitatud" ja kasutajal on hindamismudeli haldamise õigus. Muudel juhtudel lisamise plokki ei kuvata. 
Nupud

Nupud

Nupud on kuvatud nii kasutaja sisendi kui ka PBI aruande korral ning käituvad sama loogika alusel.
Katkesta

Võimalus katkestada vormielemendi või aruande lisamine.

Nupule vajutamine sulgeb vormi ja avab GS: UC: Hindamismudelite haldus: Hindamise komponentide seadistuste vaatamine

Salvesta

Võimalus salvestada vormielemendi või aurande andmed.

Kui kasutaja vajutab nupule siis:

  1. Süsteem kontrollib, kas andmed on nõuetekohaselt sisestatud.
    1. Kui andmed ei ole nõuetekohaselt sisestatud, siis kuvab süsteem kasutajale vastava teate.
  2. Kui elemendi tüüp oli enne vormi avamist midagi muud kui pilt või fail ja uus elemendi tüüp on pilt või fail, siis:
    1. Süsteem muudab elemendi tüübi pildiks või failiks.
      1. Süsteem käivitab päringu GS: AssessmentModel: API: PUT /quality-api/assessment-models/{assessmentModelId}/assessment-component/elements/{elementId} elemendi tüübi muutmiseks. Sisend:
        • modelId = Avatud hindamismudeli id.
        • sectionId = Vormi sektsioon, mille vormielementi muudetakse.
        • elementId = Avatud vormielement
        • contentType = Elemendi tüüp
        • label = Silt
        • helpText = Selgitus
        • inputType = Sisendi formaat
        • mandatory = Täitmine kohustuslik
          • Kui "Täitmine kohustuslik" märkeruut valimata = false
          • Kui "Täitmine kohustuslik" märkeruut valitud = true
      2. . Süsteem jätkab voogu sammust 3.
  3. Kui kasutaja lisas vormile pilte või faile, siis:
    1. Süsteem käivitab iga lisatud pildi või faili salvestamiseks päringu GS: AssessmentModel: API: POST /quality-api/assessment-models/{assessmentModelId}/assessment-component/elements/{elementId}/files. Sisend:
      • assessmentModelId = Avatud hindamismudeli id.
      • elementId = Avatud elemendi id.
      • file = Pilt või fail
      • fileModifiedAt = Faili viimane muutmise aeg faili metaandmetest. Tegemist on failisüsteemis viimase muutmise ajaga, mitte upload ajaga.  
    2. Kui mõni pilt või fail on viirusega nakatunud, siis:
      1. Süsteem käivitab iga edukalt lisatud pildi või faili kustutamiseks päringu GS: AssessmentModel: API: DELETE /quality-api/assessment-models/{assessmentModelId}/assessment-component/elements/{elementId}/files/{fileId}. Sisend:
      2. Süsteem kuvab kasutajale teate viirusega nakatunud pildi või faili kohta.
      3. Uuesti salvestamisel algab salvestuse protsess uuesti ja kõik andmed, sh failid salvestatakse uuesti.
    3. Kui pildid või failid on korrektsed ja ilma viiruseta ja kasutaja eemaldas vormilt pilte või faile, siis käivitab süsteem piltide ja failide kustutamiseks päringu GS: AssessmentModel: API: DELETE /quality-api/assessment-models/{assessmentModelId}/assessment-component/elements/{elementId}/files/{fileId}. Sisend:
      • assessmentModelId = Avatud hindamismudeli id.
      • elementId = Avatud elemendi id
      • fileId = Kustutatud faili id.
    4. Eelnevalt vormielemendile lisatud faile uuesti ei lisata.
  4. Süsteem käivitab andmete salvestamiseks GS: AssessmentModel: API: PUT /quality-api/assessment-models/{assessmentModelId}/assessment-component/elements/{elementId}. Sisend:
    • modelId = Avatud hindamismudeli id.
    • elementId = Elemendi id.
    • previousComponent.id = Valitud "Järgneb komponendile/elemendile" väärtuse id
    • previousComponent.type =
      • Sektsioon: SECTION
      • Element: ELEMENT
      • Kui "On esimene", siis null.
    • contentType = Elemendi tüüp
    • label = Silt
    • helpText = Selgitus
    • pbiMetadata.workspaceId = Tööruumi id
    • pbiMetadata.reportId = Aruande id
    • phaseTypes = Elemendi vorm
    • inputType = Sisendi formaat
    • mandatory = Täitmine kohustuslik
      • Kui "Täitmine kohustuslik" märkeruut valimata = false
      • Kui "Täitmine kohustuslik" märkeruut valitud = true
    • synchronizedToDwh = On tulemusindikaator
      • Kui "On tulemusindikaato" märkeruut valimata = false
      • Kui "On tulemusindikaato" märkeruut valitud = true
    • optionTexts = Vastusevariandid
    • percentageTargetLevel = Sihttase
    • scale.valuesFrom = Skaala → Alates
    • scale.valuesUntil = Skaala → Kuni
    • scale.values.value = Skaala → Skaala väärtused (Kõik skaala väärtused)
    • scale.values.valueText = Skaala → Skaala väärtused → Skaala väärtuste selgitused
    • hyperlinks.name = Veebilehe link
    • hyperlinks.url = Veebilehe link
    • textAreaValue = Teksti sisend
    • files.fileId = Faili id
    • files.title = Pilt → Pealkiri
    • columns.title = Tabeli veerud (kuni 7 veergu) → Veeru nimetused
    • columns.mandatory = Tabeli veerud (kuni 7 veergu) → Täitmine kohustuslik
  5. Süsteem kuvab GS: UC: Hindamismudelite haldus: Hindamise komponentide seadistuste vaatamine koos muudetud andmetega.
  6. Süsteem kuvab teate andmete muutmise kohta.