NSILM

GS: Assessment: API: GET /quality-api/sub-assessments

Muutja: Kaido Laine · 2025-05-16

Üldkirjeldus

Teenus võimaldab otsida hierarhiliste hindamiste alamhindamisi, mis on lõpetamata või arhiveerimata. Kasutatakse töölaual kaasatud hindamiste nimistu kuvamiseks.

Seotud andmeobjektid:

NSIL-1064 - Getting issue details... STATUS


Eeltingimused ja kasutusõigused

  • Kasutaja peab olema autenditud.

Sisendid

-

Väljundid

AtribuutKohustuslikkus, mitmesusTüüpKirjeldus, täiendav info
assessments0..*Array
  • Nimekiri hindamistest.
  • Vastuses on ainult hierarhilise hindamise alahindamised, mis on lõpetamata ja arhiveerimata ja, mille  peamine hindamine on lõpetamata ja arhiveerimata.
    • Objektid#Assessment objektid, mille
        • personalCode = Kasutaja isikukood tokenist.
        • assessmentHierarchyType = SUB_ASSESSMENT
        • archivedAt = null
        • endDate = null
        • objectStatus = CURRENT
        • parentAssessmentId = Assessment.id, mille
          • Assessment.assessmentHierarchyType = MAIN_ASSESSMENT 
          • Assessment.archivedAt = null
          • Assessment.endDate = null
          • Assessment.objectStatus = CURRENT
  • Tingimustele vastavate hindamistega seotud tööülesande täitmise tähtaeg ei tohi olla minevikus. Kui tähtaeg on minevikus, siis sellised hindamisest eemaldatakse vastusest.
    • AssessmentTask.endDate <= päringu käivitamise kuupäev, mille:
      • subAssessmentId = Assessment.id
      • objectStatus = CURRENT
assessments.id1String (PK)

Hindamise id (UUID).

assessments.domainType

1

EHIS ClassifierHindamise valdkond.
assessments.assessmentType

1

EHIS ClassifierHindamise liik.
assessments.assessmentScope

1

EnumMäärab, kas mudel on mõeldud asutusepõhiseks hindamiseks (INSTITUTIONAL) või isikupõhiseks hindamiseks (INDIVIDUAL).
assessments.personalCode0..1StringIsiku isikukood, kes alahindamist teostab.
assessments.dueDate1Date
  • Hindamise täitmise tähtaeg.
    • AssessmentTask.endDate, mille subAssessmentId = Assessment.id
assessments.roleType1EHIS Classifier Object
  • Kasutaja roll peamises hindamises.
    • AssessmentTeamMember.roleType, mille subAssessmentId = Assessment.id ja AssessmentTeamMember.personalCode = Päringu käivitanud kasutaja.
assessments.mainAssessmentEvaluatee1Object
  • Peamise hindamise hinnatava isiku andmed.
  • Objekti andmete väärtustamiseks kasutatakse peamise hindamise andmeid.
    • Assessment objekti andmed, mille id = Assessment.parentAssessmentId 
assessments.mainAssessmentEvaluatee.firstName1String
  • Hinnatava isiku eesnimi.
  • AssessmentTeamMember.firstName, mille
    • assessmentId = Assessment.parentAssessmentId 
    • personalCode = Assessment.personalCode, mille id = Assessment.parentAssessmentId 
    • roleType = TEAM_LEAD
    • objectStatus = CURRENT
assessments.mainAssessmentEvaluatee.lastName1String
  • Hinnatava isiku perekonnanimi.
  • AssessmentTeamMember.lastName, mille
    • assessmentId = Assessment.parentAssessmentId 
    • personalCode = Assessment.personalCode, mille id = Assessment.parentAssessmentId 
    • roleType = TEAM_LEAD
    • objectStatus = CURRENT
assessments.mainAssessmentEvaluatee.institution

1

Object

Hindamisega seotud asutuse objekt.

assessments.mainAssessmentEvaluatee.institution.id1String

Viide hindamisega seotud asutusele.

assessments.mainAssessmentEvaluatee.institution.type1EHIS Classifier

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

assessments.mainAssessmentEvaluatee.institution.name

0..1

StringMeeskonna liikme asutus
assessments.mainAssessmentEvaluatee.institution.regCode0..1String

Asutuse registrikood.

assessments.mainAssessmentEvaluatee.institution.ehakCode0..1String

Hindamisega seotud asutuse (KOVi) EHAK kood.

assessments.mainAssessmentEvaluatee.jobsite0..1EHIS Classifier Object

Ametikoht, mille suhtes isiku hindamist teostatakse.. Väärtustena kasutatakse EHIS klassifikaatorit PEDAGOOG_AMETIKOHT.

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

assessments.objectStatus1String

Objekti staatus.

  • CURRENT - Kehtiv
  • DELETED - Kustutatud

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 kontrollib, kas andmed vastavad nõuetele.
    1. Kui andmed ei vasta nõuetele, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  3. Süsteem otsib andmed (vaata väljundi kirjeldust).