Формулировка проблемы: для расширения функционала по резолюциям в мобильных клиентах к платформе требуется добавить параметр для использования календаря в резолюции в существующий метод получения информации по резолюциям.
Связанные задачи: 2.59.API16.
Решение: необходимо расширить функционал метода
API
[rest/api/doc/get_resolution] (#API16)
добавлением нового параметра.
URL
метода:
rest/api/doc/get_resolution
. Типа запроса:
GET
.
Метод принимает следующие параметры:
workID
- actionID
работы
(обяз.);
locale
- локаль пользователя,
ru/en/kz
(не обяз., по умолчанию
ru
).
Метод возвращает json
со следующими параметрами:
statusID
- статус резолюции
(0
- резолюция сохранена,
1
- резолюция наложена, 2
- резолюция удалена);
projectID
- UUID
резолюции;
author
- Фамилия И.О.
автора резолюции;
authorID
- UUID
автора
резолюции;
canEdit
- есть ли возможность редактировать
резолюцию текущему пользователю (true
- да,
false
- нет);
controlled
- выставлена ли галочка «Является
контрольным» (true
- да,
false
- нет);
maxFinishDate
- максимальная дата завершения
документа в формате DD.MM.YY hh:mm
;
items
- пункты резолюции:
name
- имя
пункта
резолюции;
itemID
- ID
пункта
резолюции;
userID
- UUID
ответственного;
user
- Фамилия И.О.
ответственного;
users
- массив, каждый элемент которого
содержит 2 поля:
userID
- UUID
ответственного из списка;
user
- Фамилия И.О.
ответственного из списка;
type
- тип (3
-
работа, 0
- согласование,
1
- утверждение, 2
-
ознакомление, 17
- отправка документа,
28
- блокирующий процесс);
completionFormID
- ID
формы завершения.
Альтернативные потоки событий:
если параметр workID
не передан, либо он
пустой, сервер вернет сообщение «Не передан параметр
workID
», информация о резолюции не
возвращается.
Пример возвращаемых массивов:
[ { "statusID": 1, "projectID": "7254b923-0442-4251-86b4-88512ab4c9af", "author": "Бобров Степан Егорович", "authorID": "0db332d4-9dc6-4323-ab3d-f6b782e5d585", "canEdit": "true", "controlled": "false", "maxFinishDate": "2014-12-17 00:00:00", "items": [ { "name": "111111", "userID": "74f7055f-bb92-46ec-8977-09c83c56854e", "user": "test874_user1 test874_user1 test874_user1", "users": [], "finishdate": { "date": "1418832056000" }, "typeID": 3, "completionFormID": null, "itemID": "41a6f435-415d-449b-baf7-3de67e67d7bd" } ] } ]