NSILM

GS: Assessment: API: POST /quality-api/assessments/{id}/result/sections

Muutja: Andres Mill · 2025-05-17

Üldkirjeldus

Teenus võimaldab lisada hindamisega seotud hindamise tulemuste sektsioone hindamise komponentidele.

Seotud andmeobjektid:

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.
assessmentComponentId 1String
  • Hindamise komponent ei tohi olla kustutatud.
    • Assessment.assessmentComponent.sections.section.objectStatus = CURRENT
  • Hindamise komponendile tohib lisada juurde hindamise tulemuste sektsiooni.
    • Assessment.assessmentComponent.sections.section.allowedToAddAssessmentResultSection = true
Hindamise komponendi sektsiooni id.

Väljundid

AtribuutKohustuslikkus, mitmesusTüüpKirjeldus, täiendav info
Sama, mis GS: Assessment: API: DELETE /quality-api/assessments/{assessmentId}/result/sections/{sectionId}#V%C3%A4ljundid

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 andmed.
    • Süsteem otsib Objektid#Assessment objekti, mille
      • Assessment.id = Sisendis esitatud id väärtus.
      • Assessment.objectStatus = CURRENT
        1. Kui tingimustele vastavalt objekti ei leitud, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  4. Süsteem otsib hindamisega seotud hindamismudeli hindamise tulemuste sektsiooni.
    • Süsteem otsib Objektid#AssessmentModel.result objekti, mille
      • AssessmentModel.id =  Assessment.assessmentModelId 
      • AssessmentModel.result.sections.section.assessmentComponents = Assessment.assessmentComponent.sections.section.definitionId, mille result.sections.section.assessmentComponentId = Assessment.assessmentComponent.sections.section.id
      • AssessmentModel.objectStatus = CURRENT 
  5. Süsteem loob hindamise tulemuse sektsiooni koos vormielementidega.
    • Assessment.result.sections.section loomine:
      • result.sections.section.id = UUID
      • result.sections.section.definitionId = AssessmentModel.result.sections.section.id
      • result.sections.section.assessmentComponentId = Sisendis esitatud assessmentComponentId väärtus.
      • result.sections.section.name = AssessmentModel.result.sections.section.name
      • result.sections.section.helpText = AssessmentModel.result.sections.section.helpText
      • result.sections.section.seqNo = AssessmentModel.result.sections.section.seqNo
      • result.sections.section.objectStatus = CURRENT
      • result.sections.section.audit = audit (Objekti loomine)
    • Assessment.result.sections.section.elements (Lisatakse AssessmentModel.result.sections.section.elements väärtused, mille result.sections.section.elements.element.objectStatus = CURRENT)
      • result.sections.section.elements.element.id = UUID
      • result.sections.section.elements.element.definitionId = AssessmentModel.result.sections.section.elements.element.id
      • result.sections.section.elements.element.label = AssessmentModel.result.sections.section.elements.element.label
      • result.sections.section.elements.element.helpText = AssessmentModel.result.sections.section.elements.element.helpText
      • result.sections.section.elements.element.inputType = AssessmentModel.result.sections.section.elements.element.inputType
      • result.sections.section.elements.element.seqNo = AssessmentModel.result.sections.section.elements.element.seqNo
      • result.sections.section.elements.element.mandatory = AssessmentModel.result.sections.section.elements.element.mandatory
      • result.sections.section.elements.element.scale = AssessmentModel.result.sections.section.elements.element.scale
      • result.sections.section.elements.element.scale.valuesFrom = AssessmentModel.result.sections.section.elements.element.scale.valuesFrom
      • result.sections.section.elements.element.scale.valuesUntil = AssessmentModel.result.sections.section.elements.element.scale.valuesUntil
      • result.sections.section.elements.element.scale.selectedValue = null
      • result.sections.section.elements.element.textAreaValue = null
      • result.sections.section.elements.element.ehisClassifierCode = AssessmentModel.result.sections.section.elements.element.ehisClassifierCode
      • result.sections.section.elements.element.selectedEhisClassifierItem = null
      • result.sections.section.elements.element.objectStatus = CURRENT
      • result.sections.section.elements.element.audit = audit (Objekti loomine)
  6. Süsteem tagastab loodud andmed.