NSILM

GS: AssessmentModel: API: GET /quality-api/assessment-models/{id}

Muutja: Andres Mill · 2025-10-02

Üldkirjeldus

Teenus võimaldab pärida hindamismudeli üldandmeid.

Seotud andmeobjektid:

NSIL-63 - Getting issue details... STATUS NSIL-710 - Getting issue details... STATUS NSIL-988 - 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
id1String

Hindamismudeli id (UUID).

Väljundid

AtribuutKohustuslikkus, mitmesusTüüpKirjeldus, täiendav info
id1String

Hindamismudeli id (UUID).

code1String

Hindamismudeli unikaalne äriline id ehk kood.

name1String

Hindamismudeli nimetus.

assessmentType1ObjectHindamise liik.
assessmentType.definitionCode1ObjectHindamise liigi klassifikaatori objekt.
assessmentType.code1StringKlassifikaatori rea tähis.
assessmentType.name1StringKlassifikaatori rea tekst (rea pealkiri ehk nimetus).
assessmentType.officialName0..1StringKlassifikaatori rea tekst, mis tuleneb seadusest ja mida kasutatakse ametlikel väljundvormidel. Vaikeväärtus on name.
assessmentType.shortName0..1StringKlassifikaatori rea tekst, mida kasutatakse kasutajaliidesel siis, kui teksti pikkus on oluline (nt dropdown valikunimistutes). Vaikeväärtus on name.
assessmentType.seqNo0..1Number

Klassifikaatori rea järjekorranumber. Määrab ridade kuvamise järjekorra enne muid atribuute (nt nimetus).

assessmentScope1StringMäärab, kas hindamine on mõeldud asutusepõhiseks hindamiseks (INSTITUTIONAL) või isikupõhiseks hindamiseks (INDIVIDUAL).
validFrom

1

DateHindamismudeli kehtivuse algus
validUntil

0..1

DateHindamismudeli kehtivuse lõpp
confirmed1Boolean

Määrab, kas hindamismudel on kinnitatud või mitte.

  • true - hindamismudel on kinnitatud.
  • false - hindamismudel on kinnitamata (mustand).
numberOfAssessments1Number

Hindamismudeliga seotud hindamiste arv. Kui ühtegi ei leita, siis tagastatakse arv 0.

  • Süsteem loeb kokku hindamismudeliga seotud hindamiste arvu.
    • Assessment objektide arv, mille:
      • Assessment.assessmentModelId = Teenusega tagastatava AssessmentModel.id väärtus.
      • Assessment.objectStatus = CURRENT
domainType1ObjectHindamismudeli valdkond.
domainType.definitionCode1ObjectHindamismudeli valdkonna klassifikaatori objekt.
domainType.code1StringKlassifikaatori rea tähis.
domainType.name1StringKlassifikaatori rea tekst (rea pealkiri ehk nimetus).
domainType.officialName0..1StringKlassifikaatori rea tekst, mis tuleneb seadusest ja mida kasutatakse ametlikel väljundvormidel. Vaikeväärtus on name.
domainType.shortName0..1StringKlassifikaatori rea tekst, mida kasutatakse kasutajaliidesel siis, kui teksti pikkus on oluline (nt dropdown valikunimistutes). Vaikeväärtus on name.
domainType.seqNo0..1Number

Klassifikaatori rea järjekorranumber. Määrab ridade kuvamise järjekorra enne muid atribuute (nt nimetus).

phaseTypes1..*Array

Hindamismudeli etapid.

phasesTypes.definitionCode1Object

Hindamismudeli etapp.

phasesTypes.code1StringKlassifikaatori rea tähis.
phasesTypes.name1StringKlassifikaatori rea tekst (rea pealkiri ehk nimetus).
phaseTypes.officialName0..1StringKlassifikaatori rea tekst, mis tuleneb seadusest ja mida kasutatakse ametlikel väljundvormidel. Vaikeväärtus on name.
phaseTypes.shortName0..1StringKlassifikaatori rea tekst, mida kasutatakse kasutajaliidesel siis, kui teksti pikkus on oluline (nt dropdown valikunimistutes). Vaikeväärtus on name.
phaseTypes.seqNo0..1Number

Klassifikaatori rea järjekorranumber. Määrab ridade kuvamise järjekorra enne muid atribuute (nt nimetus).

institutions1..*Array

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

institutions.institutionType1Object

Asutuse liigi objekt.

institutions.institutionType.definitionCode1Object

Hindamise liik.

institutions.institutionType.code1StringKlassifikaatori rea tähis.
institutions.institutionType.name1StringKlassifikaatori rea tekst (rea pealkiri ehk nimetus).
institutions.institutionType.officialName0..1StringKlassifikaatori rea tekst, mis tuleneb seadusest ja mida kasutatakse ametlikel väljundvormidel. Vaikeväärtus on name.
institutions.institutionType.shortName0..1StringKlassifikaatori rea tekst, mida kasutatakse kasutajaliidesel siis, kui teksti pikkus on oluline (nt dropdown valikunimistutes). Vaikeväärtus on name.
institutions.institutionType.seqNo0..1Number

Klassifikaatori rea järjekorranumber. Määrab ridade kuvamise järjekorra enne muid atribuute (nt nimetus).

institutions.specificationTypes0..*Array

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

institutions.specificationTypes.definitionCode1Object

Asutuse liigi objekt.

institutions.specificationTypes.code1StringKlassifikaatori rea tähis.
institutions.specificationTypes.name1StringKlassifikaatori rea tekst (rea pealkiri ehk nimetus).
institutions.specificationTypes.officialName0..1StringKlassifikaatori rea tekst, mis tuleneb seadusest ja mida kasutatakse ametlikel väljundvormidel. Vaikeväärtus on name.
institutions.specificationTypes.shortName0..1StringKlassifikaatori rea tekst, mida kasutatakse kasutajaliidesel siis, kui teksti pikkus on oluline (nt dropdown valikunimistutes). Vaikeväärtus on name.
institutions.specificationTypes.seqNo0..1Number

Klassifikaatori rea järjekorranumber. Määrab ridade kuvamise järjekorra enne muid atribuute (nt nimetus).

institutions.institutionIds0..1Array

Asutuste nimekiri.

jobsites0..*EHIS Classifier Array

Loend ametikohtadest, kellele hindamismudel on avatud. Väärtustena kasutatakse EHIS klassifikaatorit PEDAGOOG_AMETIKOHT.

Kasutatakse, kui hindamismudel on mõeldud isikupõhiseks hindamiseks (assessmentScope = INDIVIDUAL)

statusType1Object

Hindamismudeli äriline staatus.

Staatused ja tingimused:

  • Mustand: confirmed = false
  • Kinnitatud: confirmed = true, validFrom > päringu teostamise aeg.
  • Kehtiv: confirmed = true, validFrom <= päringu teostamise aeg, validUntil > päringu teostamise aeg.
  • Kehtetu: confirmed = true,  validUntil <= päringu teostamise aeg.
statusType.definitionCode1ObjectHindamismudeli staatus.
statusType.code1StringKlassifikaatori rea tähis.
statusType.name1StringKlassifikaatori rea tekst (rea pealkiri ehk nimetus).
statusType.officialName0..1StringKlassifikaatori rea tekst, mis tuleneb seadusest ja mida kasutatakse ametlikel väljundvormidel. Vaikeväärtus on name.
statusType.shortName0..1StringKlassifikaatori rea tekst, mida kasutatakse kasutajaliidesel siis, kui teksti pikkus on oluline (nt dropdown valikunimistutes). Vaikeväärtus on name.
statusType.seqNo0..1Number

Klassifikaatori rea järjekorranumber. Määrab ridade kuvamise järjekorra enne muid atribuute (nt nimetus).

assessmentHierarchyType0..1String

Määrab hindamise hierarhia tüübi. Kasutatakse hierarhiliste hindamismudelite korra.

Väärtused:

  • null - tegemist ei ole hierarhilise hindamismudeliga.
  • MAIN_ASSESSMENT - Hierarhilise hindamismudeli peamine hindamismudel.
  • SUB_ASSESSMENT - Hierarhilise hindamismudeli ala hindamismudel.
includedSubRoles0..*Array

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

includedSubRoles.roleType1EHIS Classifier

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

includedSubRoles.minimumRespondentsCount1Integer

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

includedSubRoles.questionnaireDeadlineDays1Integer

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

publishedToAllUsers1Boolean

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

objectStatus1String

Objekti staatus.

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 otsib päringus esitatud tingimustele vastava objekti.
  3. Süsteem tagastab leitud andmed.
    1. Kui tingimustele vastavat objekti ei leitud, lõpetatakse päringu töötlemine ja tagastatakse http veakood.