NSILM

GS: AssessmentModel: API: POST /quality-api/assessment-models/{modelId}/planning/sections/{sectionId}/elements/{elementId}/files

Muutja: Andres Mill · 2025-10-01

Üldkirjeldus

Teenuse abil saab lisada planeerimise etapi vormielemendile pilte.

Seotud andmeobjektid:

NSIL-1336 - Getting issue details... STATUS

Eeltingimused ja kasutusõigused

  • Kasutaja poolt valitud rollil peab olema hindamisega seotud valdkonna haldamise õigus.
    • AssessmentModel.domainType = Klassifikaatorid#KlassifikaatorDOMAIN, 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
assessmentModelId1UUID
  • Hindamismudel ei tohi olla kustutatud.
    • AssessmentModel.id = assessmentModelId
  • Hindamismudeli äriline staatus peab olema "Mustand" või "Kinnitatud".
    • Mustand: AssessmentModel.isConfirmed = false
    • Kinnitatud: AssessmentModel.isConfirmed = true, validFrom > päringu teostamise aeg.
  • Hindamismudelile peab olema lisatud enesehindamise ja/või välishindamise etapp.
    • AssessmentModel.phases hulgas peab olema etapp "Enesehindamine" ja/või "Välishindamine".

Hindamismudeli id (UUID).

sectionId1
  • Sektsioon ei tohi olla kustutatud.
    • AssessmentModelPlanningSection.id = sectionId

Hindamismudeli paneerimise etapi sektsiooni id (UUID).

elementId1UUID
  • Element ei tohi olla kustutatud.
    • AssessmentModelPlanningSectionElement.id = elementId
  • Kui vormielemendi sisendi tüüp on pilt, siis elemendi tüüp peab olema mudeli haldaja sisend ja vormielemendi sisendi tüüp peab olema pilt.
    • AssessmentModelPlanningSectionElement.contentType = ADMIN_INPUT
    • AssessmentModelPlanningSectionElement.inputType = IMAGE
  • Kui vormielemendi sisendi tüüp on fail, siis peab sisendi tüüp olema fail.
    • AssessmentModelPlanningSectionElement.inputType = FILE

Elemendi id (UUID)

file1File
  • 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 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.
  4. Süsteem salvestab faili failisüsteemi.
  5. 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)
  6. Süsteem seob faili hindamismudeli vormielemendiga.
    • Süsteem loob AssessmentModelPlanningSectionElement.files objekti:
      • file.fileId = Loodud File.id
      • file.title = null
  7. Süsteem tagastab lisatud faili kohta andmed.