NSILM

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

Muutja: Carolina Kask · 2025-09-15

Üldkirjeldus

Teenuse abil saab alla laadida vormielemendile lisatud faile.

Seotud andmeobjektid:

NSIL-1261 - Getting issue details... STATUS

Eeltingimused ja kasutusõigused

  • Kasutaja poolt valitud rollil peab olema ükskõik millise valdkonna haldamise õigus.
    • Ükskõik milline Klassifikaatorid#KlassifikaatorDOMAIN element, mis on seotud ASSESSMENT_MODEL_MANAGE_PRIVILEGE (attributeDefinitionCode) privileegiga, mis on kasutaja poolt valitud rollile lisatud.

Sisendid

AtribuutKohustuslikkus, mitmesusTüüpVaikeväärtus, valideerimineKirjeldus, täiendav info
modelId1String
  • Hindamismudel ei tohi olla kustutatud.
    • AssessmentModel.objectStatus = CURRENT

Hindamismudeli id (UUID).

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 hindamismudeli andmed.
    • Süsteem otsib Objektid#AssessmentModel objekti, mille:
      • id = Sisendis esitatud modelId väärtus.
      • objectStatus = CURRENT
        1. Kui objekti ei leita, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  4. Süsteem otsib juhendi andmed.
    • Süsteem otsib Objektid#AssessmentInstruction objekti, mille:
      • id = Sisendis esitatud instructionId väärtus.
      • domainType = AssessmentModel.domainType
      • assessmentType = AssessmentModel.assessmentType
      • objectStatus = CURRENT
        1. Kui tingimustele vastavat objekti ei leita, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  5. 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.
  6. Süsteem otsib failisüsteemist faili, mille File.id = AssessmentInstructionElement.files.fileId ja AssessmentInstructionElement.files.id = Sisendis esitatud fileId väärtus.
  7. Süsteem tagastab leitud faili.