NSILM

GS: Assessment: API: POST /quality-api/assessment-reset

Muutja: Andres Mill · 2025-06-17

Üldkirjeldus

Teenus võimaldab lähtestada hindamise hindamise. Hindamise lähtestamine tähendab, et hindamine kustutatakse ja sama hindamise liigiga luuakse uus hindamismudel. 

Lähtestamine tähendab äriliselt seda, et hindamise andmed kustutatakse ja luuakse uus sama hindamise liigiga hindamine. Uueks meeskonnajuhiks määratakse hindamise lähtestanud kasutaja.

NSIL-356 - Getting issue details... STATUS NSIL-612 - Getting issue details... STATUS NSIL-727 - Getting issue details... STATUS NSIL-770 - Getting issue details... STATUS NSIL-1020 - Getting issue details... STATUS NSIL-1177 - Getting issue details... STATUS

Seotud andmeobjektid:


Eeltingimused ja kasutusõigused

Sisendid

AtribuutKohustuslikkus, mitmesusTüüpVaikeväärtus, valideerimineKirjeldus, täiendav info
assessmentId1String (PK)
  • Hindamine ei tohi olla lõpetatud.
    • Assessment.endDate = null
  • Hindamine ei tohi olla kustutatud.
    • Assessment.objectStatus = CURRENT
Viide hindamisele (UUID), mida soovitakse lähtestada.

Väljundid

AtribuutKohustuslikkus, mitmesusTüüpKirjeldus, täiendav info
newAssessmentId1String (PK)

Uue hindamise id (UUID).

Tegevused

  1. Süsteem otsib päringus esitatud tingimustele vastava lõpetamata hindamise.
    • Süsteem otsib Objektid#Assessment objekti, mille:
      • id = Sisendis esitatud assessmentId.
      • archivedAt = null
      • assessmentHierarchyType = null või MAIN_ASSESSMENT (!= SUB_ASSESSMENT)
      • endDate = null
      • objectStatus = CURRENT
        1. Kui tingimustele vastavat objekti ei leitud, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  2. Süsteem kontrollib, kas kasutajal on õigus hindamist lähtestada.
    1. Sisendis esitatud hindamise asutus on KOV ja kasutajal on seos sisendis esitatud asutusega ja kasutajal on valdkonna hindamiste haldamise õigus. 
        • Privileegi olemasolu:
          • Classifier.definitionCode = DOMAIN
          • Classifier.classifierAttributeDefinitionCode = ASSESSMENT_RESET_ASSESSMENT_PRIVILEGE 
          • Classifier.attributeValue = Kasutaja poolt valitud asutusega seotud privileegide hulgas olevad privileegid.
        • Leitud Objektid#Assessment objekt peab vastama järgnevatele tingimustele:
          • institution.type = LOCAL_GOVERNMENT
          • institution.id = Kasutajaga seotud asutuste hulgas olev asutus.
          • domainType = Classifier.classifierItemCode, mille
              • Classifier.definitionCode = DOMAIN
              • Classifier.classifierAttributeDefinitionCode = ASSESSMENT_RESET_ASSESSMENT_PRIVILEGE 
              • Classifier.attributeValue = Hindamisega seotud asutusega seotud privileegide hulgas olevad privileegid.
          • assessmentScope = INSTITUTIONAL
    2. Sisendis esitatud asutus on õppeasutus ja kasutajal on seos sisendis esitatud asutusega ja kasutajal on valdkonna hindamiste haldamise õigus.
      • Privileegi olemasolu:
        • Classifier.definitionCode = DOMAIN
        • Classifier.classifierAttributeDefinitionCode = ASSESSMENT_RESET_ASSESSMENT_PRIVILEGE 
        • Classifier.attributeValue = Kasutaja poolt valitud asutusega seotud privileegide hulgas olevad privileegid.
      • Leitud Objektid#Assessment objekt peab vastama järgnevatele tingimustele:
        1. Asutuse tüübile avatud hindamismudel
          • domainType = Classifier.classifierItemCode, mille
              • Classifier.definitionCode = DOMAIN
              • Classifier.classifierAttributeDefinitionCode = ASSESSMENT_RESET_ASSESSMENT_PRIVILEGE 
              • Classifier.attributeValue = Kasutaja poolt valitud asutusega seotud privileegide hulgas olevad privileegid.
          • institution.type = EDUCATIONAL_INSTITUTION
          • institution.id = Kasutajaga seotud asutuste hulgas olev asutus.
          • assessmentScope = INSTITUTIONAL
    3. Sisendis esitatud hindamise tüüp on isikupõhine hindamine ja päringu käivitanud kasutaja on isik, kelle kohta hindamine tehakse.
      • Leitud Objektid#Assessment peab vastama järgnevatele tingimustele:
        • assessmentScope = INDIVIDUAL
        • personalCode = Päringu käivitanud kasutaja.
    4. Kui leitud hindamismudel ei vasta eelnevalt kirjeldatud õiguste kontrolli reeglitele, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  3. 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.
  4. Süsteem kontrollib, kas leitud hindamise hindamise liigiga on olemas kehtiv hindamismudel.
    • Süsteem otsib  objekti Objektid#AssessmentModel, mille
      • assessmentType = Assessment.assessmentType
      • assessmentHierarchyType = null või MAIN_ASSESSMENT (!= SUB_ASSESSMENT)
      • confirmed = true
      • validFrom <= päringu teostamise aeg
      • validUntil > päringu teostamise aeg
      • assessmentScope = Assessment.assessmentScope
      • jobsites hulgas on Assessment.jobsite
      • objectStatus = CURRENT
        1. Kui tingimustele vastavat objekti ei leitud, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood ja äriline veakood, mille alusel kasutajaliideses ärilist veateadet saaks kuvada.
  5. Süsteem loob uue hindamise koos mudelile lisatud failidega.
    • Uue hindamise loomine (,sh failide lisamine mudelist ja PBI aruannetest piltide loomine) käib samamoodi nagu GS: Assessment: API: POST /quality-api/assessments (Meeskonnajuhiks määratakse käesoleva päringu käivitanud kasutaja). Sisend:
      • institution.id = Leitud Assessment.assessmentType.institution.id
      • assessmentType = Leitud Assessment.assessmentType
  6. Süsteem kustutab leitud hindamise koos selle alaobjektidega füüsiliselt andmebaasist ning objektidega seotud failid failisüsteemist.
    • Objektid:
      • Assessment, mille id = Sisendis esitatud assessmentId.
      • AssessmentComponentElement, mille assessmentId = Sisendis esitatud assessmentId.
      • AssessmentComponentReportTab, mille assessmentId = Sisendis esitatud assessmentId.
      • AssessmentComponentSection, mille assessmentId = Sisendis esitatud assessmentId.
      • AssessmentPhase, mille assessmentId = Sisendis esitatud assessmentId.
      • AssessmentPhaseAssignment, mille assessmentId = Sisendis esitatud assessmentId.
      • AssessmentPlanningSection, mille assessmentId = Sisendis esitatud assessmentId.
      • AssessmentPlanningSectionElement, mille assessmentId = Sisendis esitatud assessmentId.
      • AssessmentResultSection, mille assessmentId = Sisendis esitatud assessmentId.
      • AssessmentResultSectionElement, mille assessmentId = Sisendis esitatud assessmentId.
      • AssessmentTask, mille assessmentId = Sisendis esitatud assessmentId.
      • AssessmentTaskAssignee, mille assessmentId = Sisendis esitatud assessmentId.
      • AssessmentTeamMember, mille assessmentId = Sisendis esitatud assessmentId.
      • AssessmentSummary, mille assessmentId = Sisendis esitatud assessmentId.
      • File, mille id = Kustutatud AssessmentComponentElement.files.id ja AssessmentPlanningSectionElement.files.id ja AssessmentSummary.files.fileId väärtused.
  7. Kui tegemist on peamise hierarhilise hindamisega (Assessment.assessmentHierarchyType = MAIN_ASSESSMENT), siis:
    1. Süsteem otsib peamise hindamise alamhindamised.
      • Süsteem otsib Objektid#Assessment objekte, mille:
        • parentAssessmentId = Sisendis esitatud assessmentId.
        • objectStatus = CURRENT
    2. Süsteem kustutab füüsiliselt andmebaasist ja failihoidlast leitud alamhindamised ja nende alaobjektid ja objektidega seotud failid.
      • Vaata p6.
  8. Süsteem kustutab kustutatud kustutatud File objektidega seotud failid failisüsteemist.
  9. 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
            1. 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]
            • [1]
              • name = ASSESSMENT_START_DATE
              • value = Assessment.startDate (DD.MM.YYYY vormingus)
  10. Süsteem tagastab uue hindamise id.