NSILM

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

Muutja: Andres Mill · 2025-05-17

Üldkirjeldus

Teenus võimaldab otsida hindamisega seotud hindamise komponentide elemente.

Seotud andmeobjektid:

NSIL-618 - 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.
elementId1String
  • Element ei tohi olla kustutatud.
    • AssessmentComponentElement.objectStatus = CURRENT
Elemendi id.
fileId1
  • Faili viide ei tohi elemendi küljest olla kustutatud.
    • AssessmentComponentElement.files.id = Sisendis esitatud fileId väärtus.

Elemendiga seotud fail.

Väljundid

AtribuutKohustuslikkus, mitmesusTüüpKirjeldus, täiendav info
file0..1file
  • Fail
  • 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 faili, 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) faile.
    • Kui kasutajal on välishindaja privileeg ja tal puudub enesehindaja privileeg ja enesehindamine on kinnitamata, siis vastus ei sisalda ühtegi faili.
    • 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) faile.
    • Kui kasutajal on välishindaja ja enesehindaja privileeg, siis saab vastus sisaldada kõiki faile, olenemata etapist.
    • Kui kasutajal on ainult hindamise tulemuste privileeg (puuduvad enesehindamise privileegid) ja hindamisel on ainult enesehindamise etapp, siis saab vastus sisaldada faile ainult juhul kui enesehindamise etapp on kinnitatud. Vastus sisaldab sellisel juhul ainult enesehindamisega seotud faile. 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 faile ainult juhul kui enesehindamise ja välishindamise etapp on kinnitatud. Vastus sisaldab sellisel juhul enesehindamise ja välishindamise faile. 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 faile, 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) faile.

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 failisüsteemist faili, mille File.id = AssessmentComponentElement.files.fileId ja AssessmentComponentElement.files.id = Sisendis esitatud fileId väärtus.
  4. Süsteem tagastab leitud faili.