NSILM

GS: Assessment: API: POST /quality-api/assessments/{assessmentId}/phases/{phaseId}/delete-confirmation-time

Muutja: Andres Mill · 2025-05-02

Üldkirjeldus

Teenus võimaldab eemaldada hindamise etapi kinnituse.

Seotud andmeobjektid:


NSIL-380 - Getting issue details... STATUS NSIL-772 - Getting issue details... STATUS NSIL-832 - Getting issue details... STATUS NSIL-1081 - Getting issue details... STATUS

Eeltingimused ja kasutusõigused

  • Kui tegemist on asutusepõhise hindamisega (assessmentScope = INSTITUTIONAL):
    • Kui kasutaja suunab hindamise välishindamise etapist enesehindamise etappi, 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.
  • Kui tegemist on isikupõhise hindamisega (Assessment.assessmentScope =INDIVIDUAL) ja mittehierarhilise hindamisega või hierarhilise hindamise peamise hindamisega (Assessment.assessmentHierarchyType = null või MAIN_ASSESSMENT (!= SUB_ASSESSMENT)):
    • Päringu käivitanud kasutaja on isik, kelle suhtes hindamist läbi viiakse.
      • Assessment.presonalCode = 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.presonalCode = 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 suunab hindamise välishindamise etapist enesehindamise etappi, 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.

Sisendid

AtribuutKohustuslikkus, mitmesusTüüpVaikeväärtus, valideerimineKirjeldus, täiendav info
assessmentId1String
  • 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.
phaseId1String
  • Etapp ei tohi olla kustutatud.
    • Assessment.phases.phase.objectStatus = CURRENT
  • Sisendis saab esitada ainult enesehindamise etappi.
  • Enesehindamise etapi kinnitust saab eemaldada, kui enesehindamise etapp on kinnitatud ja hindamisel on välishindamise etapp ja välishindamise etapp on kinnitamata.
Hindamise etapi id (UUID), millelt eemaldatakse etapi kinnitus.
comment1String
  • Peab olema 3 - 1000 tähemärki.
Etapi kinnituse eemaldamise kommentaar.

Väljundid

AtribuutKohustuslikkus, mitmesusTüüpKirjeldus, täiendav info
GS: Assessment: API: PUT /quality-api/assessments/{id}/phases/{phaseId}#V%C3%A4ljundid

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 kontrollib, kas andmed vastavad nõuetele.
    1. Kui andmed ei vasta nõuetele, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  3. 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.
  4. Süsteem kustutab hindamise etapi kinnituse.
    • Süsteem uuendab leitud Objektid#Assessment.phases.phase objekti:
      • confirmationTime = null
      • audit (muutmine) = audit (muutmine)
  5. Süsteem lisab etapi kinnituse eemaldamise kohta logi.
    • Süsteem loob Objektid#AssessmentPhaseAssignment objekti:
      • id = UUID
      • assessmentId = Sisendis esitatud assessmentId väärtus.
      • previousPhaseType = Välishindamine
      • newPhaseType = Enesehindamine
      • comment = Sisendis esitatud comment väärtus.
      • initiator = Päringu käivitanud kasutaja andmed.
      • audit (loomine) = audit (loomine)
      • objectStatus = CURRENT
  6. Teavituste saatmine
    1. Süsteem otsib hindamise enesehindamise etappi tagasi täpsustamiseks 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 = IMPROVE_SELF_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 = IMPROVE_SELF_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
            • []
              • name = INSTITUTION_NAME
              • value = Assessment.institution.name
            • []
              • name = ASSESSMENT_PHASE_RETURN_DATE
              • value = Päringu käivitamise kuupäev (DD.MM.YYYY vormingus)
            • []
              • name = ASSESSMENT_MODEL_NAME
              • value = AssessmentModel.name, mille id = Assessment.assessmentModelId
  7. Süsteem tagastab muudetud andmed.