Üldkirjeldus

Teenus võimaldab hindamise vormil kasutajal hindamise vormielemente luua.

Seotud andmeobjektid:

NSIL-835 - Getting issue details... STATUS NSIL-1099 - Getting issue details... STATUS NSIL-1347 - Getting issue details... STATUS

Eeltingimused ja kasutusõigused

Kui tegemist on asutusepõhise hindamisega (assessmentScope = INSTITUTIONAL):
- Kasutajal peab olema hindamise valdkonnaga seotud enesehindamise andmete muutmise õigus hindamisega seotud asutuse juures.
  - Classifier.classifierItemCode = Assessment.domain
  - Classifier.classifierAttributeDefinitionCode = ASSESSMENT_SELF_ASSESSMENT_MANAGE_PRIVILEGE
  - Classifier.attributeValue = Kasutaja poolt valitud rolli privileegide hulgas olev privileeg.
  - Assessment.institution.id = Kasutaja poolt valitud rolliga seotud asutus.
  - Assessment.phases.phase.phaseType = SELF_ASSESSMENT
- VÕI kasutajal peab olema hindamise valdkonnaga seotud välishindamise andmete muutmise õigus hindamisega seotud asutuse juures.
  - Classifier.classifierItemCode = Assessment.domain
  - Classifier.classifierAttributeDefinitionCode = ASSESSMENT_EXTERNAL_ASSESSMENT_MANAGE_PRIVILEGE
  - Classifier.attributeValue = Kasutaja poolt valitud rolli privileegide hulgas olev privileeg.
  - Assessment.institution.id = Kasutaja poolt valitud rolliga seotud asutus.
  - Assessment.phases.phase.phaseType = EXTERNAL_ASSESSMENT
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.personalCode = Päringu käivitanud isiku isikukood.
Kui tegemist on isikupõhise hindamisega (assessmentScope = INDIVIDUAL) ja hierarhilise hindamise alamhindamisega (assessmentHierarchyType = SUB_ASSESSMENT):
- Päringu käivitanud kasutaja on isik, kelle on hindamine suunatud.
  - Assessment.personalCode = Päringu käivitanud isiku isikukood.
- Hindamine ei tohi olla lõpetatud.
  - Assessment.endDate = null
- Hindamine ei tohi olla arhiveeritud.
  - Assessment.archivedAt = null
Kui kasutaja on hindamise meeskonna liige (Kehtib asutusepõhistel ja isikupõhistel hindamistel).
- Kasutajal peab olema hindamise valdkonnaga seotud enesehindamise 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_SELF_ASSESSMENT_MANAGE_PRIVILEGE
  - Classifier.attributeValue = Kasutaja poolt valitud rolli privileegide hulgas olev privileeg.
  - Assessment.phases.phase.phaseType = SELF_ASSESSMENT
- VÕI kasutajal peab olema hindamise valdkonnaga seotud välishindamise 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_EXTERNAL_ASSESSMENT_MANAGE_PRIVILEGE
  - Classifier.attributeValue = Kasutaja poolt valitud rolli privileegide hulgas olev privileeg.
  - Assessment.phases.phase.phaseType = EXTERNAL_ASSESSMENT

Sisendid

Atribuut	Kohustuslikkus, mitmesus	Tüüp	Vaikeväärtus, valideerimine	Kirjeldus, täiendav info
assessmentId	1	String	Hindamine ei tohi olla kustutatud. Assessment.objectStatus = CURRENT Hindamine ei tohi olla lõpetatud. Assessment.endDate > Päringu teostamise aeg või Assessment.endDate = null. Enesehindamise elementide lisamine. Enesehindamise elemente saab lisada, kui enesehindamine on kinnitamata ja kasutajal on enesehindamise muutmise õigus. Välishindamise elementide lisamine Välishindamise elemente saab lisada, kui enesehindamine on kinnitatud ja välishindamine ei ole kinnitatud ja kasutajal on välishindamise muutmise õigus.	Hindamise id.
sectionId	1	UUID	Sektsioon ei tohi olla kustutatud. AssessmentComponentSection.objectStatus = CURRENT	Hindamise komponendi sektsiooni id (UUID).
previousComponent.id	0..1	String	Kui määratud, siis sektsioon või vormielement ei tohi olla kustutatud. Sektsioon: AssessmentComponentSection.objectStatus = CURRENT, mille AssessmentComponentSection.id = previousComponent.id Element: AssessmentComponentSectionElement.objectStatus = CURRENT, mille AssessmentComponentSectionElement.id = previousComponent.id Kohustuslik, kui previousComponent.type on määratud. Peab olema sisendis esitatud sectionId alamkomponent.	Hindamise komponendi sektsiooni seadistuse objektile eelneva hindamise komponendi (sektsiooni, vormielemendi) id.
previousComponent.type	0..1		Lubatud väärtused: SECTION ELEMENT Kohustuslik, kui previousComponent.id on määratud.	Hindamise komponendi sektsiooni seadistuse objektile eelneva hindamise komponendi (sektsiooni, vormielemendi) tüüp.
inputType	1	EHIS Classifier	Peab olema TEXT_AREA või IMAGE või REPORT või FILE	Vormielemendi sisendi formaat.
phaseType	1	EHIS Classifier list	Peab olema ASSESSMENT_PHASE hulgas kehtiv kirje. Kohustuslik väärtus kas SELF_ASSESSMENT või EXTERNAL_ASSESSMENT Etapp peab olema lisatud hindamisele assessmentPhase.phaseType = SELF_ASSESSMENT või EXTERNAL_ASSESSMENT Kui inputType = REPORT, siis phaseType = SELF_ASSESSMENT Enesehindamise elementide lisamine. Enesehindamise elemente saab lisada, kui enesehindamine on kinnitamata ja kasutajal on enesehindamise muutmise õigus. assessmentPhase.phaseType = SELF_ASSESSMENT ja assessmentPhase.confirmationTime = null Välishindamise elementide lisamine Välishindamise elemente saab lisada, kui enesehindamine on kinnitatud ja välishindamine ei ole kinnitatud ja kasutajal on välishindamise muutmise õigus. assessmentPhase.phaseType = SELF_ASSESSMENT ja assessmentPhase.confirmationTime ≠ null assessmentPhase.phaseType = EXTERNAL_ASSESSMENT ja assessmentPhase.confirmationTime = null	Nimekiri etappidest, kus elementi kasutatakse.

Väljundid

Atribuut	Kohustuslikkus, mitmesus	Tüüp	Kirjeldus, täiendav info
GS: Assessment: API: PUT /quality-api/assessments/{assessmentId}/assessment-component/elements/{elementId}#V%C3%A4ljundid

Tegevused

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.
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.
Süsteem lisab hindamise komponentide hulka uue elemendi andmed.
- Süsteem loob Objektid#AssessmentComponentElement objekti:
  - id = UUID
  - definitionId = UUID
  - assessmentId = Sisendis esitatud assessmentId väärtus.
  - contentType = USER_INPUT
  - label = null
  - labelDisplayedOnAssessment = false
  - helpText = null
  - pbiMetadata = null
  - phaseType = Sisendis esitatud phaseType väärtus.
  - inputType = Sisendis esitatud inputType väärtus.
  - mandatory = false
  - synchronizedToDwh = false
  - options = null
  - percentage = null
  - numberValue = null
  - scale = null
  - files = null
  - textAreaValue = null
  - reports = null
  - hyperlinks = null
  - table = null
  - source = ASSESSMENT
  - objectStatus = CURRENT
  - audit (loomine) = audit (loomine)
Süsteem lisab loodud elemendi hindamise komponentide järjekorras õigesse asukohta.
- sectionId väärtus määrab vormielemendi ülemtaseme hindamise komponendi, mille alla vormielement lisatakse.
- Kui previousComponent väärtus ei ole määratud, siis lisatakse vormielement vastava taseme hindamise komponentide järjekorras esimeseks.
- Kui previousComponent väärtus on määratud, siis lisatakse loodud vormielement vastava taseme hindamise komponentide järjekorras määratud hindamise komponendi järele.
- Andmed salvestatakse Objektid#AssessmentComponentOrder objekti.
Süsteem tagastab loodud andmed.

GS: Assessment: API: POST /quality-api/assessments/{assessmentId}/assessment-component/elements

Üldkirjeldus

Eeltingimused ja kasutusõigused

Sisendid

Väljundid

Tegevused