NSILM

GS: Assessment: API: GET /quality-api/assessments/{id}/team-members/{memberId}/vocations-from-estonian-qualifications-authority-systems

Muutja: Andres Mill · 2025-05-17

Üldkirjeldus

Teenus võimaldab otsida hindamisega seotud meeskonnaliikme andmeid kutseregistrist.

Seotud andmeobjektid:

NSIL-834 - Getting issue details... STATUS NSIL-1100 - 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 haldamise õigus ja kasutaja peab olema seotud asutusega, mis on seotud hindamisega. 
      • Classifier.classifierItemCode = Assessment.domain
      • Classifier.classifierAttributeDefinitionCode =ASSESSMENT_TEAM_MEMEBER_ADDITIONAL_DATA_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 (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.presonalCode = Päringu käivitanud isiku isikukood.
  • Kui kasutaja on hindamise meeskonna liige (Kehtib asutusepõhistel ja isikupõhistel hindamistel).
    • Kasutajal peab olema hindamise valdkonnaga seotud hindamise meeskonna liikmete 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_TEAM_MEMEBER_ADDITIONAL_DATA_MANAGE_PRIVILEGE
      • Classifier.attributeValue = Kasutaja poolt valitud rolli privileegide hulgas olev privileeg.
  • Kui tegemist on isikupõhise hierarhilise hindamise alamhindamisega (assessmentHierarchyType = SUB_ASSESSMENT), siis objekti andmeid hallata 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.personalCode = Päringu käivitanud isiku isikukood.
    • AssessmentTeamMember.objectStatus = CURRENT
Meeskonna liikme id.

Väljundid

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

Meeskonna liikme kehtivate kutsestandardite nimetused Kutseregistrist.

Väärtused: X-tee teenused#kutsetunnistusHTM.response.kutsetunnistusHTMVastus.kutsetunnistused.standard, mille kehtibkuni >= Päringu teostamise kuupäev.

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.Assesment.teamMembers.member objektid, mille
      • Assesment.id = Sisendis esitatud id väärtus.
      • Assesment.objectStatus = CURRENT
      • Assesment.teamMembers.member.id = Sisendis esitatud memberId.
      • Assesment.teamMembers.member.personalCode = Päringu käivitanud kasutaja isikukood.
      • Assesment.teamMembers.member.objectStatus = CURRENT 
        1. Kui tingimustele vastavat isikut ei leitud, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  4. Süsteem käivitab Kutseregistri päringu X-tee teenused#kutsetunnistusHTM. Sisend:
    • isikukood = Assesment.teamMembers.member.personalCode
  5. Süsteem tagastab leitud andmed.