NSILM

GS: AssessmentInstruction: API: GET /quality-api/assessment-instructions/{instructionId}/elements/{elementId}/files/{fileId}/download

Muutja: Carolina Kask · 2025-09-17

Üldkirjeldus

Teenuse abil saab alla laadida vormielemendile lisatud faile.

Seotud andmeobjektid:

NSIL-1269 - Getting issue details... STATUS

Eeltingimused ja kasutusõigused

  • Kasutaja peab olema autenditud ja autoriseeritud.

Sisendid

AtribuutKohustuslikkus, mitmesusTüüpVaikeväärtus, valideerimineKirjeldus, täiendav info
instructionId1String
  • Juhend ei tohi olla kustutatud.
    • AssessmentInstruction.objectStatus = CURRENT
Hindamise juhendi id.
elementId1UUID
  • Element ei tohi olla kustutatud.
    • AssessmentInstructionElement.objectStatus = CURRENT

Elemendi id (UUID)

fileId1
  • Faili viide ei tohi elemendi küljest olla kustutatud.
    • AssessmentInstructionElement.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 juhendi üldandmed.
    • Süsteem otsib Objektid#AssessmentInstruction objekti, mille:
      • id = Sisendis esitatud instructionId väärtus.
      • objectStatus = CURRENT
        1. Kui objekti ei leita, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  4. Süsteem otsib elemendi andmed.
    • Süsteem otsib Objektid#AssessmentInstructionElement objekti, mille:
      • id = Sisendis esitatud elementId väärtus.
      • assessmentInstructionId = Sisendis sisestatud instructionId väärtus.
      • objectStatus = CURRENT
        1. Kui tingimustele vastavat objekti ei leita, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  5. Süsteem otsib failisüsteemist faili, mille File.id =AssessmentInstructionElement.files.fileId ja AssessmentInstructionElement.files.id = Sisendis esitatud fileId väärtus.
  6. Süsteem tagastab leitud faili.