NSILM

GS: AssessmentModel: API: POST /quality-api/assessment-models

Muutja: Andres Mill · 2025-10-13

Üldkirjeldus

Teenus salvestab hindamismudeli detailandmeid.

Seotud andmeobjektid:

NSIL-66 - Getting issue details... STATUS NSIL-342 - Getting issue details... STATUS NSIL-988 - Getting issue details... STATUS NSIL-1060 - Getting issue details... STATUS NSIL-1096 - Getting issue details... STATUS NSIL-1137 - Getting issue details... STATUS NSIL-1143 - Getting issue details... STATUS NSIL-1295 - Getting issue details... STATUS

Eeltingimused ja kasutusõigused

  • Kasutajal peab olema privileeg NSILM_ASSESSMENT_MODEL_MANAGE


Sisendid

AtribuutKohustuslikkus, mitmesusTüüpVaikeväärtus, valideerimineKirjeldus, täiendav info
name1String3-250 tähemärki.

Hindamismudeli nimetus.

assessmentType1StringNimekiri hindamise liikidest. Väärtusena klassifikaatori ASSESSMENT_TYPE elemendi viide.
validFrom1Date
  • validFrom >= Päringu teostamise kuupäev.
Hindamismudeli kehtivuse algus.
validUntil0..1Date
  • validUntil >= validFrom
Hindamismudeli kehtivuse lõpp.
phaseTypes1..*Array
  • Peavad olema Klassifikaatorid#KlassifikaatorASSESSMENT_PHASE hulgas.
  • Kui ei ole tegemist hierarhilise hindamis liigiga, siis peab minimaalselt olema kaasatud kohustuslikud etapid. Võivad olla kaasatud ka teised etapid.
    • Kui sisendis esitatud assessmentType väärtusel puudub klassifikaatori atribuudi ASSESSMENT_HIERARCHY väärtus, siis peavad vähemalt olema esitatud Klassifikaatorid#KlassifikaatorASSESSMENT_PHASE väärtused, mille atribuudi ALWAYS_INCLUDED = true.
  • Kui on tegemist hierarhilise hindamis liigiga, mis on hierarhilise hindamise peamine hindamise liik, siis peab minimaalselt olema kaasatud kohustuslikud etapid. Võivad olla kaasatud ka teised etapid.
    • Kui sisendis esitatud assessmentType väärtusel on klassifikaatori tunnus ASSESSMENT_HIERARCHY (attributeDefinitionCode) = MAIN_ASSESSMENT (attributeDefinitionValue), siis peavad vähemalt olema esitatud Klassifikaatorid#KlassifikaatorASSESSMENT_PHASE väärtused, mille atribuudi ALWAYS_INCLUDED = true.
  • Kui on tegemist hierarhilise hindamis liigiga, mis on hierarhilise hindamise alamhindamise liik, siis peab minimaalselt olema kaasatud enesehindamise etapp. Teisi etappe ei tohi olla kaasatud.
    • Kui sisendis esitatud assessmentType väärtusel on klassifikaatori tunnus ASSESSMENT_HIERARCHY (attributeDefinitionCode) = SUB_ASSESSMENT (attributeDefinitionValue), siis peab sisendis olema määratud vähemalt SELF_ASSESSMENT etapp.
  • Ei tohi esitada mitu sama liigiga kirjet.

Hindamismudeli etapid.

institutions.institutionType0..1String

Asutuse liik, mille kasutajatele hindamismudel avaldatakse. 

institutions.specificationTypes0..*Array
  • Kui tegemist on asutusepõhise hindamisega, siis on kohustuslik esitada vähemalt üks Klassifikaatorid#KlassifikaatorOPPEASUTUSE_TYYP väärtus, kui institutionType = Õppeasutus.
    • Kui sisendis esitatud assessmentType väärtusega seotud klassifikaatori elemendi atribuudi ASSESSMENT_SCOPE = INSTITUTIONAL.
  • Kui tegemist on asutusepõhise hindamisega, siis ei tohi esitada ühtegi väärtust, kui institutionType != Õppeasutus.
    • Kui sisendis esitatud assessmentType väärtusega seotud klassifikaatori elemendi atribuudi ASSESSMENT_SCOPE = INSTITUTIONAL.
  • Kui tegemist on isikupõhise hindamisega, siis tohib esitada õppeasutuse täpsustusi. Ei ole kohustuslik.
    • Kui sisendis esitatud assessmentType väärtusega seotud klassifikaatori elemendi atribuudi ASSESSMENT_SCOPE = INDIVIDUAL.
  • Ei tohi esitada mitu sama liigiga kirjet.
  • Peab olema Klassifikaatorid#KlassifikaatorOPPEASUTUSE_TYYP hulgas kehtiv kirje.
  • Lubatud kasutada, kui tegemist on peamise hindamismudeliga või mittehierarhiline hindamismudeliga. Hierarhilistel alamatel ei tohi kasutada.
      • Kui sisendis esitatud assessmentType väärtusel on klassifikaatori tunnus ASSESSMENT_HIERARCHY (attributeDefinitionCode) = MAIN_ASSESSMENT (attributeDefinitionValue) või kui sisendis esitatud assessmentType väärtusel ei ole klassifikaatori tunnust ASSESSMENT_HIERARCHY
  • Peab olema null, kui publishedToAllUsers = true

Asutuse liigi täpsustused. Ühel asutuse liigil võib olla mitu täpsustust.

institutions.institutionIds0..*Array
  • Ei tohi esitada mitu sama asutuse institutionId kirjet.
  • Lubatud kasutada, kui hindamismudel on mõeldud asutusepõhiseks kasutamiseks.
  • Peab olema null, kui publishedToAllUsers = true

Asutuste nimekiri, mille kasutajatele hindamismudel avaldatakse. Ühele mudelile võidakse lisada mitu asutust.

jobsites 0..*Array
  • Peab olema EHIS klassifikaatori PEDAGOOG_AMETIKOHT hulgas kehtiv element.
  • Lubatud kasutada ja on kohustuslik, kui hindamismudel on mõeldud isikupõhiseks hindamiseks ja tegemist on peamise hindamismudeliga või mittehierarhiline hindamismudeliga.
    • Sisendis esitatud Klassifikaatorid#KlassifikaatorASSESSMENT_TYPE väärtusel on atribuut ASSESSMENT_SCOPE = INDIVIDUAL
    • Kui sisendis esitatud assessmentType väärtusel on klassifikaatori tunnus ASSESSMENT_HIERARCHY (attributeDefinitionCode) = MAIN_ASSESSMENT (attributeDefinitionValue) või kui sisendis esitatud assessmentType väärtusel ei ole klassifikaatori tunnust ASSESSMENT_HIERARCHY
  • Peab olema null, kui publishedToAllUsers = true

Loend ametikohtadest, millele hindamismudel on avatud. 

includedSubRoles0..*Array
  • Lubatud kasutada, kui tegemist on hierarhilise hindamismudeli peamise hindamismudeliga. Teiste hindamismudelite korral ei ole lubatud väärtust esitada.
    • Kui sisendis esitatud assessmentType väärtusel on klassifikaatori tunnus ASSESSMENT_HIERARCHY (attributeDefinitionCode) = MAIN_ASSESSMENT (attributeDefinitionValue)
  • Ei ole kohustuslik. 

Hierarhilise hindamismudeli kaasatud rollide nimistu. Kasutatakse hierarhilise mudeli peamise hindamise juures.

includedSubRoles.roleType1EHIS Classifier
  • Kaasatud roll peab olema seotud mudeli valdkonnaga.
    • Klassifikaatorid#KlassifikaatorASSESSMENT_ROLE, mille:
      • ROLE_SCOPE (klassifikaatori atribuut) = 360_ASSESSMENT_ROLE (klassifikaatori atribuudi väärtus)
      • Mudeli valdkonnaga seotud rollide kontroll:
        1. Süsteem käivitab päringu GET hsilm-gateway/v1/classifiers/ASSESSMENT_TYPE/links hindamise liikide klassifikaatori linkide otsimiseks.
        2. Süsteem otsib leitud linkide hulgast ülesse valitud hindamise valdkonna kõik hindamise liigid.
            • Süsteem otsib lingi objektide classifierItemCode1 väärtused, mille:
              • classifierLinkDefinitionCode = ASSESSMENT_TYPE_DOMAIN
              • classifierItemCode2 = Sisendis esitatud assessmentType seotud domainType
        3. Süsteem otsib kõikide punktis 2 leitud hindamise liikide kaasatud rollid.
            • Süsteem otsib linkide objektide classifierItemCode2 väärtuseid, mille:
              • classifierLinkDefinitionCode = ASSESSMENT_TYPE_ASSESSMENT_ROLE
              • classifierItemCode1 = Punktis 2 leitud classifierItemCode1 väärtused
        4. Sisendis esitatud includedSubRoles.roleType väärtused peavad olema punktis 3 leitud classifierItemCode2 väärtuste hulgas.  

Kaasatud rolli EHIS klassifikaatori objekt. Väärtusena kasutatakse Klassifikaatorid#KlassifikaatorASSESSMENT_ROLE väärtust.

includedSubRoles.minimumRespondentsCount1Integer
  • Peab olema 0 suurem positiivne täisarv.

Defineerib palju peab olema antud rollis minimaalselt vastanuid, et hierarhilises hindamises saaks hinnatav enesehindamise etapi kinnitada.

includedSubRoles.questionnaireDeadlineDays1Integer
  • Peab olema 0 suurem positiivne täisarv.

Defineerib mitme päeva jooksul peab rollil küsimustik täidetud olema.

publishedToAllUsers0..1Boolean
  • Lubatud väärtused:
    • true
    • false
  • Kui määramata, siis vaikimisi false.
  • Peab olema null/false, kui ASSESSMENT_SCOPE = INSTITUTIONAL

Defineerib, kas hindamismudel on avaldatud kõikidele sisseloginud kasutajatele või mitte.

Väljundid

AtribuutKohustuslikkus, mitmesusTüüpKirjeldus, täiendav info
GS: AssessmentModel: API: GET /quality-api/assessment-models/{id}#V%C3%A4ljundid

Tegevused

  1. Süsteem kontrollib, kas kasutajal on õigust päringut teostada.
    1. Kui kasutajal ei ole õigust päringut teostada, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  2. Süsteem valideerib sisendi.
    1. Kui sisend on ebakorrektne, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  3. Süsteem loob päringus esitatud hindamismudeli.
    • Süsteem loob Objektid#AssessmentModel objekti:
      • id = UUID
      • code = Sisendis esitatud assessmentType väärtusega seotud valdkonna kood (Klassifikaatorid#KlassifikaatorDOMAIN) + mudeli järjekord valdkonnas. Näiteks NSILM1
      • domain = Klassifikaatorid#KlassifikaatorDOMAIN väärtus, mille classifierLink on assessmentType väärtus.
      • name = Sisendis esitatud name väärtus.
      • assessmentType = Sisendis esitatud assessmentType väärtus.
      • assessmentScope = Sisendis esitatud assessmentType väärtusega seotud klassifikaatori elemendi atribuudi ASSESSMENT_SCOPE väärtus.
      • validFrom = Sisendis esitatud validFrom väärtus.
      • validUntil = Sisendis esitatud validUntil väärtus.
      • confirmed = false
      • phaseTypes = Sisendis esitatud phaseTypes väärtused.
      • institutions.institutionType = Sisendis esitatud institutions.institutionType väärtus.
      • institutions.specificationTypes = Sisendis esitatud institutions.specificationTypes väärtused.
      • institutions.institutionIds = Sisendis esitatud institutions.institutionIds väärtused.
      • jobsites = Sisendis esitatud jobsites väärtused.
      • assessmentHierarchyType = Sisendis esitatud assessmentType väärtusega seotud klassifikaatori elemendi atribuudi ASSESSMENT_HIERARCHY väärtus.
      • includedSubRoles = Sisendis esitatud includedSubRoles väärtused.
      • publishedToAllUsers = Sisendis publishedToAllUsers väärtus.
      • objectStatus = CURRENT
      • createdBy = Objekti looja ID.
      • createdAt = Päringu teostamise aeg.
      • modifiedBy = Objekti looja ID.
      • modifiedAt = Päringu teostamise aeg.
  4. Süsteem loob hindamise teavituste seadistused.
    • Teavituse seadistus luuakse iga etappi kohta, mis on sisendis esitatud ja millel on link EHISe klassifikaatoriga läbi klassifikaatori lingi definitsiooni (NSILM_MESSAGE_ACTION_ASSESSMENT_PHASE) klassifikaatoriga NSILM_MESSAGE_ACTION. Kui klassifikaatori NSILM_MESSAGE_ACTION elemendil ei ole ühtegi lingitud etappi, siis luuakse ka selline teavituse eelseadistus. Näiteks, kui sisendis on etapp SELF_ASSESSMENT, siis see on lingitud teavituse seadistusega CONFIRM_SELF_ASSESSMENT. Sellisel juhul tuleb luua teavituse seadistus liigiga CONFIRM_SELF_ASSESSMENT. Teavitusel liigiga NEW_ASSESSMENT ei ole ühtegi seotud etappi. Seega NEW_ASSESSMENT tüüpi teavituse algseadistus tuleb luua igale hindamisele. NB! Igal hindamismudelil võib olla n arv teavituse seadistusi. Igal etapil võib olla 0..n arv teavituse seadistusi. Esialgsed lingid on kirjeldatud Klassifikaatorid#KlassifikaatorNSILM_MESSAGE_ACTION tabelis.
    • Süsteem loob AssessmentModel.notificationSettings objektid:
      • id = UUID
      • messageActionType = Klassifikaatorid#KlassifikaatorNSILM_MESSAGE_ACTION, mille classifierLinkDefinitionCode = NSILM_MESSAGE_ACTION_ASSESSMENT_PHASE ja  classifierLink on assessmentType väärtuste hulgas.
      • phaseType = NSILM_MESSAGE_ACTION klassifikaatori elemendiga lingitud phaseType väärtus.
      • addresseeGroupTypes = null
      • assessmentRoles = null
      • ehisPrivileges = null
      • adUserGroups = null
      • objectStatus = CURRENT
      • audit (loomine) = audit (loomine)
  5. Süsteem loob hindamise tulemuste sektsioonide algseadistuse.
    • Süsteem loob AssessmentModel.result.sections.section objekti:
      • id = UUID
      • name = Hindamise tulemuste kokkuvõte
      • helpText = Hindamise tulemuste kokkuvõttena kirjeldatavaid väljakutseid saab kasutada arengukava koostamisel.
      • seqNo = 1
      • objectStatus = CURRENT
      • audit (loomine) = audit (loomine)
  6. Süsteem loob hindamise tulemuste sektsioonide vormielementide algseadistused.
    1. Väljakutse liik
      • Süsteem loob AssessmentModel.result.sections.section.elements.element objekti:
        • id = UUID
        • defaultElement = true
        • label = Väljakutse liik:
        • code = CHALLENGE_TYPE
        • helpText = Vali loetelust hindamistulemusest sobiv väljakutse liik.
        • inputType = CLASSIFIER
        • seqNo = 1
        • mandatory = true
        • scale = null
        • ehisClassifierCode = HSILM_CHALLENGE_TYPE
        • objectStatus = CURRENT
        • audit (loomine) = audit (loomine)
    2. Väljakutse
      • Süsteem loob AssessmentModel.result.sections.section.elements.element objekti:
        • id = UUID
        • defaultElement = true
        • label = Väljakutse:
        • code = CHALLENGE
        • helpText = Kirjelda lühidalt väljakutse (soovitavalt ühe lausega).
        • inputType = TEXT_AREA
        • seqNo = 2
        • mandatory = true
        • scale = null
        • ehisClassifierCode = null
        • objectStatus = CURRENT
        • audit (loomine) = audit (loomine)
    3. Teema
      • Süsteem loob AssessmentModel.result.sections.section.elements.element objekti:
        • id = UUID
        • defaultElement = true
        • label = Teema:
        • code = TOPIC
        • helpText = Vali loetelust väljakutsega seotud teemad.
        • inputType = CLASSIFIER
        • seqNo = 3
        • mandatory = true
        • scale = null
        • ehisClassifierCode = HSILM_THEME_LABEL  
        • objectStatus = CURRENT
        • audit (loomine) = audit (loomine)
    4. Olulisus
      • Süsteem loob AssessmentModel.result.sections.section.elements.element objekti:
        • id = UUID
        • defaultElement = true
        • label = Olulisus:
        • code = IMPORTANCE
        • helpText = Vali olulisus tulemuse mõju või prioriteetsuse järgi.
        • inputType = SCORE
        • seqNo = 4
        • mandatory = true
        • scale.valuesFrom = 1
        • scale.valuesUntil = 10
        • ehisClassifierCode = null
        • objectStatus = CURRENT
        • audit (loomine) = audit (loomine)
  7. Süsteem loob etappide ja meeskonnaliikme rollide aliaste objektid.
    1. Etapid
    2. Meeskonnaliikmete rollid
      • Süsteem loob enesehindaja rolli kohta Objektid#AssessmentModelAlias objekti:
        • id = UUID
        • assessmentModelId = Loodud hindamismudeli id.
        • alias = null
        • classifierElement = SELF_ASSESSOR 
        • objectStatus = CURRENT
        • audit (loomine) = audit (loomine)
      • Süsteem loob enesehindaja rolli kohta Objektid#AssessmentModelAlias objekti:
        • id = UUID
        • assessmentModelId = Loodud hindamismudeli id.
        • alias = null
        • classifierElement = EXTERNAL_ASSESSOR 
        • objectStatus = CURRENT
        • audit (loomine) = audit (loomine)
  8. Süsteem loob vajadusel hindamise liigi kohta hindamise juhendi objekti.
    1. Süsteem otsib sisendis esitatud hindamise liigi kohta juhendi objekti
      1. Süsteem otsib Objektid#AssessmentInstruction objekti, mille:
        • assessmentType = AssessmentModel.assessmentType 
        • domainType = AssessmentModel.domainType 
        • objectStatus = CURRENT
    2. Kui leitakse hindamise liigi juhendi objekt, siis jätkab süsteem päringu töötlemist järgmisest peavoo sammust.
    3. Kui hindamise liigi kohta juhendi objekti ei leitud, siis:
      1. loob süsteem juhendi objekti.
        • Süsteem loob Objektid#AssessmentInstruction objekti:
          • id = UUID
          • name = Juhend
          • assessmentType = AssessmentModel.assessmentType 
          • domainType = AssessmentModel.domainType 
          • objectStatus = CURRENT
          • audit (loomine) = audit (loomine)
      2. loob süsteem juhendi kohta juhendi komponentide järjekorra objekti
  9. Süsteem tagastab loodud andmed.