GS: Assessment: API: POST /quality-api/assessments/{id}/tasks
Üldkirjeldus
Teenus võimaldab luua hindamisega seotud tööülesandeid.
Seotud andmeobjektid:
NSIL-165 - 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.
- Kasutajal peab olema hindamise valdkonnaga seotud hindamise tööülesannete haldamise õigus ja kasutaja peab olema seotud asutusega, mis on seotud hindamisega.
- 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.
- Päringu käivitanud kasutaja on isik, kelle suhtes hindamist läbi viiakse.
- 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.
- Kasutajal peab olema hindamise valdkonnaga seotud hindamise tööülesannete haldamise õigus töödeldava hindamisega seoses ja kasutaja peab olema seotud hindamisega.
Sisendid
| Atribuut | Kohustuslikkus, mitmesus | Tüüp | Vaikeväärtus, valideerimine | Kirjeldus, täiendav info |
|---|---|---|---|---|
| id | 1 | String |
| Hindamise id. |
| assessmentPhaseId | 1 | String |
| 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 | String | Lubatud kuni 1000 tähemärki. | Tegevuse kirjeldus. |
| startDate | 0..1 | Date |
| Tööülesande algusaeg. |
| endDate | 1 | Date |
| Tööülesande tähtaeg. |
| assignees.teamMemberId | 1..* | Array |
| Nimekiri tööülesande vastutajates. |
Väljundid
| Atribuut | Kohustuslikkus, mitmesus | Tüüp | Kirjeldus, täiendav info |
|---|---|---|---|
| id | 1 | String (PK) | Tööülesande unikaalne identifikaator |
| assessmentPhaseId | 1 | EHIS Classifier | Hindamise etapp, millega tööülesanne on seotud. Väärtusena klassifikaatori ASSESSMENT_PHASE elemendi viide. |
| activityName | 1 | String | Tööülesande tegevuse nimetus. |
| activityDescription | 0..1 | String | Tegevuse kirjeldus. |
| startDate | 0..1 | Date | Tööülesande algusaeg. |
| endDate | 1 | Date | Tööülesande tähtaeg. |
| status | 1 | Enum | Tööülesande staatus
|
| completionTime | 0..1 | Date and time | Tööülesande tehtuks märkmise aeg. |
| objectStatus | 1 | String | Objekti staatus.
|
| assignees | 1..* | Array | Nimekiri tööülesande vastutajates. |
| assignees.assignee | 1 | Object | Tööülesande vastutaja andmed. |
| assignees.assignee.teamMemberId | 1 | String (FK) | Tööülesande vastutaja id. |
| assignees.assignee.firstName | 0..1 | String | Tööülesande vastutaja eesnimi (Assessment.teamMembers.member.firstName NB! objectStatus kontrolli member objektile ei teosta). |
| assignees.assignee.lastName | 0..1 | String | Tööülesande vastutaja perekonnanimi (Assessment.teamMembers.member.lastName NB! objectStatus kontrolli member objektile ei teosta). |
| assignees.assignee.personalCode | 1 | String | Tööülesande vastutaja isikukood (Assessment.teamMembers.member.personalCode NB! objectStatus kontrolli member objektile ei teosta). |
| assignees.assignee.profileColor | 1 | String | Tööülesande vastutaja profiili värv. |
| assignees.assignee.objectStatus | 1 | String | Objekti staatus.
|
Tegevused
- Süsteem kontrollib, kas kasutajal on õigust päringut teostada.
- Kui kasutajal ei ole õigust päringut teostada, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
- Süsteem kontrollib, kas andmed vastavad nõuetele.
- Kui andmed ei vasta nõuetele, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
- Süsteem otsib päringus esitatud tingimustele vastava hindamise andmed.
- Süsteem otsib Objektid#Assessment objekti, mille:
- Assessment.id = Sisendis esitatud id väärtus.
- Assesment.endDate > Päringu teostamise aeg või Assesment.endDate = null.
- Assessment.objectStatus = CURRENT
- Kui tingimustele vastavat objekti ei leitud, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
- Süsteem otsib Objektid#Assessment objekti, mille:
- Süsteem loob tööülesande.
- Süsteem loob Objektid#Assessment.planning.tasks.task objekti:
- id = UUID
- 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.
- status = IN_PROGRESS
- completionTime = null
- objectStatus = CURRENT
- audit (loomine) = audit (loomine)
- assignees.assignee.teamMemberId = Sisendis esitatud assignees.teamMemberId väärtused.
- assignees.assignee.objectStatus = CURRENT
- assignees.assignee.audit (loomine) = audit (loomine)
- Süsteem loob Objektid#Assessment.planning.tasks.task objekti:
- Süsteem tagastab loodud andmed.