PM: API: LastViewedData: GET/planning-api/lastViewedData/{viewedObjectReference}
Üldkirjeldus
Teenus võimaldab pärida eesmärgi, arengukava jne andmete viimaste päringute nimekirja.
Seotud andmeobjektid:
Seotud Jira taskid
NSIL-786 - Getting issue details... STATUS
Eeltingimused ja kasutusõigused
- Kasutajal on planeerimise mooduli vaatamise või muutmise õigustest tulenevalt õigus näha lehe andmeid, mille viimaseid vaatamisi pärib (vt. täpsemalt PM Kasutusõigused ja rollid).
Sisendid
| Atribuut | Kohustuslikkus, mitmesus | Tüüp | Vaikeväärtus, valideerimine | Kirjeldus, täiendav info |
|---|---|---|---|---|
viewedObjectReference | 1 | String |
| Vaadatud objekti unikaalne identifikaator |
Väljundid
| Atribuut | Kohustuslikkus, mitmesus | Tüüp | Kirjeldus, täiendav info |
|---|---|---|---|
| lastViewedData | 1..* | Array | Info lehe viimaste vaatamiste kohta iga inimese kohta |
lastViewedDataId | 1 | String | Viimase vaatamise unikaalne identifikaator |
viewedObjectReference | 1 | String | Vaadatud (päritud) objetki unikaalne identifikaator, nt. viide päritud eesmärgile, arengukavale, hindamiste tulemustele jne. |
viewedDate | 1 | DateTime | Andmete viimase vaatamise kuupäev ja kellaaeg |
viewerName | 1 | String | Viimase vaataja nimi |
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 objekti vaatamised, mis on kuni 2 aastat vanad. Iga isiku kohta tagastatakse ainult tema kõige viimane vaatamine.
- Süsteem otsib Objektid#LastViewedData objekti, mille:
- viewedObjectReference = Sisendis esitatud objekti id väärtus.
- viewedTime <= Päringu teostamise aeg - 2 aastat.
- Sama viewerName korral valitakse kirje, mille on viewedTime suurim.
- Kui tingimustele vastavalt objekti ei leitud, siis lõpetatakse päringu töötlemine ja tagastatakse http veakood.
- Süsteem otsib Objektid#LastViewedData objekti, mille:
- Süsteem tagastab leitud andmed.