NSILM

GS: Assessment: API: PUT /quality-api/assessments/{id}/result/sections/{sectionId}/elements/{elementId}

Muutja: Andres Mill · 2025-05-17

Üldkirjeldus

Teenus võimaldab muuta hindamisega seotud hindamise tulemuste sektsioonide elementide väärtuseid.

Seotud andmeobjektid:

NSIL-406 - Getting issue details... STATUS NSIL-836 - Getting issue details... STATUS NSIL-1102 - Getting issue details... STATUS

Eeltingimused ja kasutusõigused

  • Kui tegemist on asutusepõhise hindamisega (assessmentScope = INSTITUTIONAL):
    • Kasutajal peab olema hindamise valdkonnaga seotud hindamise tulemuste andmete muutmise õigus hindamisega seotud asutuse juures. 
      • Classifier.classifierItemCode = Assessment.domain
      • Classifier.classifierAttributeDefinitionCode = ASSESSMENT_FEEDBACK_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 tulemuste 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_FEEDBACK_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
id1String
  • Hindamine ei tohi olla kustutatud.
    • Assesment.objectStatus = CURRENT
  • Hindamine ei tohi olla lõpetatud.
    • Assesment.endDate > Päringu teostamise aeg või Assesment.endDate = null.
  • Hindamise tulemuste etapp ei tohi olla kinnitatud.
    • Assesment.phases.phase.confirmationTime = null, mille phaseType = NEEDS_FOR_IMPROVEMENT
  • Kui hindamisel on enesehindamise etapp ja välishindamise etappi ei ole, siis peab olema enesehindamise etapp kinnitatud.
    • Assesment.phases.phase.confirmationTime != null, mille phaseType = SELF_ASSESSMENT 
  • Kui hindamisel on enesehindamise ja välishindamise etapp, siis peavad mõlemad etapid olema kinnitatud.
    • Assesment.phases.phase.confirmationTime != null, mille phaseType = SELF_ASSESSMENT 
    • Assesment.phases.phase.confirmationTime != null, mille phaseType = EXTERNAL_ASSESSMENT 
Hindamise id.
sectionId1String
  • Sektsioon ei tohi olla kustutatud.
    • Assessment.result.sections.section.objectStatus = CURRENT
Sektsiooni id.
elementId1String
  • Element ei tohi olla kustutatud.
    • Assessment.result.sections.section.elements.element.objectStatus = CURRENT
Elemendi id.
textAreaValue0..1String
  • Saab muuta, kui elemendi tüüp on tekstiala.
    • Assessment.planning.sections.section.inputType = TEXT_AREA 
  • Ei ole kohustuslik, kui elemendi tüüp on tekstiala.
  • Lubatud kuni 1000 tähtmärki.

Elemendi väärtus, kui vormielement on tekstiala (TEXT_AREA).

scale.selectedValue

0..1Integer
  • Saab muuta, kui elemendi tüüp on punktid.
    • Assessment.planning.sections.section.inputType = SCORE
  • result.sections.section.elements.element.scale.valuesFrom <= sisendis scale.selectedValue <= result.sections.section.elements.element.scale.valuesUntil
  • Ei ole kohustuslik, kui elemendi tüüp on punktid.

Skaalal valitud väärtus.

selectedEhisClassifierItemCodes

0..*

EHIS Classifier Array
  • Saab muuta, kui elemendi tüüp on loend.
    • Assessment.planning.sections.section.inputType = CLASSIFIER
  • Valitud klassifikaatori elemendid peavad olema defineeritud klassifikaatori (result.sections.section.elements.element.ehisClassifierCode) elementide hulgas.
  • Ei ole kohustuslik, kui elemendi tüüp on loend.

Valitud ehise klassifikaatori elemendi objektid. Kasutatakse kui sisendi formaat väärtuseks on "klassifikaator" (CLASSIFIER).

Väljundid

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

Hindamise tulemuste sektsiooni lisatud vormielemendi id (UUID).

definitionId1UUID

Vormielemenedi id (UUID) hindamismudeli juures.

label

1

StringVormielemendi silt
helpText

0..1

StringVormielemendi selgitus/abitekst.
inputType

1

EHIS Classifier

Vormielemendi sisendi formaat

Väärtusena klassifikaatori INPUT_TYPE elemendi viide.

seqNo

1

EHIS Classifier

Elemendi järjekorranumber.

mandatory

0..1

BooleanMärge, mis näitab kas vormielemendi täitmine on kohustuslik või mitte.

scale

0..1Object

Skaala objekt. Kasutatakse kui sisendi formaat väärtuseks on "punktid" (SCORE).

scale.valuesFrom

1

IntegerSkaala väärtuste algus. 
scale.valuesUntil

1

IntegerSkaala väärtuste lõpp. 

scale.selectedValue

0..1Integer

Skaalal valitud väärtus.

textAreaValue

0..1String

Elemendi väärtus, kui vormielement on tekstiala (TEXT_AREA).

ehisClassifierCode

0..1

StringEHISe klassifikaatori definitsiooni kood. Kasutatakse kui sisendi formaat väärtuseks on "klassifikaator" (CLASSIFIER).
selectedEhisClassifierItems

0..*

EHIS Classifier ArrayValitud ehise klassifikaatori elemendi objektid. Kasutatakse kui sisendi formaat väärtuseks on "klassifikaator" (CLASSIFIER).
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 kontrollib, kas andmed vastavad nõuetele.
    1. Kui andmed ei vasta nõuetele, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  3. Süsteem otsib päringus esitatud tingimustele vastavad hindamise tulemuse sektsiooni elemendi andmed.
    • Süsteem otsib Objektid#Assessment.result.sections.section.elements.element objekti, mille
      • Assessment.id = Sisendis esitatud id väärtus.
      • Assessment.objectStatus = CURRENT
      • Assessment.result.sections.section.id = Sisendis esitatud sectionId väärtus.
      • Assessment.result.sections.section.objectStatus= CURRENT
      • Assessment.result.sections.section.elements.element.id = Sisendis esitatud elementId väärtus.
      • Assessment.result.sections.section.elements.element.objectStatus = CURRENT
        1. Kui tingimustele vastavalt objekti ei leitud, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  4. Süsteem muudab elemendi andmeid.
    • Süsteem uuendab leitud Objektid#Assessment.result.sections.section.elements.element objekti andmeid:
      • textAreaValue = Sisendis esitatud textAreaValue väärtus.
      • selectedEhisClassifierItems = Sisendis esitatud selectedEhisClassifierItems väärtused.
      • scale.selectedValue = Sisendis esitatud scale.selectedValue väärtus.
      • audit (muutmine) = audit (muutmine)
  5. Süsteem tagastab muudetud andmed.