NSILM

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

Muutja: Andres Mill · 2025-10-02

Üldkirjeldus

Teenus abil saab kustutada hindamise juhendi sektsiooni elementide faile.

Seotud andmeobjektid:

NSIL-1258 - 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 id (UUID)

fileId1
  • Faili viide ei tohi elemendi küljest olla kustutatud.
    • AssessmentInstructionElement.files.fileId = Sisendis esitatud fileId väärtus.

Elemendiga seotud fail.

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 esitatud assessmentInstructionId 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 kustutab faili metaandmed.
    • Süsteem kustutab Objektid#File objekti, mille id = AssessmentInstructionElement.files.fileId ja AssessmentInstructionElement.files.fileId = Sisendis esitatud fileId väärtus, füüsiliselt andmebaasist.
  7. Süsteem kustutab faili failisüsteemist.
  8. Süsteem kustutab faili ja juhendi vormielemendi vahelise seose.
    • Süsteem kustutab AssessmentInstructionElement.files objekti, mille files.fileId = Sisendis esitatud fileId.
    • Süsteem uuendab AssessmentInstructionElement objekti audit väljade info.
  9. Süsteem tagastab kustutatud andmed.