Üldkirjeldus

Teenus võimaldab luua hindamise.

Seotud andmeobjektid:

NSIL-132 - Getting issue details... STATUS NSIL-355 - Getting issue details... STATUS NSIL-375 - Getting issue details... STATUS NSIL-611 - Getting issue details... STATUS NSIL-769 - Getting issue details... STATUS NSIL-1019 - Getting issue details... STATUS NSIL-1177 - Getting issue details... STATUS NSIL-1289 - Getting issue details... STATUS NSIL-1345 - Getting issue details... STATUS NSIL-1386 - Getting issue details... STATUS

Eeltingimused ja kasutusõigused

Sisendid

Atribuut	Kohustuslikkus, mitmesus	Tüüp	Vaikeväärtus, valideerimine	Kirjeldus, täiendav info
institutionId	0..1	String	Pärigu käivitanud kasutajal peab olema seos sisendis esitatud asutusega. institution.id = EHIS x-tee teenus GET/users/v1/userAccounts.response.data.institutionId/token Kohustuslik, kui Objektid#AssessmentModel.publishedToAllUsers = false, mille assessmentType = Sisendist assessmentType Ei ole lubatud kasutada, kui Objektid#AssessmentModel.publishedToAllUsers = true, mille assessmentType = Sisendist assessmentType	Viide asutusele, millele hindamine luuakse.
assessmentType	1	EHIS Classifier	Peab olema Klassifikaatorid#KlassifikaatorASSESSMENT_TYPE hulgas kehtiv element.	Hindamise liik.
jobsite	0..1	EHIS Classifier	Kasutajal peab olema määratud sisendis esitatud ametikoht sisendis esitatud asutuses. jobsite = EHIS x-tee teenus GET/users/v1/userAccounts.response.data.jobsiteList, mis on seotud sisendis esitatud asutusega. Väärtustena lubatud kasutada EHIS klassifikaatorit PEDAGOOG_AMETIKOHT väärtuseid. Lubatud kasutada, kui luuakse isikupõhine hindamine. Sisendis on määratud assessmentScope = INDIVIDUAL Ei ole lubatud kasutada, kui Objektid#AssessmentModel.publishedToAllUsers = true, mille assessmentType = Sisendist assessmentType	Loend ametikohtadest, kellele hindamismudel on avatud.
assessmentScope	1	Enum	Lubatud väärtused: INSTITUTIONAL INDIVIDUAL	Määrab, kas mudel on mõeldud asutusepõhiseks hindamiseks (INSTITUTIONAL) või isikupõhiseks hindamiseks (INDIVIDUAL).

Väljundid

Atribuut	Kohustuslikkus, mitmesus	Tüüp	Kirjeldus, täiendav info
id	1	String (PK)	Hindamise id (UUID).
assessmentModelId	1	String (FK)	Viide hindamismudelile (UUID).
domain	1	EHIS Classifier	Hindamise valdkond.
assessmentType	1	EHIS Classifier	Hindamise liik.
assessmentScope	1	Enum	Määrab, kas mudel on mõeldud asutusepõhiseks hindamiseks (INSTITUTIONAL) või isikupõhiseks hindamiseks (INDIVIDUAL).
startDate	1	Date	Hindamise algusaeg.
endDate	0..1	Date	Hindamise lõppaeg.
institution	1	Object	Hindamisega seotud asutuse objekt.
institution.id	1	String	Viide hindamisega seotud asutusele.
institution.type	1	EHIS Classifier	Asutuste liikide nimekiri, mille kasutajatele hindamismudel avaldatakse. Ühele mudelile võidakse lisada mitu asutuse liiki.
institution.name	0..1	String	Meeskonna liikme asutus
institution.regCode	0..1	String	Asutuse registrikood.
institution.ehakCode	0..1	String	Hindamisega seotud asutuse (KOVi) EHAK kood.
personalCode	0..1	String	Isiku isikukood, kelle kohta hindamine luuakse. Isikupõhistel hindamisel annab isiku isikukood õiguse hindamist hallata.
evaluatee	0..1	Objekt	Isik kelle suhtes hindamist teostakse. Kasutatakse ainult isikupõhiste hindamist korral (assessmentScope = INDIVIDUAL). Asutusepõhistel hindamistel evaluatee = null
evaluatee.firstName		String	Hinnatava isiku eesnimi. AssessmentTeamMember.firstName, mille assessmentId = Assessment.id personalCode = Assessment.personalCode roleType = TEAM_LEAD objectStatus = CURRENT
evaluatee.lastName		String	Hinnatava isiku perekonnanimi. AssessmentTeamMember.lastName, mille assessmentId = Assessment.id personalCode = Assessment.personalCode roleType = TEAM_LEAD objectStatus = CURRENT
evaluatee.personalCode		String	Hinnatava isiku eesnimi. AssessmentTeamMember.personalCode, mille assessmentId = Assessment.id personalCode = Assessment.personalCode roleType = TEAM_LEAD objectStatus = CURRENT
archivedAt	0..1	Date and time	Hindamise arhiveerimise aeg. Kuupäev ja kellaaeg.
assessmentHierarchyType	0..1	String	Määrab hindamise hierarhia tüübi. Kasutatakse hierarhiliste hindamismudelite korra. Väärtused: null - tegemist ei ole hierarhilise hindamismudeliga. MAIN_ASSESSMENT - Hierarhilise hindamismudeli peamine hindamismudel. SUB_ASSESSMENT - Hierarhilise hindamismudeli ala hindamismudel.
jobsite	0..1	EHIS Classifier Object	Ametikoht, mille suhtes isiku hindamist teostatakse.. Väärtustena kasutatakse EHIS klassifikaatorit PEDAGOOG_AMETIKOHT. Kasutatakse, kui hindamismudel on mõeldud isikupõhiseks hindamiseks (assessmentScope = INDIVIDUAL)
publishedToAllUsers	1	Boolean	Defineerib, kas hindamismudel on avaldatud kõikidele sisseloginud kasutajatele või mitte.
objectStatus	1	String	Objekti staatus. CURRENT - Kehtiv DELETED - Kustutatud

Tegevused

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 otsib päringus esitatud hindamise liigaga kehtiva hindamismudeli.
- Süsteem otsib objekti Objektid#AssessmentModel, mille
  - assessmentType = Sisendis esitatud assessmentType väärtus.
  - confirmed = true
  - validFrom <= päringu teostamise aeg
  - validUntil > päringu teostamise aeg
  - assessmentScope = Sisendis esitatud assessmentScope väärtus.
  - assessmentHierarchyType = null või MAIN_ASSESSMENT (!= SUB_ASSESSMENT)
  - jobsites hulgas on sisendis esitatud jobsite väärtus (kui sisendis on esitatud jobsite).
  - objectStatus = CURRENT
    1. Kui tingimustele vastavat objekti ei leitud, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
Süsteem kontrollib, kas kasutajal on õigus hindamist luua.
1. Asutusepõhised kontrollid (Sisendis assessmentScope = INSTITUTIONAL)
  1. Sisendis esitatud asutus on KOV ja kasutajal on seos sisendis esitatud asutusega ja kasutajal on valdkonna hindamiste haldamise õigus.
    - - EHIS x-tee teenus GET/users/v1/userAccounts.response.data.institutionType = LOCAL_GOVERNMENT, mis on seotud sisendis esitatud asutusega.
      - Privileegi olemasolu:
        Classifier.definitionCode = DOMAIN
        Classifier.classifierAttributeDefinitionCode = ASSESSMENT_MANAGE_PRIVILEGE
        Classifier.attributeValue = Kasutaja poolt valitud asutusega seotud privileegide hulgas olevad privileegid.
      - Leitud Objektid#AssessmentModel objekt peab vastama järgnevatele tingimustele:
        domainType = Classifier.classifierItemCode, mille
        Classifier.definitionCode = DOMAIN
        Classifier.classifierAttributeDefinitionCode = ASSESSMENT_MANAGE_PRIVILEGE
        Classifier.attributeValue = Kasutaja poolt valitud asutusega seotud privileegide hulgas olevad privileegid.
        assessmentScope = INSTITUTIONAL
        institutionTypes.institutionType = institutionType, mille institutionId = sisendis esitatud institutionId väärtus.
        assessmentHierarchyType = null või MAIN_ASSESSMENT (!= SUB_ASSESSMENT)
        objectStatus = CURRENT
  2. Sisendis esitatud asutus on õppeasutus ja kasutajal on seos sisendis esitatud asutusega ja kasutajal on valdkonna hindamiste haldamise õigus.
    - EHIS x-tee teenus GET/users/v1/userAccounts.response.data.institutionType = EDUCATIONAL_INSTITUTION, mis on seotud sisendis esitatud asutusega.
    - Privileegi olemasolu:
      - Classifier.definitionCode = DOMAIN
      - Classifier.classifierAttributeDefinitionCode = ASSESSMENT_MANAGE_PRIVILEGE
      - Classifier.attributeValue = Kasutaja poolt valitud asutusega seotud privileegide hulgas olevad privileegid.
    - Leitud Objektid#AssessmentModel objekt peab vastama järgnevatele tingimustele:
      1. Asutuse tüübile avatud hindamismudel
        domainType = Classifier.classifierItemCode, mille
        Classifier.definitionCode = DOMAIN
        Classifier.classifierAttributeDefinitionCode = ASSESSMENT_MANAGE_PRIVILEGE
        Classifier.attributeValue = Kasutaja poolt valitud asutusega seotud privileegide hulgas olevad privileegid.
        assessmentScope = INSTITUTIONAL
        institutionTypes.institutionType = institutionType, mille institutionId = sisendis esitatud institutionId väärtus.
        institutions.specificationTypes = EHIS x-tee teenus GET/users/v1/userAccounts.response.data.institutionTypeCl või data.institutionTypeClUpper
        assessmentHierarchyType = null või MAIN_ASSESSMENT (!= SUB_ASSESSMENT)
        objectStatus = CURRENT
      2. VÕI
      3. Registrikoodile avatud hindamismudel
        domainType = Classifier.classifierItemCode, mille
        Classifier.definitionCode = DOMAIN
        Classifier.classifierAttributeDefinitionCode = ASSESSMENT_MANAGE_PRIVILEGE
        Classifier.attributeValue = Kasutaja poolt valitud asutusega seotud privileegide hulgas olevad privileegid.
        assessmentScope = INSTITUTIONAL
        institutions.institutionIds = sisendis esitatud institutionId väärtus.
        assessmentHierarchyType = null või MAIN_ASSESSMENT (!= SUB_ASSESSMENT)
        objectStatus = CURRENT
2. Isikupõhised kontrollid (Sisendis assessmentScope =INDIVIDUAL)
  1. Sisendis esitatud hindamise tüüp on isikupõhine hindamine ja kasutajal on hindamismudelis määratud ametikoht (sisendis on määratud jobsite väärtus).
    - Leitud Objektid#AssessmentModel peab vastama järgnevatele tingimustele:
      - assessmentScope = INDIVIDUAL
      - jobsites = Sisendis esitatud jobsite väärtus.
      - assessmentHierarchyType = null või MAIN_ASSESSMENT (!= SUB_ASSESSMENT)
      - objectStatus = CURRENT
  2. Või sisendis esitatud hindamine on lubatud kõigile sisseloginud kasutajatele (sisendis ei ole määratud jobsite väärtust).
    - Leitud Objektid#AssessmentModel peab vastama järgnevatele tingimustele:
      - assessmentScope = INDIVIDUAL
      - publishedToAllUsers = true
      - assessmentHierarchyType = null või MAIN_ASSESSMENT (!= SUB_ASSESSMENT)
      - objectStatus = CURRENT
  3. Kui leitud hindamismudel ei vasta eelnevalt kirjeldatud õiguste kontrolli reeglitele, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
Süsteem kontrollib, kas sama hindamise liigiga on lõpetamata hindamisi.
- Asutusepõhine hindamine (AssessmentModelassessmentScope = INSTITUTIONAL):
  - Süsteem otsib Objektid#Assessment objekti, mille:
    - assessmentType = Sisendis esitatud assessmentType väärtus.
    - endDate = null
    - institution.id = Päringu käivitanud kasutaja poolt valitud rolliga seotud asutuse id EHISes.
    - archivedAt = null
    - objectStatus = CURRENT
- Isikupõhine hindamine (AssessmentModelassessmentScope = INDIVIDUAL):
  - Süsteem otsib Objektid#Assessment objekti, mille:
    - assessmentType = Sisendis esitatud assessmentType väärtus.
    - endDate = null
    - institution.id = Päringu käivitanud kasutaja poolt valitud rolliga seotud asutuse id EHISes.
    - personalCode = Päringu käivitanud kasutaja isikukood.
    - jobsite = Sisendis esitatud jobsite väärtus (kui sisendis on määratud jobsite).
    - archivedAt = null
    - objectStatus = CURRENT
- Kui sama hindamise liigiga on lõpetamata hindamisi, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
Süsteem loob hindamise andmed.
- Süsteem loob Objektid#Assessment objekti:
  - id = UUID
  - assessmentModelId = AssessmentModel.id
  - assessmentHierarchyType = AssessmentModel.assessmentHierarchyType
  - archivedAt = null
  - parentAssessmentId = null
  - domain = AssessmentModel.domain
  - assessmentType = Sisendis esitatud assessmentType väärtus.
  - assessmentScope = Sisendis esitatud assessmentScope väärtus.
  - publishedToAllUsers = AssessmentModel.publishedToAllUsers
  - personalCode =
    - Kui AssessmentModel.assessmentScope = INDIVIDUAL, siis personalCode = Päringu käivitanud kasutaja isikukood.
    - Kui AssessmentModel.assessmentScope != INDIVIDUAL (= INSTITUTIONAL), siis personalCode = null
  - jobsite = Sisendis esitatud jobsite väärtus (kui sisendis on määratud jobsite).
  - startDate = Päringu teostamise kuupäev.
  - endDate = null
  - phases (Lisatakse AssessmentModel.phases väärtused)
    - phases.phase.id = UUID
    - phases.phase.phaseType = AssessmentModel.phases.phase.phaseType
    - phases.phase.startDate = null
    - phases.phase.endDate = null
    - phases.phase.confirmationDate = null
  - institution (Lisatakse päringu käivitanud kasutaja andmetest)
    - institution.id = Päringu käivitanud kasutaja poolt valitud rolliga seotud asutuse id EHISes.
    - institution.name = Päringu käivitanud kasutaja poolt valitud rolliga seotud asutuse nimi.
    - institution.type = Päringu käivitanud kasutaja poolt valitud rolliga seotud asutuse tüüp.
    - institution.regCode = Päringu käivitanud kasutaja poolt valitud rolliga seotud asutuse registrikood.
    - institution.ehakCode = Päringu käivitanud kasutaja poolt valitud rolliga seotud asutuse EHAK kood.
  - AssessmentPlanningSection (Lisatakse AssessmentModelPlanningSection väärtused, mille AssessmentModelPlanningSection.assessmentModelId = leitud AssessmentModel.id väärtus ja AssessmentModelPlanningSection.objectStatus = CURRENT)
    - id = UUID
    - definitionId = AssessmentModelPlanningSection.id
    - name = AssessmentModelPlanningSection.name
    - messageRequired = AssessmentModelPlanningSection.messageRequired
    - seqNo = AssessmentModelPlanningSectionseqNo
    - objectStatus = CURRENT
    - audit = audit (Hindamise looja andmed)
  - AssessmentPlanningSectionElement (Lisatakse AssessmentPlanningSectionElement väärtused, milleAssessmentPlanningSectionElement.assessmentModelId = leitud AssessmentModel.id väärtus jamilleAssessmentPlanningSectionElement.objectStatus = CURRENT)
    - Kui hindamismudeli planeerimise etapi sektsiooni elemendiga on seotud faile, siis kopeerib süsteem failid failisüsteemis, loob uued Objektid#File objektid ja seob need AssessmentPlanningSectionElement objektidega.
    - Luuakse AssessmentPlanningSectionElement objektid.
      - id = UUID
      - definitionId = AssessmentModelPlanningSectionElement.id
      - assessmentId = Loodud hindamise id.
      - sectionId = AssessmentPlanningSection.id
      - label = AssessmentModelPlanningSectionElement.label
      - labelDisplayedOnAssessment = AssessmentModelPlanningSectionElement.labelDisplayedOnAssessment
      - helpText = AssessmentModelPlanningSectionElement.helpText
      - contentType = AssessmentModelPlanningSectionElement.contentType
      - inputType = AssessmentModelPlanningSectionElement.inputType
      - mandatory = AssessmentModelPlanningSectionElement.mandatory
      - seqNo = Arvutatakse AssessmentModelPlanningSectionElement objekti loomise aja järgi. Eespool on vanemad elemendid.
      - textAreaValue = AssessmentModelPlanningSectionElement.textAreaValue
      - options.option.id = UUID
      - options.option.seqNo = Järjekorranumber ühe vormielemendi piires. Esimene väärtus on 1. Valikud peavad olema samas järjekorras, mis optionTexts väärtused.
      - options.option.text = AssessmentModelPlanningSectionElement.optionTexts
      - options.option.selected = false
      - pbiMetadata = AssessmentModelPlanningSectionElement.pbiMetadata
      - pbiMetadata.workspaceId = AssessmentModelPlanningSectionElement.pbiMetadata.workspaceId
      - pbiMetadata.reportId = AssessmentModelPlanningSectionElement.pbiMetadata.reportId
      - numberValue = null
      - percentage.targetLevel = AssessmentModelPlanningSectionElement.percentageTargetLevel
      - percentage.partValue = null
      - percentage.wholeValue = null
      - hyperlinks = AssessmentModelPlanningSectionElement.hyperlinks
      - scale.values.id = UUID
      - scale.valuesFrom = AssessmentModelPlanningSectionElement.valuesFrom
      - scale.valuesUntil = AssessmentModelPlanningSectionElement.valuesUntil
      - scale.values.value = AssessmentModelPlanningSectionElement.scale.values.value
      - scale.values.valueText = AssessmentModelPlanningSectionElement.scale.values.valueText
      - scale.values.selected = false
      - files.fileId = Loodud Objektid#File.id väärtus.
      - files.title = AssessmentModelPlanningSectionElement.files.title
      - files.templateFile
        Kui AssessmentModelPlanningSectionElement.contentType = USER_INPUT ja inputType = FILE, siis templateFile = true.
        Kui AssessmentModelPlanningSectionElement.contentType = ADMIN_INPUT ja inputType = FILE, siis templateFile = false.
        Kui inputType = IMAGE, siis templateFile = false.
      - table.columns.key = Veeru järjekorranumber AssessmentModelPlanningSectionElement.columns arrays.
      - table.columns.title = AssessmentModelPlanningSectionElement.columns.title
      - table.columns.mandatory = AssessmentModelPlanningSectionElement.columns.mandatory
      - table.cells = null
      - objectStatus = CURRENT
      - audit = audit (Hindamise looja andmed)
  - teamMembers (Meeskonnajuht)
    - teamMembers.member.id = UUID
    - teamMembers.member.personalCode = Päringu käivitanud kasutaja isikukood.
    - teamMembers.member.firstName = Päringu käivitanud kasutaja eesnimi.
    - teamMembers.member.lastName = Päringu käivitanud kasutaja perekonnanimi.
    - teamMembers.member.roleType = Meeskonnajuht
    - teamMembers.member.email = null
    - teamMembers.member.phoneNumber = null
    - teamMembers.member.institution = Päringu käivitanud kasutaja poolt valitud rolliga seotud asutuse nimi.
    - teamMembers.member.jobTitle = null
    - teamMembers.member.competences = null
    - teamMembers.member.vocations = null
    - teamMembers.member.profileColor = #9467BD
    - teamMembers.member.objectStatus = CURRENT
    - teamMembers.member.audit = audit (Hindamise looja andmed)
  - teamMembers (Välishindaja)
    - Kui hindamise valdkond (domainType) on NST_KUTSE, siis tuleb lisada vaikimisi välishindaja. Muudel juhtudel välishindajat lisada ei tule.
      - teamMembers.member.id = UUID
      - teamMembers.member.personalCode = 49708310216
      - teamMembers.member.firstName = Birgit
      - teamMembers.member.lastName = Lukk
      - teamMembers.member.roleType = Välishindaja
      - teamMembers.member.email = kutse@enk.ee
      - teamMembers.member.phoneNumber = null
      - teamMembers.member.institution = null
      - teamMembers.member.jobTitle = null
      - teamMembers.member.competences = null
      - teamMembers.member.vocations = null
      - teamMembers.member.profileColor = #E377C2
      - teamMembers.member.objectStatus = CURRENT
      - teamMembers.member.audit = audit (Hindamise looja andmed)
  - assessmentComponent.reportTabs
    - assessmentComponent.reportTabs.reportTab = AssessmentModel.assessmentComponent.reportTabs.reportTab
    - assessmentComponent.reportTabs.reportTab.id = UUID
    - assessmentComponent.reportTabs.reportTab.definitionId = AssessmentModel.assessmentComponent.reportTabs.reportTab.id
    - assessmentComponent.reportTabs.reportTab.name = AssessmentModel.assessmentComponent.reportTabs.reportTab.name
    - assessmentComponent.reportTabs.reportTab.pbiWorkspaceId = AssessmentModel.assessmentComponent.reportTabs.reportTab.pbiWorkspaceId
    - assessmentComponent.reportTabs.reportTab.pbiReportId = AssessmentModel.assessmentComponent.reportTabs.reportTab.pbiReportId
    - assessmentComponent.reportTabs.reportTab.seqNo = AssessmentModel.assessmentComponent.reportTabs.reportTab.seqNo
    - assessmentComponent.reportTabs.reportTab.audit = Objekti looja andmed
    - assessmentComponent.reportTabs.reportTab.objectStatus = CURRENT
  - Objektid#AssessmentComponentSection
    - Lisatakse ainult kehtivad objektid (AssessmentModelComponentSection.objectStatus = CURRENT).
      - id = UUID
      - assessmentId = Loodud hindamise id.
      - allowedToAddAssessmentResultSection =
        Kui AssessmentComponentSection.definitionId = AssessmentModel.result.sections.section.assessmentComponents, siis AssessmentComponentSection.allowedToAddAssessmentResultSection = true
        Kui AssessmentComponentSection.definitionId != AssessmentModel.result.sections.section.assessmentComponents, siis AssessmentComponentSection.allowedToAddAssessmentResultSection = false
      - definitionId = AssessmentModelComponentSection.id
      - name = AssessmentModelComponentSection.name
      - helpText = AssessmentModelComponentSection.helpText
      - shortName = AssessmentModelComponentSection.shortName
      - audit = audit (Hindamise looja andmed)
      - objectStatus = CURRENT
  - Objektid#AssessmentComponentElement
    - Kui hindamismudelil on elemendil mitu etappi, siis loob süsteem iga etapi kohta eraldi elemendi väärtuse. Näiteks, kui hindamismudelis on element.phaseTypes = Enesehindamine ja Välishindamine, siis loob süsteem kummagi etapi kohta eraldi elemendi objekti.
    - Kui hindamismudeli elemendiga on seotud faile, siis kopeerib süsteem failid failisüsteemis, loob uued Objektid#File objektid ja seob need Objektid#AssessmentComponentElement objektidega.
    - Lisatakse ainult kehtivad objektid (AssessmentModelComponentElement.objectStatus = CURRENT).
      - id = UUID
      - assessmentId = Loodud hindamise id.
      - definitionId = AssessmentModelComponentElement.id
      - contentType = AssessmentModelComponentElement.contentType
      - label = AssessmentModelComponentElement.label
      - labelDisplayedOnAssessment = AssessmentModelComponentElement.labelDisplayedOnAssessment
      - helpText = AssessmentModelComponentElement.helpText
      - pbi = AssessmentModelComponentElement.pbi
      - pbi.workspaceId = AssessmentModelComponentElement.pbi.workspaceId
      - pbi.reportId = AssessmentModelComponentElement.pbi.reportId
      - phaseType = AssessmentModelComponentElement.phaseTypes
      - inputType = AssessmentModelComponentElement.inputType
      - mandatory = AssessmentModelComponentElement.mandatory
      - synchronizedToDwh = AssessmentModelComponentElement.synchronizedToDwh
      - textAreaValue =AssessmentModelComponentElement.textAreaValue
      - options.option.id = UUID
      - options.option.seqNo = Järjekorranumber ühe vormielemendi piires. Esimene väärtus on 1. Valikud peavad olema samas järjekorras, mis AssessmentModelComponentElement.optionTexts väärtused.
      - options.option.text = AssessmentModelComponentElement.optionTexts
      - options.option.selected = false
      - numberValue = null
      - percentage.targetLevel = AssessmentModelComponentElement.percentageTargetLevel
      - percentage.partValue = null
      - percentage.wholeValue = null
      - hyperlinks =AssessmentModelComponentElement.hyperlinks
      - scale.values.id = UUID
      - scale.values.value = AssessmentModelComponentElement.scale.values.value
      - scale.values.valueText = AssessmentModelComponentElement.scale.values.valueText
      - scale.values.selected = false
      - files.fileId = Loodud Objektid#File.id väärtus.
      - files.title = AssessmentModelComponentElement.files.title
      - files.templateFile
        Kui AssessmentModelComponentElement.contentType = USER_INPUT ja inputType = FILE, siis templateFile = true.
        Kui AssessmentModelComponentElement.contentType = ADMIN_INPUT ja inputType = FILE, siis templateFile = false.
        Kui inputType = IMAGE, siis templateFile = false.
      - source = ASSESSMENT_MODEL
      - table.columns.key = Veeru järjekorranumber AssessmentModelComponentElement.columns arrays.
      - table.columns.title = AssessmentModelComponentElement.columns.title
      - table.columns.mandatory = AssessmentModelComponentElement.columns.mandatory
      - table.cells = null
      - objectStatus = CURRENT
      - audit = audit (Hindamise looja andmed)
  - Objektid#AssessmentComponentOrder
    - Süsteem lisab iga loodud elemendi hindamise komponendi järjekorda.
    - Süsteem loob Objektid#AssessmentComponentOrder objektid:
      - id = UUID
      - assessmentId = Loodud Assessment.id
      - components = AssessmentModelComponentOrder
        components.id = AssessmentComponentSection.Id (sektsioon) või AssessmentComponentSectionElement.id (vormielement)
        components.definitionId = AssessmentComponentSection.definitionId (sektsioon) või AssessmentComponentSectionElement.definitionId
        components.type = AssessmentComponentSection.Id (SECTION) või AssessmentComponentSectionElement.id (ELEMENT)
  - result.sections.section (Lisatakse AssessmentModel.result.sections väärtused, mille result.sections.section.objectStatus = CURRENT)
    Assessment.result.sections.section ja selle alaobjektid luuakse iga AssessmentModel.result.sections.section.assessmentComponents objekti kohta. Näiteks, kui hindamise tulemuse sektsioon (Assessment.result.sections.section) on seotud kolme hindamise komponendiga (AssessmentModel.result.sections.section.assessmentComponents), siis loob süsteem kolm hindamise tulemuse sektsiooni koos selle alaobjektidega.
    - result.sections.section.id = UUID
    - result.sections.section.definitionId = AssessmentModel.result.sections.section.id
    - result.sections.section.assessmentComponentId = AssessmentComponentSection.id, mille AssessmentComponentSection.definitionId = AssessmentModel.result.sections.section.assessmentComponents
    - 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 (Hindamise looja andmed)
  - 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.code = AssessmentModel.result.sections.section.elements.element.code
    - 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 (Hindamise looja andmed)
  - objectStatus = CURRENT
  - audit = audit
Teavituste saatmine
1. Süsteem otsib hindamise alustamise teavituse seadistuse.
  1. Süsteem otsib hindamise valdkonnaga seotud hindamise alustamise teavituse definitsiooni.
    - Süsteem otsib EHIS ClassifierAttributeValue.attributeValue väärtust (Klassifikaatorid#KlassifikaatorDOMAIN), mille:
      - ClassifierAttributeValue.classifierAttributeDefinitionCode = NEW_ASSESSMENT_MESSAGE_DEFINITION
      - ClassifierAttributeValue.classifierItemCode = Assessment.domainType
        Kui teavituse definitsiooni ei leitud, siis lõpetatakse teavituste saatmise töötlemine ja jätkatakse päringu töötlemisega.
  2. Süsteem otsib Objektid#AssessmentModelNotificationSetting objekti, mille:
    - assessmentModelId = Assessment.assessmentModelId
    - messageActionType = NEW_ASSESSMENT
    - objectStatus = CURRENT
  3. Kui leitud teavituse seadistusel ei ole olemas vähemalt ühte hindamise rolli tüüpi (assessmentRoleTypes = null) või vähemalt ühte ehis privileegi (ehisPrivileges = null), siis lõpetatakse teavituste saatmise töötlemine ja jätkatakse päringu töötlemisega.
  4. Kui leitud teavituse seadistusel on olemas vähemalt üks hindamise rolli tüüp (assessmentRoleTypes != null) või üks ehis privileeg, siis saadab süsteem teavituse.
    - Teavituse saatmiseks käivitab süsteem EHIS x-tee teenuse POST /xroad/v1/sendMessages. Sisend:
      - institutionId = Assessment.institution.id
      - privilegeCodes = AssessmentModelNotificationSetting.ehisPrivileges
      - emailAddresses = AssessmentTeamMember.email väärtused, mille roleType = AssessmentModelNotificationSetting.assessmentRoleTypes, email != null ja objectStatus = CURRENT
      - messageTemplateCode = Leitud EHIS ClassifierAttributeValue.attributeValue väärtust (Klassifikaatorid#KlassifikaatorDOMAIN)
      - messageTemplateParameterList
        [0]
        name = INSTITUTION_NAME
        value = Assessment.institution.name
        [1]
        name = ASSESSMENT_START_DATE
        value = Assessment.startDate (DD.MM.YYYY vormingus)
Kui hindamismudelil on vormielemente, mille tüüp on PBI aruanne, siis loob süsteem igast PBI aruandest pildi, et seda hiljem hindamise pdf kokkuvõttel kasutada.
1. Süsteem otsib PBI raporti vormielemendid.
2. Süsteem genereerib leitud andmete põhjal PBI aruandest pildid.
  1. Rakendatakse filtreid:
    - Kui Assessment.institution.type = LOCAL_GOVERNMENT, siis kasutatakse PBI päringus vaikimisi filtrit DimPidaja/Pidaja_Regkood = Assessment.institution.regCode
    - Kui Assessment.institution.type =EDUCATIONAL_INSTITUTION , siis kasutatakse PBI päringus vaikimisi filtrit DimPidaja/Pidaja_Regkood = Assessment.institution.regCode
3. Süsteem salvestab loodud pildi failihoidlasse.
4. Süsteem salvestab faili objekti.
5. Süsteem loob seose faili objekti ja vormielemendi vahel.
  - Süsteem lisab leitud Objektid#AssessmentComponentElement objektil files arraysse seose faili objektiga.
Süsteem tagastab loodud andmed.

GS: Assessment: API: POST /quality-api/assessments

Üldkirjeldus

Eeltingimused ja kasutusõigused

Sisendid

Väljundid

Tegevused