NSILM

GS: Assessment: API: GET /quality-api/assessments/{assessmentId}/assessment-component/order

Muutja: Andres Mill · 2025-05-17

Üldkirjeldus

Teenus võimaldab otsida hindamisega seotud hindamise komponentide järjekorda.

Seotud andmeobjektid:

NSIL-361 - Getting issue details... STATUS NSIL-835 - Getting issue details... STATUS NSIL-1099 - Getting issue details... STATUS

Eeltingimused ja kasutusõigused

  • Kui tegemist on asutusepõhise hindamisega:
    • Kasutajal peab olema hindamise valdkonnaga seotud enesehindamise andmete vaatamise õigus hindamisega seotud asutuse juures. 
      • Classifier.classifierItemCode = Assessment.domain
      • Classifier.classifierAttributeDefinitionCode = ASSESSMENT_SELF_ASSESSMENT_VIEW_PRIVILEGE 
      • Classifier.attributeValue = Kasutaja poolt valitud rolli privileegide hulgas olev privileeg.
      • Assessment.institution.id = Kasutaja poolt valitud rolliga seotud asutus.
      • Assessment.phases.phase.phaseType = SELF_ASSESSMENT 
    • VÕI kasutajal peab olema hindamise valdkonnaga seotud välishindamise andmete vaatamise õigus hindamisega seotud asutuse juures. 
      • Classifier.classifierItemCode = Assessment.domain
      • Classifier.classifierAttributeDefinitionCode = ASSESSMENT_EXTERNAL_ASSESSMENT_VIEW_PRIVILEGE
      • Classifier.attributeValue = Kasutaja poolt valitud rolli privileegide hulgas olev privileeg.
      • Assessment.institution.id = Kasutaja poolt valitud rolliga seotud asutus.
      • Assessment.phases.phase.phaseType = EXTERNAL_ASSESSMENT 
    • VÕI kasutajal peab olema hindamise valdkonnaga seotud hindamise tulemuste andmete vaatamise õigus hindamisega seotud asutuse juures. 
      • Classifier.classifierItemCode = Assessment.domain
      • Classifier.classifierAttributeDefinitionCode = ASSESSMENT_FEEDBACK_VIEW_PRIVILEGE
      • Classifier.attributeValue = Kasutaja poolt valitud rolli privileegide hulgas olev privileeg.
      • Assessment.institution.id = Kasutaja poolt valitud rolliga seotud asutus.
      • Assessment.phases.phase.phaseType = NEEDS_FOR_IMPROVEMENT 
  • Kui tegemist on isikupõhise hindamisega (assessmentScope =INDIVIDUAL) ja mittehierarhilise hindamisega või hierarhilise hindamise peamise hindamisega (assessmentHierarchyType = null või MAIN_ASSESSMENT (!= SUB_ASSESSMENT)):
    • Päringu käivitanud kasutaja on isik, kelle suhtes hindamist läbi viiakse.
      • Assessment.presonalCode = Päringu käivitanud isiku isikukood.
  • Kui tegemist on isikupõhise hindamisega (assessmentScope =INDIVIDUAL) ja hierarhilise hindamise alamhindamisega (assessmentHierarchyType = SUB_ASSESSMENT):
    • Päringu käivitanud kasutaja on isik, kelle on hindamine suunatud.
      • Assessment.presonalCode = Päringu käivitanud isiku isikukood.
    • Hindamine ei tohi olla lõpetatud.
      • Assessment.endDate = null
    • Hindamine ei tohi olla arhiveeritud.
      • Assessment.archivedAt = null
  • Kui kasutaja on hindamise meeskonnaliige.
    • Kasutajal peab olema hindamise valdkonnaga seotud enesehindamise andmete vaatamise õigus ja kasutaja peab olema seotud hindamisega. 
        • AssessmentTeamMember.personalCode = Päringu käivitanud isiku isikukood.
        • AssessmentTeamMember.objectStatus = CURRENT
        • Classifier.classifierItemCode = Assessment.domain
        • Classifier.classifierAttributeDefinitionCode = ASSESSMENT_SELF_ASSESSMENT_VIEW_PRIVILEGE 
        • Classifier.attributeValue = Kasutaja poolt valitud rolli privileegide hulgas olev privileeg.
        • Assessment.phases.phase.phaseType = SELF_ASSESSMENT 
    • VÕI kasutajal peab olema hindamise valdkonnaga seotud välishindamise andmete vaatamise õigus ja kasutaja peab olema seotud hindamisega. 
      • AssessmentTeamMember.personalCode = Päringu käivitanud isiku isikukood.
      • AssessmentTeamMember.objectStatus = CURRENT
      • Classifier.classifierItemCode = Assessment.domain 
      • Classifier.classifierItemCode = Assessment.domain
      • Classifier.classifierAttributeDefinitionCode = ASSESSMENT_EXTERNAL_ASSESSMENT_VIEW_PRIVILEGE
      • Classifier.attributeValue = Kasutaja poolt valitud rolli privileegide hulgas olev privileeg.
      • Assessment.phases.phase.phaseType = EXTERNAL_ASSESSMENT 
    • VÕI kasutajal peab olema hindamise valdkonnaga seotud hindamise tulemuste andmete vaatamise õigus ja kasutaja peab olema seotud hindamisega. 
      • AssessmentTeamMember.personalCode = Päringu käivitanud isiku isikukood.
      • AssessmentTeamMember.objectStatus = CURRENT
      • Classifier.classifierItemCode = Assessment.domain
      • Classifier.classifierItemCode = Assessment.domain
      • Classifier.classifierAttributeDefinitionCode = ASSESSMENT_FEEDBACK_VIEW_PRIVILEGE
      • Classifier.attributeValue = Kasutaja poolt valitud rolli privileegide hulgas olev privileeg.
      • Assessment.phases.phase.phaseType = NEEDS_FOR_IMPROVEMENT 

Sisendid

AtribuutKohustuslikkus, mitmesusTüüpVaikeväärtus, valideerimineKirjeldus, täiendav info
assessmentId1String
  • Hindamine ei tohi olla kustutatud.
    • Assessment.objectStatus = CURRENT
Hindamise id.

Väljundid

AtribuutKohustuslikkus, mitmesusTüüpKirjeldus, täiendav info
components0..*Nested Array Nimekiri hindamise komponentidest (sektsioon, vormielement). Hindamise komponendid on mitmetasandilised. See tähendab, et ühe hindamise komponendi sees saab olla mitu alakomponenti ja alakomponentidel saab olla alakomponente lõpmatu sügavusega.

Sektsiooni tüüpi komponent saab olla esimese taseme komponent, vormielement ei saa olla esimese taseme komponent. 

Sektsiooni tüüpi komponendil saab olla alakomponente, sh sektsioonid ja vormielemendid.

Vormielementi tüüpi komponendil ei saa olla alakomponente.

Samal tasemel ja sama ülemkomponendi all kuuluvad komponendid saavad olla nii sektsioonid kui ka vormielemendid. Samal tasemel ja sama ülemkomponendi alla kuuluvaid sektsioone ja vormielemente saab omavahel järjestada.

components.id1FKViide hindamise komponendile (sektsioonile või vormielemendile). Viitab AssessmentModelComponentSection.Id (sektsioon) väärtusele või AssessmentModelComponentSectionElement.id (vormielement) väärtusele.
components.type1ENUM

Hindamise komponendi tüüp.

Võimalikud väärtused:

  • SECTION
  • ELEMENT
components.level1IntegerKomponendi tase. Tasemed algavad ühest.
components.seqNo1IntegerKomponendi järjekorranumber. Järjekord algab ühest.
components.components[*]0..*Nested ArrayNimekiri alam hindamise komponentidest, milles saab olla veel alamaid. Array objektid on sama struktuuriga, mis components nested arrays defineeritud.

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 hindamise aluseks oleva hindamismudelis defineeritud hindamise komponentid.
    • Süsteem otsib Objektid#AssessmentComponentOrder.components objekte, mille:
      • AssessmentComponentOrder.assessmentModelId = Sisendis esitatud assessmentId väärtus.
      • AssessmentModelComponentOrder.objectStatus = CURRENT
  4. Süsteem tagastab leitud andmed.