NSILM

GS: Assessment: API: PUT /quality-api/assessments/{id}/team-members/{memberId}

Muutja: Andres Mill · 2025-08-28

Üldkirjeldus

Teenus võimaldab salvestada meeskonnaliikme andmed hindamisele.

Seotud andmeobjektid:

NSIL-146 - Getting issue details... STATUS NSIL-834 - Getting issue details... STATUS NSIL-1246 - Getting issue details... STATUS

Eeltingimused ja kasutusõigused

  • Kui tegemist on asutusepõhise hindamisega (assessmentScope = INSTITUTIONAL):
    • Kasutajal peab olema hindamise valdkonnaga seotud hindamise meeskonnaliikme andmete haldamise õigus ja kasutajaga seotud asutus peab olema seotud hindamisega (ASSESSMENT_TEAM_MEMBER_MANAGE_PRIVILEGE seotud nõuded). 
      • Classifier.classifierItemCode = Assesment.domain
      • Classifier.classifierAttributeDefinitionCode = ASSESSMENT_TEAM_MEMBER_MANAGE_PRIVILEGE
      • Classifier.attributeValue = Kasutaja poolt valitud rolli privileegide hulgas olev privileeg.
      • Assesment.institution.id = Kasutaja poolt valitud rolliga seotud asutus.
    • VÕI kui kasutaja muudab enda andmeid, siis peab tal olema enda andmete muutmise õigus ja kasutajaga seotud asutus peab olema seotud hindamisega (ASSESSMENT_TEAM_MEMEBER_ADDITIONAL_DATA_MANAGE_PRIVILEGE seotud nõuded).
      • Classifier.classifierItemCode = Assesment.domain
      • Classifier.classifierAttributeDefinitionCode = ASSESSMENT_TEAM_MEMEBER_ADDITIONAL_DATA_MANAGE_PRIVILEGE
      • Classifier.attributeValue = Kasutaja poolt valitud rolli privileegide hulgas olev privileeg.
      • Assesment.institution.id = Kasutaja poolt valitud rolliga seotud asutus.
      • Assesment.teamMembers.member.personalCode (mille member.id = sisendis memberId, member.objectStatus = CURRENT) = Kasutaja isikukood.
  • Kui tegemist on isikupõhise hindamisega (assessmentScope =INDIVIDUAL) ja mittehierarhilise hindamisega või hierarhilise hindamise peamise hindamisega (assessmentHierarchyType = null või MAIN_ASSESSMENT (assessmentScope = INDIVIDUAL!= SUB_ASSESSMENT)):
    • Päringu käivitanud kasutaja on isik, kelle suhtes hindamist läbi viiakse.
      • Assessment.presonalCode = Päringu käivitanud isiku isikukood.
    • Päringu käivitanud kasutaja on seotud  hindamisega seotud asutusega.
      • Assessment.institution.id = Kasutaja poolt valitud rolliga seotud asutus.
    • Päringu käivitanud kasutajal on hindamisega seotud asutuses hindamisega seotud ametikoht.
      • Assessment.jobSite = Kasutaja poolt valitud rolliga seotud asutusega seotud ametikoht.
  • Kui kasutaja on hindamise meeskonna liige (Kehtib asutusepõhistel ja isikupõhistel hindamistel).
    • Kasutajal peab olema hindamise valdkonnaga seotud hindamise meeskonnaliikme andmete haldamise õigus töödeldava hindamisega seoses ja kasutaja peab olema seotud hindamisega. (ASSESSMENT_TEAM_MEMBER_MANAGE_PRIVILEGE seotud nõuded). 
      • AssessmentTeamMember.personalCode = Päringu käivitanud isiku isikukood.
      • AssessmentTeamMember.objectStatus = CURRENT
      • Classifier.classifierItemCode = Assesment.domain
      • Classifier.classifierAttributeDefinitionCode = ASSESSMENT_TEAM_MEMBER_MANAGE_PRIVILEGE
      • Classifier.attributeValue = Kasutaja poolt valitud rolli privileegide hulgas olev privileeg.
    • VÕI kui kasutaja muudab enda andmeid, siis peab tal olema enda andmete muutmise õigus töödeldava hindamisega seoses ja kasutaja peab olema seotud hindamisega. (ASSESSMENT_TEAM_MEMEBER_ADDITIONAL_DATA_MANAGE_PRIVILEGE seotud nõuded).
      • AssessmentTeamMember.personalCode = Päringu käivitanud isiku isikukood.
      • AssessmentTeamMember.objectStatus = CURRENT
      • Classifier.classifierItemCode = Assesment.domain
      • Classifier.classifierAttributeDefinitionCode = ASSESSMENT_TEAM_MEMEBER_ADDITIONAL_DATA_MANAGE_PRIVILEGE
      • Classifier.attributeValue = Kasutaja poolt valitud rolli privileegide hulgas olev privileeg.
      • Assesment.teamMembers.member.personalCode (mille member.id = sisendis memberId, member.objectStatus = CURRENT) = Kasutaja isikukood.
  • Kui tegemist on isikupõhise hierarhilise hindamise alamhindamisega (assessmentHierarchyType = SUB_ASSESSMENT), siis meeskonna liikmeid muuta ei saa.


Sisendid

AtribuutKohustuslikkus, mitmesusTüüpVaikeväärtus, valideerimineKirjeldus, täiendav info
id1String
  • Hindamine ei tohi olla kustutatud.
    • Assesment.objectStatus = CURRENT
  • Hindamine ei tohi olla lõpetatud.
    • Assesment.endDate > Päringu teostamise aeg või Assesment.endDate = null.
Hindamise id.
memberId1String
  • Meeskonna liige ei tohi olla kustutatud ja meeskonna liige, kelle kohta andmeid päritakse, peab olema päringu käivitanud isik.
    • AssessmentTeamMember.id = Esitatud memberId
    • AssessmentTeamMember.assessmentId = Esitatud id väärtus.
    • AssessmentTeamMember.objectStatus = CURRENT
  • Kui tegemist on isikupõhise hierarhilise hindamise peamise hindamisega ja meeskonna liikmele on kaasatud hindamine suunatud ja hindamise enesehindamine on kinnitatud, siis tema andmeid muuta ei saa.
    • Assessment.assessmentHierarchyType  = MAIN_ASSESSMEN
    • AssessmentTeamMember.subAssessmentId != null
    • AssessmentPhase.confirmationTime != null, mille AssessmentPhase.assessmentId = Sisendis esitatud id ja AssessmentPhase.phaseType = Enesehindamine
Meeskonna liikme id.
roleType1EHIS Classifier
  • Peab olema Klassifikaatorid#KlassifikaatorASSESSMENT_ROLE hulgas kehtiv kirje.
  • Saab muuta, kui kasutajal on privileegiga ASSESSMENT_TEAM_MEMBER_MANAGE_PRIVILEGE seotud nõuded täidetud.
  • Kui muudetav meeskonnaliige on hindamises viimane juht, siis tema rolli muuta ei saa.
  • Kui tegemist on isikupõhise hindamisega ja kui muudetakse meeskonna liikme andmeid, kelle suhtes hindamist tehakse, siis ei saa rolli muuta.
    • Assessment.assessmentScope = INDIVIDUAL ja memberId = AssessmentTeamMember.id, mille AssessmentTeamMember.personalCode = Assessment.personalCode 
  • Kui tegemist on isikupõhise hindamisega ja kui muudetakse meeskonna liikme andmeid, kes suhtes hindamist ei tehta, siis ei saa tema rolli muuta meeskonnajuhiks.
    • Assessment.assessmentScope = INDIVIDUAL ja memberId != AssessmentTeamMember.id, mille AssessmentTeamMember.personalCode = Assessment.personalCode
  • Kui tegemist on isikupõhise hierarhilise hindamise peamise hindamisega, siis saab muuta ainult enesehindaja ja välishindaja rolli tüüpi.
    • Assessment.assessmentScope = INDIVIDUAL ja Assessment.assessmentHierarchyType = MAIN_ASSESSMENT
    • roleType = Enesehindaja või välishindaja.
  • Kui Assessment.assessmentScope = INSTITUTIONAL, siis sisendis esitada Klassifikaatorid#KlassifikaatorASSESSMENT_ROLE väärtuse, mille ROLE_SCOPE (klassfikaatori atribuut) = DEFAULT_ROLE
  • Kui tegemist on asutusepõhise hindamisega, siis on lubatud kasutada ainult vaikimisi rolle (juht, enesehindaja, välishindaja)
Meeskonna liikme roll hindamisel. 
email0..1String
  • Peab vastama e-posti aadressi reeglitele.
  • Saab muuta, kui kasutajal on privileegi ASSESSMENT_TEAM_MEMBER_MANAGE_PRIVILEGE või ASSESSMENT_TEAM_MEMEBER_ADDITIONAL_DATA_MANAGE_PRIVILEGE seotud nõuded täidetud.
  • Kuni 250 tähemärki.
  • Kohustuslik, kui muudetava isiku roll on 360 roll.
Meeskonna liikme e-posti aadress.
phoneNumber

0..1

String
  • Saab muuta, kui kasutajal on privileegiga ASSESSMENT_TEAM_MEMEBER_ADDITIONAL_DATA_MANAGE_PRIVILEGE seotud nõuded täidetud.
  • Lubatud kuni 12 tähemärki.
Meeskonna liikme telefoninumber
institution

0..1

String
  • Saab muuta, kui kasutajal on privileegiga ASSESSMENT_TEAM_MEMEBER_ADDITIONAL_DATA_MANAGE_PRIVILEGE seotud nõuded täidetud.
  • Kuni 250 tähemärki.
Meeskonna liikme asutus
jobTitle

0..1

String
  • Saab muuta, kui kasutajal on privileegiga ASSESSMENT_TEAM_MEMEBER_ADDITIONAL_DATA_MANAGE_PRIVILEGE seotud nõuded täidetud.
  • Kuni 250 tähemärki.
Meeskonna liikme ametinimetus
competences

0..*

EHIS Classifier list

Meeskonnaliikme tegevusvaldkonnad nimetus.


vocations

0..*

Array
  • Saab muuta, kui kasutajal on privileegiga ASSESSMENT_TEAM_MEMEBER_ADDITIONAL_DATA_MANAGE_PRIVILEGE seotud nõuded täidetud.
  • Iga element kuni 250 tähemärki.
Meeskonna liikme kehtivad kutsestandardi nimetused.

Väljundid

AtribuutKohustuslikkus, mitmesusTüüpKirjeldus, täiendav info
Sama, mis GS: Assessment: API: POST /quality-api/assessments/{id}/team-members#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 hindamisega seotud meeskonnaliikme andmed.
    • Süsteem otsib Objektid#Assessment.Assesment.teamMembers.member objekti, mille
      • Assesment.id = Sisendis esitatud id väärtus.
      • Assesment.objectStatus = CURRENT
      • Assesment.teamMembers.member.id = memberId väärtus sisendist.
      • Assesment.teamMembers.member.objectStatus = CURRENT 
        1. Kui tingimustele vastavat objekti ei leitud, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  4. Süsteem muudab hindamise meeskonnaliikme andmeid.
    • Süsteem muudab leitud Objektid#Assessment.teamMembers.member objekti andmeid:
      • roleType = Sisendis esitatud roleType väärtus.
      • email = Sisendis esitatud email väärtus.
      • phoneNumber = Sisendis esitatud phoneNumber väärtus.
      • institution = Sisendis esitatud institution väärtus.
      • jobTitle = Sisendis esitatud jobTitle väärtus.
      • competences = Sisendis esitatud competences väärtused.
      • vocations = Sisendis esitatud vocations väärtused.
      • audit (muutmine) = audit (muutmine)
  5. Süsteem tagastab muudetud andmed.