NSILM

GS: AssessmentModel: API: GET /quality-api/dashboard/assessments

Muutja: Andres Mill · 2025-01-07

Üldkirjeldus

Teenus võimaldab pärida hindamismudelite nimekirja töölaua jaoks.

Teenus tagastab kasutaja poolt valitud asutuse tüübile avaldatud kehtivad ja kehtetud hindamismudelid.


Eeltingimused ja kasutusõigused

  • Kasutajal peab olema hindamise andmete vaatamise õigus. 
    • Classifier.classifierItemCode = ükskõik, millise valdkonna hindamise vaatamine
    • Classifier.classifierAttributeDefinitionCode = ASSESSMENT_VIEW_PRIVILEGE
    • Classifier.attributeValue = Kasutaja poolt valitud rolli privileegide hulgas olev privileeg.


Sisendid

AtribuutKohustuslikkus, mitmesusTüüpVaikeväärtus, valideerimineKirjeldus, täiendav info
institutionId 0..1String
  • Kasutajal peab olema seos asutusega.
    • HIS x-tee teenus GET/users/v1/users.response.data.users.institution.id/token

Asutuse id, mille eest päring teostatakse.

Väljundid

AtribuutKohustuslikkus, mitmesusTüüpKirjeldus, täiendav info

0..*
  • Päringu vastuses on hindamismudelid kui:
    1. KOV esindaja
      1. Kehtivad mudelid:
        1. Mudel on staatuses kehtiv.
          • AssessmentModel.isConfirmed = true
          • AssessmentModel.validFrom <= päringu teostamise aeg
          • AssessmentModel.validUntil > päringu teostamise aeg
        2. Mudel on avatud KOVidele
          • AssessmentModel.institutions.institutionType = LOCAL_GOVERNMENT
        3. Kasutaja on seotud KOV asutusega.
          • EHIS x-tee teenuse vastuses on kirje GET/users/v1/userAccounts.response.data.institutionType = LOCAL_GOVERNMENT
        4. Kasutajal on KOV asutuse juures hindamise vaatamise õigus.
          1. EHIS x-tee teenuse vastuses on kirje GET/users/v1/userAccounts.response.data.privilegeList = NSILM_ASSESSMENT_VIEW
      2. Õppeasutus
assessmentModels.assessmentType1EHIS ClassifierHindamise liik.
institution

1

ObjectHindamisega seotud asutuse objekt.
institution.id

1

StringViide hindamisega seotud asutusele.
institution.type1EHIS Classifier

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

institution.name

0..1

StringMeeskonna liikme asutus
possibilityToStartAssessment




assessments

0...*



 




assessments

0..*



assessments.domainType

1



assessments.assessmentType

1



institution

1

ObjectHindamisega seotud asutuse objekt.
institution.id

1

StringViide hindamisega seotud asutusele.
institution.type1EHIS Classifier

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

institution.name

1

StringMeeskonna liikme asutus
assessments.assessmentModelId

1



assessments.id

0..1



assessments.startDate

0..1



assessments.endDate

0..1



assessments.possibilityToStartAssessment

1



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 kõik hindamised (ükskõik, mis asutus), kus kasutaja on lisatud hindamise meeskonda.
    • Süsteem otsib Objektid#Assessment objekte, mille:
      • id = AssessmentTeamMember.assessmentId, mille:
        • AssessmentTeamMember.personalCode = Kasutaja isikukood.
        • AssessmentTeamMember.objectStatus = CURRENT
      • objectStatus = CURRENT
  3. Kui sisendis on esitatud asutuse id (institutionId != null) ja kasutajal on olemas antud asutuse juures hindamise vaatamise privileeg, siis:
    1. Süsteem otsib asutusega seotud hindamised, mis on mõeldud asutusepõhiseks hindamiseks ja on seotud valdkonnaga, kus kasutajal on õigus hindamisi näha.
      1. Süsteem otsib Objektid#Assessment objekte, mille:
        • assessmentScope = INSTITUTIONAL
        • institution.id = Sisendis esitatud institutionId väärtus.
        • domainType = Classifier.classifierItemCode, mille
          • Classifier.classifierAttributeDefinitionCode = ASSESSMENT_VIEW_PRIVILEGE
          • Classifier.attributeValue = Kasutaja poolt valitud asutuse privileegide hulgas olev privileeg.
        • objectStatus = CURRENT
    2. Süsteem otsib kehtivad hindamismudelid, mis on asutusele avatud.
      • Süsteem otsib Objektid#AssessmentModel objekte, mille
        • isConfirmed = true
        • validFrom <= päringu teostamise aeg
        • validUntil > päringu teostamise aeg või validUntil = null
        • institutionTypes.institutionType = institutionType, mille institutionId = sisendis esitatud institutionId väärtus.
        • institutions.specificationTypes = institutionSubType, mille institutionId = sisendis esitatud institutionId väärtus.
        • objectStatus = CURRENT
  4. Süsteem tagastab leitud andmed.