NSILM

GS: Assessment: API: DELETE /quality-api/assessments/{assessmentId}/planning/sections/{sectionId}/elements/{elementId}/files/{fileId}

Muutja: Andres Mill · 2025-10-02

Üldkirjeldus

Teenuse abil saab lisada planeerimise etapi vormielemendile pilte.

Seotud andmeobjektid:

NSIL-833 - Getting issue details... STATUS NSIL-1100 - Getting issue details... STATUS NSIL-1346 - Getting issue details... STATUS

Eeltingimused ja kasutusõigused

  • Kui tegemist on asutusepõhise hindamisega (assessmentScope = INSTITUTIONAL):
    • Kasutajal peab olema hindamise valdkonnaga seotud hindamise andmete muutmise õigus hindamisega seotud asutuse juures. 
      • Classifier.classifierItemCode = Assessment.domain
      • Classifier.classifierAttributeDefinitionCode = ASSESSMENT_MANAGE_PRIVILEGE
      • Classifier.attributeValue = Kasutaja poolt valitud rolli privileegide hulgas olev privileeg.
      • Assessment.institution.id = Kasutaja poolt valitud rolliga seotud asutus.
  • Kui tegemist on isikupõhise hindamisega (assessmentScope =INDIVIDUAL) ja mittehierarhilise hindamisega või hierarhilise hindamise peamise hindamisega (assessmentHierarchyType = null või MAIN_ASSESSMENT (!= SUB_ASSESSMENT)):
    • Päringu käivitanud kasutaja on isik, kelle suhtes hindamist läbi viiakse.
      • Assessment.presonalCode = Päringu käivitanud isiku isikukood.
  • Kui kasutaja on hindamise meeskonna liige (Kehtib asutusepõhistel ja isikupõhistel hindamistel).
    • Kasutajal peab olema hindamise valdkonnaga seotud hindamise andmete muutmise õigus töödeldava hindamisega seoses ja kasutaja peab olema seotud hindamisega. 
      • AssessmentTeamMember.personalCode = Päringu käivitanud isiku isikukood.
      • AssessmentTeamMember.objectStatus = CURRENT
      • Classifier.classifierItemCode = Assessment.domain
      • Classifier.classifierAttributeDefinitionCode = ASSESSMENT_MANAGE_PRIVILEGE
      • Classifier.attributeValue = Kasutaja poolt valitud rolli privileegide hulgas olev privileeg.
  • Kui tegemist on isikupõhise hierarhilise hindamise alamhindamisega (assessmentHierarchyType = SUB_ASSESSMENT), siis objekti andmeid hallata ei saa.

Sisendid

AtribuutKohustuslikkus, mitmesusTüüpVaikeväärtus, valideerimineKirjeldus, täiendav info
assessmentId1String
  • Hindamine ei tohi olla kustutatud.
    • Assesment.id = assessmentId
  • Hindamine ei tohi olla lõpetatud.
    • Assesment.endDate > Päringu teostamise aeg või Assesment.endDate = null.
Hindamise id.
sectionId1String
  • Sektsioon ei tohi olla kustutatud.
    • AssessmentPlanningSection.id = sectionId
Sektsiooni id.
elementId1String
  • Element ei tohi olla kustutatud.
    • AssessmentPlanningSectionElement.id = elementId
  • Elemendi tüüp peab olema kasutaja sisend.
    • AssessmentPlanningSectionElement.contentType = USER_INPUT
  • Vormielemendi sisendi tüüp peab olema pilt või fail.
    • AssessmentPlanningSectionElement.inputType = IMAGE või FILE
Elemendi id.
fileId1
  • Faili viide ei tohi elemendi küljest olla kustutatud.
    • AssessmentPlanningSectionElement.files.id = Sisendis esitatud fileId väärtus.
  • Fail ei tohi olla näidisfail.
    • AssessmentPlanningSectionElement.files.templateFile != true

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.
fileModifiedAt1Date 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 kustutab faili metaandmed.
    • Süsteem kustutab Objektid#File objekti, mille id = AssessmentPlanningSectionElement.files.fileId jaAssessmentPlanningSectionElement.files.fileId = Sisendis esitatud fileId väärtus.
  4. Süsteem kustutab faili failisüsteemist.
  5. Süsteem kustutab faili ja hindamismudeli vormielemendi vahelise seose.
    • Süsteem kustutab AssessmentPlanningSectionElement.files objekti, mille files.fileId = sisendis esitatud fileId.
    • Süsteem uuendab AssessmentPlanningSectionElement objekti audit väljade info.
  6. Süsteem tagastab kustutatud andmed.