NSILM

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

Muutja: Andres Mill · 2025-10-02

Üldkirjeldus

Teenus abil saab lisada hindamise juhendi sektsiooni elementidele faile.

Seotud andmeobjektid:

NSIL-1257 - Getting issue details... STATUS

Eeltingimused ja kasutusõigused

  • Kasutajal peab olema õigus hallata valdkonna hindamismudeleid (Vaata Sisendid → instructionId → Vaikeväärtus, valideerimine).

Sisendid

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

Hindamismudeli id (UUID).

instructionId1String
  • Kasutajal peab olema valdkonna haldamise õigus.
    • Valdkonnal (AssessmentInstruction.domainType) on seos kehtiva privileegiga (attributeDefinitionCode = ASSESSMENT_MODEL_MANAGE_PRIVILEGE), mis on kasutajale määratud.
  • Juhend ei tohi olla kustutatud.
    • Eksisteerib AssessmentInstruction objekt, mille id = instructionId
Hindamise juhendi id.
elementId1UUID
  • Element ei tohi olla kustutatud.
    • AssessmentInstructionElement.objectStatus = CURRENT
  • Elemendi sisendi tüüp peab olema pilt või fail.
    • AssessmentInstructionElement.inputType = IMAGE või FILE

Elemendi id (UUID)

file1
  • Lubatud vormingud: 
    • inputType = IMAGE:
      • jpg
      • jpeg
      • png
      • svg
      • bmp
    • inputType = FILE
      • docx
      • doc
      • odt
      • ods
      • txt
      • rtf
      • pdf
      • xls
      • xlsx
      • csv
      • asice
      • cdoc
  • Faili maksimaalne suurus võib olla kuni 25 MB.

Elemendiga seotud fail.

fileModifiedAt0..1Date and timeKui sisendis ei ole väärtust esitatud, siis vaikimisi salvestatakse päringu käivitamise aeg.

Faili viimane muutmise aeg.

Väljundid

AtribuutKohustuslikkus, mitmesusTüüpKirjeldus, täiendav info
id1UUID

Faili objekti id (UUID).

fileName1StringFaili nimetus koos faililaiendiga. Näiteks "minu pilt.png".
mimeType1StringFaili mime tüüp. Näiteks "image/x-png".
size1IntegerFaili suurus baitides.
fileModifiedAt0..1Date and timeFaili viimane muutmise aeg.
objectStatus1String

Objekti staatus.

  • CURRENT - Kehtiv
  • DELETED - Kustutatud

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 kontrollib viiruse kontrolliga, kas fail on viirusega nakatunud.
    1. Kui fail on viirusega nakatunud, siis lõpetab süsteem päringu töötlemise, tagastab http veakoodi ja info, et fail on viirusega nakatunud.
  7. Süsteem salvestab faili failisüsteemi.
  8. Süsteem salvestab faili metaandmed.
    • Süsteem loob Objektid#File objekti:
      • id = UUID
      • Faili asukoha andmestik failisüsteemis 
      • fileName = Faili nimetus koos faililaiendiga. Näiteks "minu pilt.png".
      • mimeType = Faili mime tüüp. Näiteks "image/x-png".
      • size = Faili suurus baitides.
      • fileModifiedAt = Sisendist fileModifiedAt.
      • objectStatus = CURRENT
      • audit (loomine) = audit (loomine)
  9. Süsteem seob faili juhendi vormielemendiga.
    • Süsteem loob AssessmentInstructionElement.files objekti:
      • file.fileId = Loodud File.id
      • file.title = null
  10. Süsteem tagastab loodud andmed.