NSILM

GS: Assessment: API: PUT /quality-api/assessments/{id}/tasks/{taskId}

Muutja: Andres Mill · 2025-01-20

Üldkirjeldus

Teenus võimaldab muuta hindamisega seotud tööülesandeid.

Seotud andmeobjektid:

NSIL-169 - 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 tööülesannete haldamise õigus ja kasutaja peab olema seotud asutusega, mis on seotud hindamisega. 
      • Classifier.classifierItemCode = Assessment.domain
      • Classifier.classifierAttributeDefinitionCode = ASSESSMENT_TASK_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):
    • 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 tööülesannete 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_TASK_MANAGE_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
    • Hindamine ei tohi olla lõpetatud.
      • Assesment.endDate > Päringu teostamise aeg või Assesment.endDate = null
Hindamise id.
taskId1String
  • Ülesanne ei tohi olla kustutatud.
    • Assessment.planning.tasks.task.objectStatus = CURRENT
  • Tööülesanne ei tohi olla tehtud.
    • Assessment.planning.tasks.task.status != DONE
Tööülesande id.
assessmentPhaseId1String
  • Etapp peab olema määratud hindamisele ja etapi algus ja lõpp peab olema määratud.
    • Assessment.phases.phase.id = Sisendis esitatud assessmentPhaseId väärtus.
    • Assessment.phases.phase.objectStatus = CURRENT
    • Assessment.phases.phase.startDate != null
    • Assessment.phases.phase.endDate != null
Hindamise etapp, millega tööülesanne on seotud.
activityName

1

String

Peab olema 3-250 tähemärki pikk.

Tööülesande tegevuse nimetus.
activityDescription

0..1

StringLubatud kuni 1000 tähemärki.Tegevuse kirjeldus.
startDate

0..1

Date
  • Tööülesanne peab ajaliselt kuuluma sellesse etappi, millesse tööülesanne lisati ja tööülesande algus ei tohi olla hilisem tööülesande lõpust.
    • Assessment.phases.phase.startDate <= Sisendis esitatud startDate väärtus <= Sisendis esitatud endDate väärtus <= Assessment.phases.phase.endDate
Tööülesande algusaeg.
endDate

1

Date
  • Tööülesanne peab ajaliselt kuuluma sellesse etappi, millesse tööülesanne lisati ja tööülesande algus ei tohi olla hilisem tööülesande lõpust.
    • Assessment.phases.phase.startDate <= Sisendis esitatud startDate väärtus <= Sisendis esitatud endDate väärtus <= Assessment.phases.phase.endDate
Tööülesande tähtaeg.
assignees.teamMemberId

1..*

Array
  • Tööülesande täitjad peavad olema seotud hindamisega.
    • Assessment.teamMembers.member.id = Sisendis esitatud assignees.teamMemberId väärtused
    • Assessment.teamMembers.member.objectStatus = CURRENT
  • Sama meeskonna liige saab olla ülesandega seotud ühe korra.
Nimekiri tööülesande vastutajates.

Väljundid

AtribuutKohustuslikkus, mitmesusTüüpKirjeldus, täiendav info
GS: Assessment: API: POST /quality-api/assessments/{id}/tasks#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 tööülesande andmed.
    • Süsteem otsib Objektid#Assessment.planning.tasks.task objekti, mille:
      • Assessment.id = Sisendis esitatud id väärtus.
      • Assessment.objectStatus = CURRENT
      • Assessment.planning.tasks.task.id = Sisendis esitatud taskId väärtus.
      • Assessment.planning.tasks.task.objectStatus = CURRENT
        1. Kui tingimustele vastavat objekti ei leitud, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
  4. Süsteem muudab leitud tööülesande andmeid.
    • Süsteem uuendab leitud Objektid#Assessment.planning.tasks.task objekti andmeid:
      • assessmentPhaseId = Sisendis esitatud assessmentPhaseId väärtus.
      • activityName = Sisendis esitatud activityName väärtus.
      • activityDescription = Sisendis esitatud activityDescription väärtus.
      • startDate = Sisendis esitatud startDate väärtus.
      • endDate = Sisendis esitatud endDate väärtus.
      • audit (muutmine) = audit (muutmine)
      • assignees.assignee.teamMemberId = Sisendis esitatud assignees.teamMemberId väärtused.
      • assignees.assignee.objectStatus = CURRENT
      • assignees.assignee.audit (loomine) = audit (loomine)
        • Kui andmebaasis olevate meeskonna liikmete hulgas on meeskonna liige, keda sisendis ei ole, siis kustutab süsteem selle meeskonna liikme ülesande küljest.
          • assignees.assignee.objectStatus = DELETED
          • assignees.assignee.audit (muutmine) = audit (muutmine)
  5. Süsteem tagastab muudetud andmed.