NSILM

GS: Assessment: API: GET /quality-api/assessments/{assessmentId}/planning/sections/{sectionId}/elements/{elementId}/files/{fileId}/download

Muutja: Andres Mill · 2025-05-17

Üldkirjeldus

Teenuse abil saab alla laadida vormielemendile lisatud faile.

Seotud andmeobjektid:

NSIL-833 - Getting issue details... STATUS NSIL-1100 - Getting issue details... STATUS

Eeltingimused ja kasutusõigused

  • Kui tegemist on asutusepõhise hindamisega (assessmentScope = INSTITUTIONAL):
    • Kasutajal peab olema hindamise valdkonnaga seotud hindamise andmete vaatamise õigus hindamisega seotud asutuse juures. 
      • 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) 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 kasutaja on hindamise meeskonna liige (Kehtib asutusepõhistel ja isikupõhistel hindamistel).
    • Kasutajal peab olema hindamise valdkonnaga seotud hindamise 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.
  • Kui tegemist on isikupõhise hierarhilise hindamise alamhindamisega (assessmentHierarchyType = SUB_ASSESSMENT), siis objekti andmeid hallata ei saa.

Sisendid

AtribuutKohustuslikkus, mitmesusTüüpVaikeväärtus, valideerimineKirjeldus, täiendav info
assessmentId1String
  • Hindamine ei tohi olla kustutatud.
    • Assesment.id = assessmentId
Hindamise id.
sectionId1String
  • Sektsioon ei tohi olla kustutatud.
    • AssessmentPlanningSection.id = sectionId
Sektsiooni id.
elementId1String
  • Element ei tohi olla kustutatud.
    • AssessmentPlanningSectionElement.id = elementId
Elemendi id.
fileId1
  • Faili viide ei tohi elemendi küljest olla kustutatud.
    • AssessmentPlanningSectionElement.files.id = Sisendis esitatud fileId väärtus.

Elemendiga seotud fail.

Väljundid

AtribuutKohustuslikkus, mitmesusTüüpKirjeldus, täiendav info
file1fileFail.

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 valideerib sisendi.
    1. Kui sisend on ebakorrektne, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  3. Süsteem otsib failisüsteemist faili, mille File.id =AssessmentPlanningSectionElement.files.fileId jaAssessmentPlanningSectionElement.files.id = Sisendis esitatud fileId väärtus.
  4. Süsteem tagastab leitud faili.