Üldkirjeldus

Teenus võimaldab kinnitada hindamise etapi andmed.

Seotud andmeobjektid:

NSIL-371 - Getting issue details... STATUS NSIL-456 - Getting issue details... STATUS NSIL-623 - Getting issue details... STATUS NSIL-771 - Getting issue details... STATUS NSIL-779 - Getting issue details... STATUS NSIL-826 - Getting issue details... STATUS NSIL-832 - Getting issue details... STATUS NSIL-1075 - Getting issue details... STATUS NSIL-1228 - Getting issue details... STATUS NSIL-1270 - Getting issue details... STATUS NSIL-1297 - Getting issue details... STATUS

Eeltingimused ja kasutusõigused

Kui tegemist on asutusepõhise hindamisega (assessmentScope = INSTITUTIONAL):
- Kui kasutaja kinnitab hindamisplaani, siis peab kasutajal olema hindamise valdkonnaga seotud hindamisplaani andmete haldamise õigus hindamisega seotud asutuse juures.
  - Classifier.classifierItemCode = Assessment.domain
  - Classifier.classifierAttributeDefinitionCode = 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 = PLANNING
- Kui kasutaja kinnitab enesehindamist, siis peab kasutajal olema hindamise valdkonnaga seotud enesehindamise andmete haldamise õ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
- Kui kasutaja kinnitab välishindamist, siis peab kasutajal olema hindamise valdkonnaga seotud välishindamise andmete haldamise õ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 kasutaja kinnitab hindamise tulemusi, siis peab kasutajal olema hindamise valdkonnaga seotud hindamise tulemuste andmete haldamise õ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.
  - Assessment.phases.phase.phaseType = NEEDS_FOR_IMPROVEMENT
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).
- Kui kasutaja kinnitab hindamisplaani, siis peab kasutajal olema hindamise valdkonnaga seotud hindamisplaani andmete haldamise õ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_MANAGE_PRIVILEGE
  - Classifier.attributeValue = Kasutaja poolt valitud rolli privileegide hulgas olev privileeg.
  - Assessment.phases.phase.phaseType = PLANNING
- Kui kasutaja kinnitab enesehindamist, siis peab kasutajal olema hindamise valdkonnaga seotud enesehindamise andmete haldamise õ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
- Kui kasutaja kinnitab välishindamist, siis peab kasutajal olema hindamise valdkonnaga seotud välishindamise andmete haldamise õ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
- Kui kasutaja kinnitab hindamise tulemusi, siis peab kasutajal olema hindamise valdkonnaga seotud hindamise tulemuste andmete haldamise õ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.
  - Assessment.phases.phase.phaseType = NEEDS_FOR_IMPROVEMENT

Sisendid

Atribuut	Kohustuslikkus, mitmesus	Tüüp	Vaikeväärtus, valideerimine	Kirjeldus, täiendav info
id	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.	Hindamise id.
phaseId	1	String	Etapp ei tohi olla kustutatud. Assessment.phases.phase.objectStatus = CURRENT Kinnitamise reeglid: Planeerimise etappi võib kinnitada olenemata sellest, kas teised etapid on kinnitatud. Planeerimise etapp ei tohi olla kinnitatud. Enesehindamise etappi võib kinnitada, kui planeerimise, välishindamise või hindamise tulemuste etapp ei ole kinnitatud. Enesehindamise etapp ei tohi olla kinnitatud. Välishindamise etappi võib kinnitada, kui enesehindamise etapp on kinnitatud. Välishindamise etapp ei tohi olla kinnitatud. Hindamise tulemuste etappi võib kinnitada, kui hindamisel on välishindamise etapp ja välishindamise etapp on kinnitatud. Hindamise tulemuste etapp ei tohi olla kinnitatud. Hindamise tulemuste etappi võib kinnitada, kui hindamisele ei ole lisatud välishindamise etappi ja enesehindamise etapp on kinnitatud. Hindamise tulemuste etapp ei tohi olla kinnitatud.	Hindamise etapi id (UUID).

Väljundid

Atribuut	Kohustuslikkus, mitmesus	Tüüp	Kirjeldus, täiendav info
GS: Assessment: API: PUT /quality-api/assessments/{id}/phases/{phaseId}#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 otsib päringus esitatud tingimustele vastava hindamise etapi.
- Süsteem otsib Objektid#Assessment.phases.phase objekti, mille
  - id = Sisendis esitatud id väärtus.
  - objectStatus = CURRENT
    1. Kui tingimustele vastavat objekti ei leitud, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
Kui kinnitatav etapp on enesehindamine, siis kontrollib:
1. Süsteem, kas kohustuslikud enesehindamise etapi vormielemendid on täidetud või mitte. Kõikide elementide kohustuslikku täitmist tuleb kontrollida.
  - Tingimus: Assessment.phases.phase.phaseType = SELF_ASSESSMENT
  - Kontrollid:
    - Kui enesehindamise vormielemendi tüüp on mitmikvalik ja tegemist on kohustusliku elemendiga, siis peab olema vähemalt üks variant valitud.
      - AssessmentComponentElement.inputType = MULTIPLE_CHOICE, mille AssessmentComponentElement.phaseType = SELF_ASSESSMENT
      - AssessmentComponentElement.objectStatus = CURRENT
      - AssessmentComponentElement.mandatory = true
      - Vähemalt üks AssessmentComponentElement.selected = true
    - Kui enesehindamise vormielemendi tüüp on vabatekst ja tegemist on kohustusliku elemendiga, siis peab olema vähemalt 3 tähemärki sisestatud.
      - AssessmentComponentElement.inputType = TEXT_AREA, mille AssessmentComponentElement.phaseType = SELF_ASSESSMENT
      - AssessmentComponentElement.objectStatus = CURRENT
      - AssessmentComponentElement.mandatory = true
      - AssessmentComponentElement.options.option.textAreaValue väärtus peab olema vähemalt 3 tähemärki pikk.
    - Kui enesehindamise vormielemendi tüüp on üksikvalik ja tegemist on kohustusliku elemendiga, siis peab olema täpselt üks variant valitud.
      - AssessmentComponentElement.inputType = SINGLE_CHOICE, mille AssessmentComponentElement.phaseType = SELF_ASSESSMENT
      - AssessmentComponentElement.objectStatus = CURRENT
      - AssessmentComponentElement.mandatory = true
      - Täpselt üks AssessmentComponentElement.selected = true
    - Kui enesehindamise vormielemendi tüüp on arv ja tegemist on kohustusliku elemendiga, siis peab olema arv sisestatud.
      - AssessmentComponentElement.inputType = NUMBER, mille AssessmentComponentElement.phaseType = SELF_ASSESSMENT
      - AssessmentComponentElement.objectStatus = CURRENT
      - AssessmentComponentElement.mandatory = true
      - AssessmentComponentElement.options.option.numberValue != null.
    - Kui enesehindamise vormielemendi tüüp on osakaal ja tegemist on kohustusliku elemendiga, siis peab olema osakaal täidetud.
      - AssessmentComponentElement.inputType = PERCENTAGE, mille AssessmentComponentElement.phaseType = SELF_ASSESSMENT
      - AssessmentComponentElement.objectStatus = CURRENT
      - AssessmentComponentElement.percentage.partValue != null
      - AssessmentComponentElement.percentage.wholeValue != null
    - Kui enesehindamise vormielemendi tüüp on veebi link ja tegemist on kohustusliku elemendiga, siis peab olema vähemalt üks veebilink lisatud.
      - AssessmentComponentElement.inputType = HYPERLINK, mille AssessmentComponentElement.phaseType = SELF_ASSESSMENT
      - AssessmentComponentElement.objectStatus = CURRENT
      - Vähemalt üks AssessmentComponentElement.percentage.hyperlinks väärtus peab olema olemas.
    - Kui enesehindamise vormielemendi tüüp on skaala ja tegemist on kohustusliku elemendiga, siis peab olema täpselt üks skaala element valitud.
      - AssessmentComponentElement.inputType = SCALE, mille AssessmentComponentElement.phaseType = SELF_ASSESSMENT
      - AssessmentComponentElement.objectStatus = CURRENT
      - Täpselt üks AssessmentComponentElement.scale.values.selected = true
    - Kui enesehindamise vormielemendi tüüp on pilt ja tegemist on kohustusliku elemendiga, siis peab olema täpselt üks pilt olema lisatud.
      - AssessmentComponentElement.inputType = IMAGE, mille AssessmentComponentElement.phaseType = SELF_ASSESSMENT
      - AssessmentComponentElement.objectStatus = CURRENT
      - AssessmentComponentElement.files = null
    - Kui enesehindamise vormielemendi tüüp on tabel ja tegemist on kohustusliku elemendiga, siis peab olema vähemalt üks rida lisatud, mille ühe veeru väärtus on lisatud.
      - AssessmentComponentElement.inputType = TABLE, mille AssessmentComponentElement.phaseType = SELF_ASSESSMENT
      - AssessmentComponentElement.objectStatus = CURRENT
      - AssessmentComponentElement.mandatory = true
      - Ekisteerib AssessmentComponentElement objektis vähemalt üks table.cells objekt, mille table.cells.value != null
    - Kui enesehindamise vormielemendi tüüp on tabel ja tabeli veeru täitmine on kohustuslik, siis peab tabeli iga rea kohustuslikku veergu väärtus olema lisatud.
      - AssessmentComponentElement.inputType = TABLE, mille AssessmentComponentElement.phaseType = SELF_ASSESSMENT
      - AssessmentComponentElement.objectStatus = CURRENT
      - Iga unikaalse AssessmentComponentElement.table.cells.rowKey kohta on olemas üks AssessmentComponentElement.table.cells objekt, mille table.cells.value != null ja table.cells.columnKey = table.columns.key, mille table.columns.madatory = true.
2. Kui tegemist on hierarhilise hindamise peamise hindamisega (Assessment.assessmentHierarchyType = MAIN_ASSESSMENT), siis kontrollib süsteem lisaks, kas igas kaasatud grupis on minimaalne arv vastanuid.
  1. Süsteem otsib kaasatud gruppide minimaalse vastanute arvu.
    - Süsteem otsib kõik Objektid#AssessmentModel.includedSubRoles.minimumRespondentsCount väärtused, mille:
      - AssessmentModel.id = Assessment.AssessmentModelId, mille
        Assessment.id = Sisendis esitatud id väärtus.
  2. Süsteem otsib iga leitud kaasatud grupi vastanute arvu.
    1. Süsteem otsib kaasatud gruppidesse kuuluvata isikute hindamised.
      - Süsteem otsib AssessmentTeamMember.subAssessmentId väärtused, mille:
        assessmentId = Sisendis esitatud id väärtus.
        roleType = Leitud AssessmentModel.includedSubRoles.roleType väärtused.
        objectStatus = CURRENT
    2. Süsteem grupeerib iga leitud rolli tüübi (AssessmentTeamMember.roleType) hindamised ja leiab iga rolli tüübi kohta lõpetatud hindamise arvu
      - Lõpetatud hindamise tingimused. Objektid#Assessment objekt peab vastama tingimustele:
        id = AssessmentTeamMember.subAssessmentId
        endDate != null
        parentAssessmentId = Sisendis esitatud id väärtus.
  3. Kui mõnes grupis (AssessmentTeamMember.roleType) on vähem lõpetatud hindamisi, kui minimaalselt nõutud (AssessmentModel.includedSubRoles.minimumRespondentsCount), siis lõpetatakse päringu töötlemine ja tagastatakse viga.
Kui kinnitatav etapp on välishindamine, siis kontrollib süsteem, kas kohustuslikud välishindamise etapi vormielemendid on täidetud või mitte. Kõikide elementide kohustuslikku täitmist tuleb kontrollida.
- Tingimus: Assessment.phases.phase.phaseType = EXTERNAL_ASSESSMENT
- Kontrollid:
  - Kui välishindamise vormielemendi tüüp on mitmikvalik ja tegemist on kohustusliku elemendiga, siis peab olema vähemalt üks variant valitud.
    - AssessmentComponentElement.inputType = MULTIPLE_CHOICE, mille AssessmentComponentElement.phaseType = EXTERNAL_ASSESSMENT
    - AssessmentComponentElement.objectStatus = CURRENT
    - AssessmentComponentElement.mandatory = true
    - Vähemalt üks AssessmentComponentElement.selected = true
  - Kui välishindamise vormielemendi tüüp on vabatekst ja tegemist on kohustusliku elemendiga, siis peab olema vähemalt 3 tähemärki sisestatud.
    - AssessmentComponentElement.inputType = TEXT_AREA, mille AssessmentComponentElement.phaseType = EXTERNAL_ASSESSMENT
    - AssessmentComponentElement.objectStatus = CURRENT
    - AssessmentComponentElement.mandatory = true
    - AssessmentComponentElement.options.option.textAreaValue väärtus peab olema vähemalt 3 tähemärki pikk.
  - Kui välishindamise vormielemendi tüüp on üksikvalik ja tegemist on kohustusliku elemendiga, siis peab olema täpselt üks variant valitud.
    - AssessmentComponentElement.inputType = SINGLE_CHOICE, mille AssessmentComponentElement.phaseType = EXTERNAL_ASSESSMENT
    - AssessmentComponentElement.objectStatus = CURRENT
    - AssessmentComponentElement.mandatory = true
    - Täpselt üks AssessmentComponentElement.selected = true
  - Kui välishindamise vormielemendi tüüp on arv ja tegemist on kohustusliku elemendiga, siis peab olema arv sisestatud.
    - AssessmentComponentElement.inputType = NUMBER, mille AssessmentComponentElement.phaseType = EXTERNAL_ASSESSMENT
    - AssessmentComponentElement.objectStatus = CURRENT
    - AssessmentComponentElement.mandatory = true
    - AssessmentComponentElement.options.option.numberValue != null.
  - Kui välishindamise vormielemendi tüüp on osakaal ja tegemist on kohustusliku elemendiga, siis peab olema osakaal täidetud.
    - AssessmentComponentElement.inputType = PERCENTAGE, mille AssessmentComponentElement.phaseType = EXTERNAL_ASSESSMENT
    - AssessmentComponentElement.objectStatus = CURRENT
    - AssessmentComponentElement.percentage.partValue != null
    - AssessmentComponentElement.percentage.wholeValue != null
  - Kui välishindamise vormielemendi tüüp on veebi link ja tegemist on kohustusliku elemendiga, siis peab olema vähemalt üks veebilink lisatud.
    - AssessmentComponentElement.inputType = HYPERLINK, mille AssessmentComponentElement.phaseType = EXTERNAL_ASSESSMENT
    - AssessmentComponentElement.objectStatus = CURRENT
    - Vähemalt üks AssessmentComponentElement.percentage.hyperlinks väärtus peab olema olemas.
  - Kui välishindamise vormielemendi tüüp on skaala ja tegemist on kohustusliku elemendiga, siis peab olema täpselt üks skaala element valitud.
    - AssessmentComponentElement.inputType = SCALE, mille AssessmentComponentElement.phaseType = EXTERNAL_ASSESSMENT
    - AssessmentComponentElement.objectStatus = CURRENT
    - Täpselt üks AssessmentComponentElement.scale.values.selected = true
  - Kui välishindamise vormielemendi tüüp on pilt ja tegemist on kohustusliku elemendiga, siis peab olema täpselt üks pilt olema lisatud.
    - AssessmentComponentElement.inputType = IMAGE, mille AssessmentComponentElement.phaseType = EXTERNAL_ASSESSMENT
    - AssessmentComponentElement.objectStatus = CURRENT
    - AssessmentComponentElement.files = null
  - Kui välishindamise vormielemendi tüüp on tabel ja tegemist on kohustusliku elemendiga, siis peab olema vähemalt üks rida lisatud, mille ühe veeru väärtus on lisatud.
    - AssessmentComponentElement.inputType = TABLE, mille AssessmentComponentElement.phaseType = EXTERNAL_ASSESSMENT
    - AssessmentComponentElement.objectStatus = CURRENT
    - AssessmentComponentElement.mandatory = true
    - Ekisteerib AssessmentComponentElement objektis vähemalt üks table.cells objekt, mille table.cells.value != null
  - Kui välishindamise vormielemendi tüüp on tabel ja tabeli veeru täitmine on kohustuslik, siis peab tabeli iga rea kohustuslikku veergu väärtus olema lisatud.
    - AssessmentComponentElement.inputType = TABLE, mille AssessmentComponentElement.phaseType = EXTERNAL_ASSESSMENT
    - AssessmentComponentElement.objectStatus = CURRENT
    - Iga unikaalse AssessmentComponentElement.table.cells.rowKey kohta on olemas üks AssessmentComponentElement.table.cells objekt, mille table.cells.value != null ja table.cells.columnKey = table.columns.key, mille table.columns.madatory = true.
Kui kinnitatav etapp on hindamise tulemused, siis kontrollib süsteem, kas kohustuslikud hindamise tulemuste etapi vormielemendid on täidetud või mitte. Kõikide elementide kohustuslikku täitmist tuleb kontrollida.
- Tingimus: Assessment.phases.phase.phaseType = NEEDS_FOR_IMPROVEMENT
- Kontrollid:
  - Kui hindamise tulemuste vormielemendi täitmine on kohustuslik, siis peab element täidetud olema:
    - AssessmentModelResultSectionElement.mandatory = true
    - Kui result.sections.section.elements.element.inputType = TEXT_AREA, siis result.sections.section.elements.element.textAreaValue != null
    - Kui result.sections.section.elements.element.inputType = CLASSIFIER, siis result.sections.section.elements.element.selectedEhisClassifierItems != null
    - Kui result.sections.section.elements.element.inputType = SCORE, siis result.sections.section.elements.element.scale.selectedValue != null
Süsteem kinnitab hindamise etapi andmeid.
- Süsteem uuendab leitud Objektid#Assessment.phases.phase objekti:
  - confirmationTime = Päringu käivitamise aeg.
  - audit (muutmine) = audit (muutmine)
Kui kasutaja kinnitas enesehindamise etapi hierarhilise hindamise peamises hindamises (Assessment.assessmentHierarchyType = MAIN_ASSESSMENT), siis:
1. Süsteem otsib peamise hindamise alamhindamised, mis on lõpetamata.
  - Süsteem otsib Objektid#Assessment objekte, mille:
    - parentAssessmentId = Sisendis esitatud id väärtus.
    - endDate = null
    - objectStatus = CURRENT
2. Süsteem arhiveerib leitud lõpetamata alamhindamised.
  - Süsteem uuendab leitud Objektid#Assessment objekte:
    - archivedAt = Päringu käivitamise aeg.
Kui kasutaja kinnitab hindamise tulemuste etapi, siis:
1. Süsteem lisab hindamise käigus kirjeldatud väljakutsete andmed planeerimise mooduli andmetesse (Ainult mittehierarhilised hindamised ja hierarhilised peamised hindamised (assessmentHierarchyType = null või MAIN_ASSESSMENT (!= SUB_ASSESSMENT)). Hierarhiliste alamhindamiste kohta väljakutseid luua ei tohi).
  1. Süsteem otsib hindamise käigus kirjeldatud väljakutsed
    - Süsteem otsib Objektid#AssessmentResultSectionElement objekte, mille:
      - code = CHALLENGE
      - textAreaValue != null
      - objectStatus = CURRENT
  2. Süsteem otsib leitud väljakutsetega seotud väljakutse liigid, teemad ja olulisused.
    - Süsteem otsib Objektid#AssessmentResultSectionElement objekte, mille:
      - assessmentResultSectionId = Eelnevalt leitud Objektid#AssessmentResultSectionElement.assessmentResultSectionId väärtused.
      - code = CHALLENGE_TYPE, TOPIC, IMPORTANCE
      - objectStatus = CURRENT
  3. Süsteem loob iga kirjeldatud väljakutse kohta (assessmentResultSectionId) väljakutse andmed planeerimis moodulisse:
    - Süsteem loob Objektid#AssessmentChallenge objektid iga leitud assessmentResultSectionId kohta:
      - id = UUID
      - assessment.id = Assessment.id
      - assessment.assessmentModelId = Assessment.assessmentModelId
      - assessment.domain = Assessment.domain
      - assessment.assessmentType = Assessment.assessmentType
      - assessment.assessmentScope = Assessment.assessmentScope
      - assessment.personalCode = Assessment.personalCode
      - assessment.jobsite= Assessment.jobsite
      - assessment.startDate = Assessment.startDate
      - assessment.endDate = Assessment.endDate
      - assessment.institution = Assessment.institution
      - assessment.institution.id = Assessment.institution.id
      - assessment.institution.type = Assessment.institution.type
      - elements.id = UUID
      - elements.assessmentResultSectionElementId = AssessmentResultSectionElement.id
      - elements.code = AssessmentResultSectionElement.code
      - elements.label =AssessmentResultSectionElement.label
      - elements.inputType =AssessmentResultSectionElement.inputType
      - elements.scale =AssessmentResultSectionElement.scale
      - elements.scale.valuesFrom =AssessmentResultSectionElement.scale.valuesFrom
      - elements.scale.valuesUntil =AssessmentResultSectionElement.scale.valuesUntil
      - elements.scale.selectedValue =AssessmentResultSectionElement.scale.selectedValue
      - elements.textAreaValue =AssessmentResultSectionElement.textAreaValue
      - elements.ehisClassifierCode =AssessmentResultSectionElement.ehisClassifierCode
      - elements.selectedEhisClassifierItems =AssessmentResultSectionElement.selectedEhisClassifierItems
      - objectStatus = CURRENT
      - audit = audit (andmete loomine)
Teavituste saatmine
1. Süsteem otsib olenevalt kinnitatavast etapist, kas hindamise planeerimise etapi või enesehindamise või välishindamise kinnitamise 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
        Kui sisendis esitatud etapi AssessmentPhase.phaseType = PLANNING, siis ClassifierAttributeValue.classifierAttributeDefinitionCode = CONFIRM_PLAN_MESSAGE_DEFINITION
        Kui sisendis esitatud etapi AssessmentPhase.phaseType = SELF_ASSESSMENT, siis ClassifierAttributeValue.classifierAttributeDefinitionCode = CONFIRM_SELF_ASSESSMENT_MESSAGE_DEFINITION
        Kui sisendis esitatud etapi AssessmentPhase.phaseType = EXTERNAL_ASSESSMENT, siis ClassifierAttributeValue.classifierAttributeDefinitionCode = CONFIRM_EXTERNAL_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
      - Kui sisendis esitatud etapi AssessmentPhase.phaseType = PLANNING, siis messageActionType = CONFIRM_PLAN
      - Kui sisendis esitatud etapi AssessmentPhase.phaseType = SELF_ASSESSMENT, siis messageActionType = CONFIRM_SELF_ASSESSMENT
      - Kui sisendis esitatud etapi AssessmentPhase.phaseType = EXTERNAL_ASSESSMENT, siis messageActionType = CONFIRM_EXTERNAL_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
        Etappide ülesed muutujad
        []
        name = INSTITUTION_NAME
        value = Assessment.institution.name
        []
        name = ASSESSMENT_PHASE_CONFIRMATION_DATE
        value = Kinnitatud etapi AssessmentPhase.confirmationTime (DD.MM.YYYY vormingus)
        Planeerimise etapi muutujad
        []
        name = ASSESSMENT_PHASE_END_DATE
        value = Hindamise ükskõik mille etapi algus või lõpp on suurim DD.MM.YYYY vormingus. Suurim AssessmentPhase.endDate või startDate, mille assessmentId = id väärtus sisendist.
        []
        name =ELEMENT_LABELS_AND_VALUES
        value = Kinnitatud etapi AssessmentPlanningSection.name, mille assessmentId = AssessmentPhase.assessmentId ja messageRequired = true (Väärtused esitatakse html bullet nimekirjana. Iga leitud väärtus uuel real.)
        []
        name =TEAM_MEMBER_DATA
        value = AssessmentTeamMember.firstName + lastName + (phoneNumber, email), mille roleType = TEAM_LEAD ja objectStatus = CURRENT (Väärtused esitatakse html bullet nimekirjana. Iga leitud väärtus uuel real.)
        Enesehindamise etapi muutujad
        []
        name = ASSESSMENT_PHASE_END_DATE
        value = AssessmentPhase.endDate (DD.MM.YYYY vormingus), mille phaseType = EXTERNAL_ASSESSMENT
        []
        name = ASSESSMENT_MODEL_NAME
        value = AssessmentModel.name, mille id = Assessment.assessmentModelId
        Välishindamise etapi muutujad
        []
        name = ASSESSMENT_MODEL_NAME
        value = AssessmentModel.name, mille id = Assessment.assessmentModelId
Kui kinnitatav etapp on viimane etapp, siis:
- Tingimus:
  1. Objektid#AssessmentPhase.seqNo on muudetava hindamise raames suurim.
- Tegevused:
  1. Süsteem märgib hindamise lõpetatuks.
    - Süsteem uuendab leitud Objektid#Assessment objekti:
      - endDate = Päringu käivitamise kuupäev.
      - audit (muutmine) = audit (muutmine)
  2. Süsteem kustutab hindamise käigus loodud hindamise kokkuvõtte pdf failid süsteemist.
    1. Süsteem otsib hindamise käigus loodud hindamise kokkuvõtte pdf failide andmed.
      - Süsteem otsib Objektid#AssessmentSummary objekte, mille:
        assessmentId = Sisendis esitatud id väärtus.
        assessmentSummaryType = PDF
        objectStatus = CURRENT
        Kui ühtegi faili objekti ei leitud, siis jätkatakse päringu töötlust järgmises sammus. Failide kustutamise töötlemine lõpetatakse.
    2. Süsteem kustutab hindamise käigus loodud kokkuvõtte andmed.
      - Süsteem kustutab leitud Objektid#AssessmentSummary objektid.
    3. Süsteem kustutab leitud failide metaandmed andmebaasist.
      - Süsteem kustutab Objektid#File objektid, mille File.id = AssessmentSummary.files.id
    4. Süsteem kustutab kustutatud failide metaandmetega seotud failid failihoidlast.
Süsteem tagastab muudetud andmed.

GS: Assessment: API: PATCH /quality-api/assessments/{id}/phases/{phaseId}/confirmation-time

Üldkirjeldus

Eeltingimused ja kasutusõigused

Sisendid

Väljundid

Tegevused