NSILM

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

Muutja: Carolina Kask · 2025-09-25

Üldkirjeldus

Teenus võimaldab otsida hindamisega seotud hindamise komponentide elemente.

Seotud andmeobjektid:

NSIL-360 - Getting issue details... STATUS NSIL-613 - 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.personalCode = 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, kellele on hindamine suunatud.
      • Assessment.personalCode = 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.
phaseTypes0..*EHIS Classifier Array 

Hindamise elemendiga seotud etapi tüüp. 

Väljundid

AtribuutKohustuslikkus, mitmesusTüüpKirjeldus, täiendav info
elements0..*Array
  • Hindamise komponendi vormi sektsiooni lisatud vormielemendid.
  • Nimekirja objektid on samad, mis GS: Assessment: API: PUT /quality-api/assessments/{assessmentId}/assessment-component/elements/{elementId}#V%C3%A4ljundid
  • Asutusepõhiste hindamiste ja meeskonna liikmete (asutusepõhised ja isikupõhised hindamised) äriloogika:
    • Kui kasutajal on enesehindaja privileeg ja tal puudub välishindaja privileeg ja välishindamine on kinnitamata, siis saab vastus sisaldada ainult kirjeid, mis on seotud enesehindamisega (phaseType = Enesehindamine).
    • Kui kasutajal on enesehindaja privileeg ja tal puudub välishindaja privileeg ja välishindamine on kinnitatud, siis saab vastus sisaldada nii enesehindamise kui ka välishindamise (phaseType = Enesehindamine või Välishindamine) elemente.
    • Kui kasutajal on välishindaja privileeg ja tal puudub enesehindaja privileeg ja enesehindamine on kinnitamata, siis vastus ei sisalda ühtegi kirjet.
    • Kui kasutajal on välishindaja privileeg ja enesehindamine on kinnitatud, siis saab vastus sisaldada vastus nii ensehindamise kui ka välishindamise (phaseType = Enesehindamine või Välishindamine) elemente.
    • Kui kasutajal on välishindaja ja enesehindaja privileeg, ning enesehindamine on kinnitamata, siis saab vastus sisaldada ainult kirjeid, mis on seotud enesehindamisega (phaseType = Enesehindamine). Kui enesehindamine on kinnitatud, siis saab vastus sisaldada kõiki elemente.
    • Kui kasutajal on ainult hindamise tulemuste privileeg (puuduvad enesehindamise privileegid) ja hindamisel on ainult enesehindamise etapp, siis saab vastus sisaldada vormielemente ainult juhul kui enesehindamise etapp on kinnitatud. Vastus sisaldab sellisel juhul ainult enesehindamise vormielemente. Kui enesehindamise etapp on sellises situatsioonis kinnitamata, siis tagastatakse kasutajale tühi vastus. 
    • Kui kasutajal on ainult hindamise tulemuste privileeg (puuduvad enesehindamise ja välishindamise privileegid) ja hindamisel on enesehindamise ja välishindamise etapp, siis saab vastus sisaldada vormielemente ainult juhul kui enesehindamise ja välishindamise etapp on kinnitatud. Vastus sisaldab sellisel juhul enesehindamise ja välishindamise vormielemente. Kui enesehindamise ja välishindamise etapp on sellises situatsioonis kinnitamata, siis tagastatakse kasutajale tühi vastus. 
  • Isikupõhiste hindamiste äriloogika, kui kasutaja on isik, kelle suhtes hindamist tehakse:
    • Kui kasutaja on isik, kelle suhtes hindamist tehakse ja enesehindamine on kinnitamata, siis saab vastus sisaldada ainult kirjed, mis on seotud enesehindamisega (phaseType = Enesehindamine).
    • Kui kasutaja on isik, kelle suhtes hindamist tehakse ja enesehindamine on kinnitatud (välishindamine ja hindamise tulemused võivad olla kinnitamata), siis saab vastus sisaldada nii enesehindamise kui ka välishindamise (phaseType = Enesehindamine või Välishindamine) elemente.

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 päringus esitatud tingimustele vastavad vormielemendid ja aruanded.
    • Süsteem otsib Objektid#AssessmentComponentElement objekte, mille
      • assessmentId = Sisendis esitatud assessmentId väärtus.
      • objectStatus = CURRENT
      • phaseType = Sisendis esitatud phaseTypes väärtus.
  4. Süsteem tagastab leitud andmed.