GS: UC: Hindamismudelite haldus: Hindamismudeli hindamise planeerimise seadistused: Sektsioonile vormielemendi lisamine

Elemendi tüüp

• Süsteem kuvab elemendi tüübi nimetuse GET ClassifierItems päringu vastusest, kus classifierDefinitionCode = CONTENT_TYPE.
• Väärtused:
  • Kasutaja sisend
  • Mudeli haldaja sisend
• Vaikimisi on valitud "Kasutaja sisend".

Vormielemendi silt.

Kohustuslik sisestada 3 - 250 tähemärki.

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

• Vaikimisi valitud.

Vormielemendi selgitus/abitekst.

• Tekstiala.
• Ei ole kohustuslik.
• Lubatud kuni 2500 tähemärki.

Vormielemendi sisendi formaat

• Rippmenüü.
• Kui kasutaja lisab elemendi tüüpi "Kasutaja sisend", siis kuvatakse nimekirjas klassifikaatori INPUT_TYPE elemente, mille ADMIN_CONTEXT (attributeDefinitionCode) = PLANNING (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) = PLANNING (attributeDefinitionValue) ja CONTENT_TYPE = ADMIN_INPUT.
• Saab teha ühe valiku.
• Kohustuslik.
• Kuvatakse klassifikaatori INPUT_TYPE elemendid klassifikaatori sisese järjestuse järgi.
• Kui elemendi tüüp on "Kasutaja sisend" ja sisendi formaat on mitmikvalik, üksikvalik, osakaal, skaala, fail või tabel, siis kuvatakse iga sisendi spetsiifilised andmeväljad peale andmevälja "Täitmine kohustuslik". 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 ei kuvata. 
• Kui elemendi tüüp on "Mudeli haldaja sisend", siis kuvatakse iga sisendi spetsiifilised andmeväljad peale andmevälja "Sisendi formaat".

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

• Andmeväli on kuvatud, kui elemendi tüüp on "Kasutaja sisend".
• Vaikimisi linnutatud.

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.

Sihttase.

• Kuvatakse kui elemendi tüüp on "Kasutaja sisend" ja "Sisendi formaat" väärtuseks on "Osakaal".
• Lubatud väärtused 0-100.
• Peab olema täisarv.
• Ei ole kohustuslik

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".

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".

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.

Skaala väärtuste selgitused.

• Kuvatakse kui "Sisendi formaat" väärtuseks on elemendi tüüp on "Kasutaja sisend" ja "Skaala" ja skaala alates ning kuni on määratud.
• Ei ole kohustuslik.
• Lubatud kuni 250 tähemärki.

• Andmeväli on kuvatud, kui elemendi tüüp on "Mudeli haldaja sisend" ja sisendi formaat on "PBI aruanne".
• Kohustuslik.
• Peab olema 3-250 tähemärki.

• Andmeväli on kuvatud, kui elemendi tüüp on "Mudeli haldaja sisend" ja sisendi formaat on "PBI aruanne".
• Kohustuslik.
• Peab olema 3-250 tähemärki.

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.
• 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.

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.

Mudelihaldaja saab lisada pilte.

• Andmeväli on kuvatud, kui elemendi tüüp on "Mudeli haldaja sisend" ja sisendi formaat on "Pilt".
• Vähemalt üks pilt peab olema lisatud.
• Kasutaja saab kustutada ja lisada pilte.
• Pildi lisamise järgsel kuvatakse kasutajale pildi pisipilti.
• Pildile saab lisada pealkirja. Kuni 250 tähemärki. Ei ole kohustuslik.
• Kui kasutaja kustutab vormilt pildi, siis pilt kustutatakse süsteemist alles peale vormi salvestamist.
• Kui kasutaja lisab pildi, siis pilt lisatakse süsteemi alles peale vormi salvestamist.
• Pildi nõuded:
  • Lubatud vormingud: 
    • jpg
    • jpeg
    • png
    • svg
    • bmp
  • Faili maksimaalne suurus võib olla kuni 25 MB.

Võimalus lisada faili või näidisfaili

• Andmeväli ja silt "Näidisfail" on kuvatud, kui elemendi tüüp on "Kasutaja sisend" ja sisendi formaat on "Fail".
• Andmeväli ja silt "Fail" on kuvatud, kui elemendi tüüp on "Mudeli haldaja sisend" ja sisendi formaat on "Fail".
• Kui elemendi tüüp on mudeli haldaja sisend, siis on ühe faili lisamine kohustuslik.
• Näidisfailide lisamine ei ole kohustuslik
• Kasutaja saab lisada mitu faili. 
• Lubatud vormingud:
  • docx
  • doc
  • odt
  • ods
  • txt
  • rtf
  • pdf
  • xls
  • xlsx
  • csv
  • asice
  • cdoc
• Faili maksimaalne suurus võib olla kuni 25 MB.
• Faili lisamise järgselt kuvatakse kasutajale faili nime, suurust ja faili viimast muutmise aega sekundi täpsusega. 
  • Kui faili suurus on alla mega, siis on suuruse ühik Kb, kui üle mega, siis on ühik MB.
  • Faili viimane muutmise aeg tuleb lugeda faili metaandmetest. Tegemist on failisüsteemis viimase muutmise ajaga, mitte upload ajaga. 
• Kui kasutaja kustutab vormilt faili, siis fail kustutatakse süsteemist alles peale vormi salvestamist.
• Kui kasutaja lisab faili, siis fail lisatakse süsteemi alles peale vormi salvestamist.
• Kui kasutaja vajutab faili nimele, siis saab kasutaja faili seadmesse salvestada.

Veeru nimetus.

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

Lisamise järgselt vaikimisi linnutamata.

Võimalus kustutada veergu.

Kasutaja saab veerge eemaldada üksikul või kõik veerud korraga. 

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.

Võimalus katkestada vormielemendi lisamine.

Nupule vajutamine avab GS: UC: Hindamismudelite haldus: Hindamismudeli hindamise planeerimise seadistuste vaatamine.

Võimalus salvestada 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. Süsteem käivitab andmete salvestamiseks GS: AssessmentModel: API: POST /quality-api/assessment-models/{modelId}/planning/sections/{sectionId}/elements. Sisend:
   • modelId = Avatud hindamismudeli id.
   • sectionId = Vormi sektsioon, millele vormi elementi lisatakse.
   • 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
   • 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
   • columns.title = Tabeli veerud (kuni 7 veergu) → Veeru nimetused
   • columns.mandatory = Tabeli veerud (kuni 7 veergu) → Täitmine kohustuslik
3. Kui kasutaja lisas vormile pilte või faile, siis:
   1. Süsteem käivitab peale elemendi loomist iga lisatud pildi kohta päringu GS: AssessmentModel: API: POST /quality-api/assessment-models/{modelId}/planning/sections/{sectionId}/elements/{elementId}/files. Sisend:
      • assessmentModelId = Avatud hindamismudeli id.
      • elementId = GS: AssessmentModel: API: POST /quality-api/assessment-models/{modelId}/planning/sections/{sectionId}/elements.response.id
      • sectionId = Sektsioon, millele vormielementi lisatakse.
      • 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 kustutamiseks päringu GS: AssessmentModel: API: DELETE /quality-api/assessment-models/{modelId}/planning/sections/{sectionId}/elements/{elementId}/files/{fileId}. Sisend:
         • assessmentModelId = Avatud hindamismudeli id.
         • elementId = GS: AssessmentModel: API: POST /quality-api/assessment-models/{modelId}/planning/sections/{sectionId}/elements.response.id
         • sectionId = Sektsioon, millele vormielementi lisatakse.
         • fileId = GS: AssessmentModel: API: POST /quality-api/assessment-models/{modelId}/planning/sections/{sectionId}/elements/{elementId}/files.response.id
      2. Süsteem käivitab elemendi kustutamiseks päringu GS: AssessmentModel: API: DELETE /quality-api/assessment-models/{modelId}/planning/sections/{sectionId}/elements/{elementId}. Sisend:
         • assessmentModelId = Avatud hindamismudeli id.
         • elementId = GS: AssessmentModel: API: POST /quality-api/assessment-models/{modelId}/planning/sections/{sectionId}/elements.response.id
         • sectionId = Sektsioon, millele vormielementi lisatakse.
      3. Süsteem kuvab kasutajale teate viirusega nakatunud pildi või faili kohta.
      4. Uuesti salvestamisel algab salvestuse protsess uuesti ja kõik andmed, sh failid salvestatakse uuesti.
   3. Kui pildid on korrektsed ja ilma viiruseta, siis käivitab süsteem pildi pealkirjade (faili korral päringut ei tehta.) salvestamiseks päringu GS: AssessmentModel: API: PUT /quality-api/assessment-models/{modelId}/planning/sections/{sectionId}/elements/{elementId}. Sisend:
      • assessmentModelId = Avatud hindamismudeli id.
      • elementId = GS: AssessmentModel: API: POST /quality-api/assessment-models/{modelId}/planning/sections/{sectionId}/elements.response.id
      • files.fileId = GS: AssessmentModel: API: POST /quality-api/assessment-models/{modelId}/planning/sections/{sectionId}/elements/{elementId}/files.response.id
      • files.title = Pilt → Pealkiri
      • Muud andmed on samad, mis GS: AssessmentModel: API: POST /quality-api/assessment-models/{modelId}/planning/sections/{sectionId}/elements päringus.
4. Süsteem avab GS: UC: Hindamismudelite haldus: Hindamismudeli hindamise planeerimise seadistuste vaatamine
5. Süsteem kuvab teate vormielemendi lisamise kohta.