NSILM

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

Muutja: Andri Frolov · 2025-05-08

Üldkirjeldus

Teenus võimaldab otsida hindamisega seotud meeskonnaliikmete andmeid.

Seotud andmeobjektid:

NSIL-127 - Getting issue details... STATUS NSIL-834 - Getting issue details... STATUS

Eeltingimused ja kasutusõigused

  • Kui tegemist on asutusepõhise hindamisega (assessmentScope = INSTITUTIONAL):
    • Kasutajal peab olema hindamise valdkonnaga seotud hindamise meeskonna liikmete andmete vaatamise õigus ja kasutaja peab olema seotud asutusega, mis on seotud hindamisega. 
      • Classifier.classifierItemCode = Assessment.domain
      • Classifier.classifierAttributeDefinitionCode = ASSESSMENT_VIEW_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 (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).
    • Kasutajal peab olema hindamise valdkonnaga seotud hindamise meeskonna liikmete andmete vaatamise õ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_VIEW_PRIVILEGE
      • Classifier.attributeValue = Kasutaja poolt valitud rolli privileegide hulgas olev privileeg.

Sisendid

AtribuutKohustuslikkus, mitmesusTüüpVaikeväärtus, valideerimineKirjeldus, täiendav info
id1String
  • Hindamine ei tohi olla kustutatud.
    • Assessment.objectStatus = CURRENT
Hindamise id.
personalCode0..1String
Meeskonna liikme isikukood.
roleTypes0..*EHIS Classifier list
Meeskonna liikme roll hindamisel.

Väljundid

AtribuutKohustuslikkus, mitmesusTüüpKirjeldus, täiendav info
teamMembers0..*Array

Nimekiri hindamisega seotud isikutest.

Nimekirja objektid on sama struktuuriga nagu 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 meeskonnaliikmete andmed.
    • Süsteem otsib Objektid#Assessment.teamMembers.member objektid, mille
      • Assessment.id = Sisendis esitatud id väärtus.
      • Assessment.objectStatus = CURRENT
      • Assessment.teamMembers.member.personalCode = Sisendis esitatud personalCode väärtus.
      • Assessment.teamMembers.member.roleType = Sisendis esitatud roleTypes väärtused.
      • Assessment.teamMembers.member.objectStatus = CURRENT 
  4. Süsteem tagastab leitud andmed.