NSILM

GS: Assessment: API: GET /quality-api/assessments/{id}/included-sub-roles-statistics

Muutja: Andres Mill · 2025-08-27

Üldkirjeldus

Teenus tagastab info hierarhiliste hindamiste kaasatud rollide kohta. Tagastatakse kui palju on igasse rolli kaasatud inimesi, kui palju on iga kaasatud rolli kohta küsimustike vastanuid ja kui palju on minimaalselt vaja iga kaasatud rolli kohta küsimustiku vastuseid.

Seotud andmeobjektid:

NSIL-1065 - Getting issue details... STATUS

Eeltingimused ja kasutusõigused

  • Teenust saab kasutada ainult hierarhilistel peamistel hindamistele. 
    • Assessment.assessmentHierarchyType = MAIN_ASSESSMENT 
  • Kui tegemist on asutusepõhise hindamisega (assessmentScope = INSTITUTIONAL):
    • Kasutajal peab olema hindamise valdkonnaga seotud hindamise meeskonna liikmete andmete vaatamise õigus ja kasutaja peab olema seotud asutusega, mis on seotud hindamisega. 
      • Classifier.classifierItemCode = Assessment.domain
      • Classifier.classifierAttributeDefinitionCode = ASSESSMENT_VIEW_PRIVILEGE
      • Classifier.attributeValue = Kasutaja poolt valitud rolli privileegide hulgas olev privileeg.
      • Assessment.institution.id = Kasutaja poolt valitud rolliga seotud asutus.
  • Kui tegemist on isikupõhise hindamisega (assessmentScope =INDIVIDUAL) hierarhilise hindamise peamise hindamisega (assessmentHierarchyType = MAIN_ASSESSMENT):
    • Päringu käivitanud kasutaja on isik, kelle suhtes hindamist läbi viiakse.
      • Assessment.presonalCode = Päringu käivitanud isiku isikukood.
  • Kui kasutaja on hindamise meeskonna liige (Kehtib asutusepõhistel ja isikupõhistel hindamistel).
    • Kasutajal peab olema hindamise valdkonnaga seotud hindamise meeskonna liikmete andmete vaatamise õigus töödeldava hindamisega seoses ja kasutaja peab olema seotud hindamisega. 
      • AssessmentTeamMember.personalCode = Päringu käivitanud isiku isikukood.
      • AssessmentTeamMember.objectStatus = CURRENT
      • Classifier.classifierItemCode = Assessment.domain
      • Classifier.classifierAttributeDefinitionCode = ASSESSMENT_VIEW_PRIVILEGE
      • Classifier.attributeValue = Kasutaja poolt valitud rolli privileegide hulgas olev privileeg.

Sisendid

AtribuutKohustuslikkus, mitmesusTüüpVaikeväärtus, valideerimineKirjeldus, täiendav info
id1String
  • Hindamine ei tohi olla kustutatud.
    • Assessment.objectStatus = CURRENT
  • Tegemist on hierarhilise hindamise peamise hindamisega.
    • Assessment.assessmentHierarchyType = MAIN_ASSESSMENT 
Hindamise id.

Väljundid

AtribuutKohustuslikkus, mitmesusTüüpKirjeldus, täiendav info
includedSubRoles0..*Array
  • Nimekiri statistika objektidest.
includedSubRoles.roleType1EHIS Classifier
  • Kaasatud rolli EHIS klassifikaatori objekt. Väärtusena kasutatakse Klassifikaatorid#KlassifikaatorASSESSMENT_ROLE väärtust.
    • AssessmentModel.includedSubRoles.roleType, mille
      • AssessmentModel.id = Assessment.AssessmentModelId, mille
        • Assessment.id = Sisendis esitatud id väärtus.
includedSubRoles.minimumRespondentsCount1Integer
  • Defineerib palju peab olema antud rollis minimaalselt vastanuid, et hierarhilises hindamises saaks hinnatav enesehindamise etapi kinnitada.
    • AssessmentModel.includedSubRoles.minimumRespondentsCount, mille
      • AssessmentModel.id = Assessment.AssessmentModelId, mille
        • Assessment.id = Sisendis esitatud id väärtus.
includedSubRoles.answeredCount1Integer
  • Defineerib, kui palju on rollis vastanud isikuid.
    1. Otsi kaasatud rollide hindamiste identifikaatorid.
      1. AssessmentTeamMember.subAssessmentId väärtused, mille:
        • AssessmentTeamMember.roleType = Leitud includedSubRoles.roleType
        • AssessmentTeamMember.AssessmentId = Sisendis esitatud id väärtus.
    2. Leia lõpetatud alamhindamiste arv
      1. Assessment objektide arv, mille:
        • id = Eelnevalt leitud AssessmentTeamMember.subAssessmentId väärtuste hulgas.
        • assessmentHierarchyType = SUB_ASSESSMENT
        • parentAssessmentId = Sisendis esitatud id väärtus.
        • endDate != null 

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) 
  4. Süsteem tagastab leitud andmed.