Üldkirjeldus

Teenus väljastab kasutaja lõppenud ametikohtade eesmärkide nimekirja.

Seotud andmeobjektid:

Seotud Jira taskid

NSIL-929 - Getting issue details... STATUS

Eeltingimused ja kasutusõigused

Eesmärk peab olema seotud kasutaja isikukoodiga:
- Goal.personalCode = Päringu käivitanud kasutaja isikukood.
Kasutaja kehtivate ametikohtade hulgas ei tohi olla eesmärgiga seotud ametikoha ja asutuse kombinatsiooni:
- Goal.jobsite ja Goal.institution.id väärtuste kombo ei kuulu kasutaja kehtivate ametikohtade hulka.
  - EHIS x-tee teenus GET/users/v1/userAccounts.response.data.jobsiteList.
- Eraldi privileegi ei ole vaja.

Planeerimise mooduli kasutusrollide ja õiguste kohta saab täpsemalt infot leida lehelt Kasutusõigused ja rollid.

Sisendid

Atribuut	Kohustuslikkus, mitmesus	Tüüp	Vaikeväärtus, valideerimine	Kirjeldus, täiendav info
institutionId	1	String	Kasutaja poolt valitud rolliga seotud asutus	Viide asutusele, mille eesmärke otsitakse.
jobsite	1	String	Väärtus peab vastama EHIS klassifikaatorile PEDAGOOG_AMETIKOHT.	Kasutaja kehtiv ametikoht, mille eesmär
statuses	0..*	Array	Peab olema klassifikaatori HSILM_GOAL_STATUS elemendi viide. Peab saama määrata mitu staatust.	Eesmärgi staatus.

Väljundid

Atribuut

Kohustuslikkus, mitmesus

Tüüp

Kirjeldus, täiendav info

goals

0..*

Array

Nimekiri eesmärkidest.

Array objekte vaata PM: API: Goal: POST /planning-api/goals#V%C3%A4ljundid

Tegevused

Süsteem kontrollib, kas kasutajal on õigust päringut teostada.
1. Kui õigust pole, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
Süsteem kontrollib, kas sisendandmed vastavad nõuetele.
1. Kui andmed ei vasta nõuetele, lõpetatakse päringu töötlemine ja tagastatakse http veakood.
Süsteem otsib kasutaja lõpetatud ametikohtade eesmärke:
1. Süsteem otsib Objektid#Goal objekte, mille:
  1. goalScope = "INDIVIDUAL".
  2. personalCode = Päringu käivitanud kasutaja isikukood.
  3. institution.id = Sisendis esitatud "institutionId" väärtus.
  4. jobsite = Sisendis esitatud "jobsite" väärtus.
2. Staatuste filtrid:
  - INCOMPLETE (Pooleliolev)
    1. Eesmärk on pooleliolev, kui:
      1. Goal.archived = false.
      2. Vähemalt üks "Aktiivne" staatuse tingimus on täitmata.
  - ACTIVE (Aktiivne)
    1. Eesmärk on aktiivne, kui kõik järgmised tingimused on täidetud.
      1. Goal.archived = false
      2. Eesmärgi nimi (Objektid#Goal.name) on vähemalt 1 tähemärk pikk.
      3. Eesmärgi kirjeldus (Objektid#Goal.description) on vähemalt 1 tähemärk pikk.
      4. Eesmärgi meeskonnas on vähemalt üks liige.
        On olemas vähemalt üks Objektid#GoalTeamMember objekt, mille goalId = eesmärgi ID, mille andmeid otsitakse.
      5. Eesmärgile on lisatud vähemalt üks tegevus (Objektid#GoalActivity).
        On olemas vähemalt üks Objektid#GoalActivity objekt, mille goalId = eesmärgi ID, mille andmeid otsitakse.
  - ARCHIVED (Arhiveeritud).
    1. Eesmärk on arhiveeritud, kui:
      1. Goal.archived = true
Süsteem tagastab leitud eesmärkide andmed.
1. Kui eesmärke ei leita, tagastatakse tühi vastus.