NSILM

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

Muutja: Carolina Kask · 2024-03-11

Üldkirjeldus

Teenus salvestab hindamismudeli hindamise tulemuste sektsioonide vormielementide andmed.

Seotud andmeobjektid:


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
modelId1UUID
  • Hindamismudel ei tohi olla kustutatud.
    • AssessmentModel.objectStatus = CURRENT
  • 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 parendustegevuste kavandamise etapp.
    • AssessmentModel.phases hulgas peab olema etapp "Parandustegevuste kavandamine"

Hindamismudeli id (UUID).

sectionId1UUID
  • Sektsioon ei tohi olla kustutatud.
    • AssessmentModel.results.sections.section.objectStatus = CURRENT

Hindamise komponendi sektsiooni id (UUID).

label

1

String
  • 3 - 250 tähemärki.
Vormielemendi silt
helpText

0..1

String
  • Lubatud kuni 1000 tähemärki.
Vormielemendi selgitus/abitekst.
inputType

1

EHIS Classifier
  • Peab olema INPUT_TYPE hulgas kehtiv kirje, mille ADMIN_CONTEXT (attributeDefinitionCode) = NEEDS_FOR_IMPROVEMENT (attributeDefinitionValue).

Vormielemendi sisendi formaat.

mandatory

1

Boolean
  • Lubatud väärtused:
    • true
    • false
Märge, mis näitab kas vormielemendi täitmine on kohustuslik või mitte.
scale.valuesUntil

0..1

Integer
  • Lubatud kasutada ja kohustuslik kui vormielemendi tüüp on punktid (SCORE). Muudel juhtudel ei tohi kasutada.
  • Lubatud väärtused 2 - 10.
Skaala väärtuste lõpp. 
ehisClassifierCode

0..1

String
  • Peab olema kehtiv EHIS klassifikaatori definitsiooni kood.
  • Lubatud kasutada ja kohustuslik kui vormielemendi tüüp on klassifikaator (CLASSIFIER). Muudel juhtudel ei tohi kasutada.
EHISe klassifikaatori definitsiooni kood.

Väljundid

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

Hindamise tulemuste sektsiooni lisatud vormielemendi id (UUID).

defaultElement1Boolean

Määrab, kas vormielement on vaikimisi lisatud vormielement või mitte. Vaikimisi lisatud vormielemente ei saa kustutada.

Väärtused: 

  • true - tegemist on vaikimisi lisatud vormielemendiga.
  • false - tegemist ei ole vaikimisi lisatud vormielemendiga.
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

Vormielemendi sisendi formaat

Väärtusena klassifikaatori INPUT_TYPE elemendi viide.

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. 
ehisClassifierCode

0..1

StringEHISe klassifikaatori definitsiooni kood. 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 valideerib sisendi.
    1. Kui sisend on ebakorrektne, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  3. Süsteem otsib hindamismudeli hindamise tulemuste sektsiooni andmed.
    • Süsteem otsib Objektid#AssessmentModel.result.sections.section objekti, mille:
      • AssessmentModel.id = Sisendis esitatud modelId väärtus.
      • AssessmentModel.isConfirmed = false
        • Või AssessmentModel.isConfirmed = true ja AssessmentModel.validFrom > päringu teostamise aeg.
      • AssessmentModel.phases = "Parandustegevuste kavandamine"
      • AssessmentModel.objectStatus = CURRENT
      • AssessmentModel.result.sections.section.id = Sisendis esitatud sectionId väärtus.
      • AssessmentModel.result.sections.section.objectStatus = CURRENT 
        1. Kui tingimustele vastavat objekti ei leita, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  4. Süsteem lisab hindamisetulemuste sektsiooni uue elemendi andmed.
    • Süsteem loob Objektid#AssessmentModel.result.sections.section.elements.element objekti:
      • id = UUID
      • defaultElement = false
      • label = Sisendis esitatud label väärtus.
      • helpText = Sisendis esitatud helpText väärtus.
      • seqNo = 1 + MAX (AssessmentModel.result.sections.section.elements.element.seqNo), mille AssessmentModel.result.sections.section.id = Sisendis esitatud sectionId ja AssessmentModel.result.sections.section.elements.element.objectStatus = CURRENT.
      • inputType = Sisendis esitatud inputType väärtus.
      • mandatory = Sisendis esitatud mandatory väärtus.
      • scale.valuesFrom = 
        • Kui inputType = SCORE, siis scale.valuesFrom = 1.
        • Kui inputType != SCORE, siis scale.valuesFrom = null.
      • scale.valuesUntil = Sisendis esitatud scale.valuesUntil väärtus.
      • ehisClassifierCode = Sisendis esitatud ehisClassifierCode väärtus.
      • objectStatus = CURRENT
      • audit (loomine) = audit (loomine)
  5. Süsteem tagastab loodud andmed.