Для создания резолюции пользователь нажимает на кнопку «Резолюция» - открывается экран резолюции (илл. «Экран резолюции»).

Рисунок 4.46. Экран резолюции

Рисунок 4.47. Экран резолюции

Вверху экрана отображаются:

Далее отображаются панели пунктов резолюции в режиме просмотра. Каждая панель содержит информацию в следующем порядке:

Далее отображаются управляющие кнопки. Для новой резолюции это кнопки «Принять» (с идентификатором PREFERRED) и «Сохранить» (с идентификатором NOT_PREFERRED).

Управляющие кнопки внизу экрана имеют фиксированное положение, остальные поля и кнопки данного экрана не имеют фиксированного положения, прокручиваются (если все поля вмещаются в экран, то управляющие кнопки должны быть внизу экрана, а не сразу за контентом).

Экран редактирования пункта резолюции.

Рисунок 4.48. Экран редактирования пункта резолюции

Рисунок 4.49. Экран редактирования пункта резолюции

Все поля и кнопки данного экрана не имеют фиксированной высоты, контентозависимы (если все поля вмещаются в экран, то управляющие кнопки должны быть внизу экрана, а не сразу за контентом).

Параметры пункта резолюции:

Если пользователь на экране редактирования пункта резолюции нажимает на кнопку «Назад», мобильный клиент возвращает экран резолюции в том состоянии, которое было до вызова данного экрана.

После ввода всех необходимых параметров пункта резолюции пользователь нажимает на кнопку «Готово». Сохранение локальное. Действие выполняется при выполнении следующих условий:

Возможно выполнение альтернативных потоков событий 1-3.

Альтернативный поток №1. При наличии незаполненных обязательных полей необходимо выдавать сообщение:

Заполните все поля

и не выполнять действие.

Альтернативный поток №2. Если дата завершения пункта резолюции меньше текущей даты, то необходимо выдавать сообщение:

Дата завершения некоторых элементов меньше текущей даты

и не выполнять действие, иначе - действие выполнять.

Альтернативный поток №3. Если значение настройки «разрешено ли ставить работы по резолюции, завершающиеся позже документа» = false, то для даты завершения в пунктах резолюции > даты завершения документа необходимо выдавать сообщение:

Дата завершения каждого из пунктов резолюции не должна превышать срок документа

и не выполнять действие, иначе - действие выполнять.

Сохранение резолюции.

Для сохранения черновика резолюции пользователь нажимает на кнопку «Сохранить». Сохранение с отправкой данных сервер. Действие выполняется, только если создан хотя бы один пункт резолюции, иначе выполняется альтернативный поток событий 4.

При успешном сообщается «Данные сохранены», экран резолюции закрывается, открывается экран информации о работе.

Альтернативный поток №4. При сохранении резолюции без единого пункта необходимо выдавать сообщение:

Резолюция должна содержать хотя бы один элемент

и не выполнять действие.

Редактирование черновика резолюции.

Если у пользователя есть право редактирования черновика резолюции, то чтобы редактировать черновик резолюции, он в окне информации о работе нажимает на кнопку «Резолюция» - открывается экран резолюции с плашками сохраненных пунктов резолюции и кнопками «Принять» и «Сохранить». Возможные действия аналогичны описанным выше 1-3.

Альтернативный поток №5. Если любая плашка / любой пункт черновика резолюции содержит тип работы, удаленный из соответствующего справочника системы, то тип все еще является значением компонента, но при этом отсутствует в выпадающем списке. При попытке сохранить (как на экране редактирования пункта, так и всей резолюции) либо принять резолюцию с таким типом работы необходимо не выполнять действие и выдавать ошибку:

Выбранный тип работы по резолюции отсутствует в справочнике. Выберите другое значение.

Принятие резолюции.

Для принятия резолюции пользователь нажимает на кнопку «Принять».

Возможно исполнение альтернативных потоков событий, аналогичных при сохранении резолюции (см. выше). При неуспешном принятии отображается сообщение об ошибке, пользователь остается на экране резолюции. При успешном сообщается «Резолюция принята», экран резолюции закрывается, открывается экран информации о работе.

Кроме того, обновляется список работ (удаляется предыдущая работа, создаются новые, присваивается свойство контрольности). На плашку работы справа от иконки приоритета добавляется иконка наличия резолюции («штамп»). Пример плашки работы с наложенной резолюцией см. в илл. «Плашка работы с резолюцией».

Просмотр принятой резолюции.

Если у пользователя нет права редактирования принятой резолюции (только просмотр), то чтобы просмотреть принятую резолюцию, он в окне информации о работе нажимает на кнопку «Резолюция» - открывается экран резолюции с плашками принятых пунктов резолюции, в котором:

Редактирование принятой резолюции.

Если у пользователя есть право редактирования принятой резолюции, то чтобы редактировать принятую резолюцию, он в окне информации о работе нажимает на кнопку «Резолюция» - открывается экран резолюции с плашками принятых пунктов резолюции. Управляющая кнопка для принятой резолюции одна - «Принять» (с идентификатором PREFERRED).

При добавлении новых пунктов резолюции возможные действия с ними аналогичны описанным выше 1-3.

Для принятия отредактированной резолюции пользователь нажимает на кнопку «Принять». При неуспешном сохранении отображается сообщение об ошибке, пользователь остается на экране резолюции. При успешном сообщается «Резолюция принята», экран резолюции закрывается, открывается экран информации о работе. Кроме того, обновляется список работ согласно введенным изменениям.

Создание нескольких резолюций на документ.

По нажатию на кнопку «Резолюция» должно вызываться меню (аналогичное, например, выбору формы завершения, илл. «Меню пунктов резолюции»), с первым пунктом «Создать новую» (действие из подраздела «Создание резолюции»). Пользователи - ответственные и исполнители уже наложенной резолюции, которые, в свою очередь, могут создавать резолюцию, - получают возможность накладывать собственную резолюцию. Один пользователь может создать только одну резолюцию, т.е. если пользователь уже создал резолюцию для документа, то пункт меню «Создать новую» у него должен отсутствовать.

Рисунок 4.50. Меню пунктов резолюции

Рисунок 4.51. Меню пунктов резолюции

Далее идут пункты, соответствующие уже наложенным на документ резолюциям в порядке их создания, в формате «Резолюция от Фамилия И.О.» По нажатию на один из пунктов выполняется действие подразделов «Просмотр принятой резолюции» либо «Редактирование принятой резолюции» (в зависимости от прав).

Если резолюцию накладывает ответственный пункта уже имеющейся резолюции, то система сначала должна предупреждать пользователя сообщением «Наложение дополнительной резолюции приведет к удалению работ ваших исполнителей. Вы действительно хотите это сделать?» По нажатию на кнопку «Нет» действие не выполняется и пользователь возвращается к окну информации о работе. По нажатию же «Да» действие выполняется: см. подраздел «Создание резолюции».

В зависимости от атрибутов работы, завершение может быть осуществлено одним из следующих способов:

Завершение с действием (идентификатор операции PROCESS)

Пользователь нажимает на кнопку «Ответить» - открывается экран (илл. «Экран утверждения»). Для каждого действия API будет возвращать следующую информацию:

• необходимо ли подписывание действия (demandSign);

• информация о наборе функциональных кнопок (buttons) и для каждой из них: название (label), цвет (color), действие (signal);

• необходимо ли наличие поля для комментария (need_comment_input);

• обязателен ли ввод комментария (need_enter_positive_comment и need_enter_negative_comment);

• закодированная строка для идентификации подписываемых данных (raw_data).

Рисунок 4.52. Экран согласования без использования ЭЦП

Рисунок 4.53. Экран согласования без использования ЭЦП

Рисунок 4.54. Экран согласования, файл ЭЦП еще не выбран

Рисунок 4.55. Экран согласования, файл ЭЦП еще не выбран

Рисунок 4.56. Экран согласования, файл ЭЦП выбран

Рисунок 4.57. Экран согласования, файл ЭЦП выбран

Все кнопки имеют фиксированное положение внизу экрана. Вся остальная область прокручиваема.

Параметры завершения с действием.

Параметр работы	Описание
Добавить подпись	Флажок
Использовать ЭЦП	Флажок
Просмотреть информацию о выбранной ЭЦП	Кликабельный лейбл
Комментарий	Многострочное поле ввода, placeholder - «Введите комментарий»

Флажок «Добавить подпись» для каждого из типов действия имеет значение по умолчанию в зависимости от настройки необходимо ли подписывание действия demandSign:

• «да» - флажку устанавливается значение «Вкл», его изменение недоступно;

• «нет» - флажку устанавливается значение «Выкл», его изменение доступно.

Добавление подписи фиксируется в метаданных документа с сохранением его хеша.

Если функция ЭЦП настроена на стороне сервера (поле API enableEDS = true), а также при наличии цифровой подписи на устройстве, возможно его использование при подписании.

Флажок «Использовать ЭЦП» доступен, только если «Добавить подпись» = «Вкл». Значение по умолчанию зависит от настроек, полученных при загрузке приложения (требовать ли ключ и сертификат, параметр в API: needCert):

• «да» - флажку устанавливается значение «Вкл», его изменение недоступно;

• «нет» - флажку устанавливается значение «Выкл», его изменение доступно.

Примечание.

В случае, если выключается доступный флажок «Добавить подпись», то флажок «Использовать ЭЦП» должен выключаться и становиться недоступным автоматически, независимо от его предыдущего состояния.

Если функция ЭЦП не настроена на стороне сервера (поле API enableEDS = false), то:

• при наличии требования ключа и сертификата (needCert = true) - не открывая экран необходимо вывести ошибку:

  Вы не можете использовать ЭЦП. Данная функция не настроена. Обратитесь к администратору.

• иначе - флажок «Использовать ЭЦП» всегда недоступен и имеет значение «Выкл».

Кликабельный лейбл Просмотреть информацию о выбранной ЭЦП отображается только в том случае, если файл ЭЦП уже выбран. По его нажатию открывается экран с информацией (см. ниже).

Многострочное поле для комментария, по умолчанию, пустое и отображает placeholder. В зависимости от настроек, может быть обязательным для ввода.

Для значения «Использовать ЭЦП» = «Выкл» внизу экрана отображаются только функциональные кнопки (состав, их названия и стили возвращаются из API). Например, «Согласен» и «Не согласен», «Утверждаю» и «Не утверждаю», «Ознакомлен».

Для значения «Использовать ЭЦП» = «Вкл» внизу экрана отображаются:

• файл ЭЦП не выбран - только кнопка «Выбрать ЭЦП» зеленого цвета (идентификатор PREFERRED);

• файл ЭЦП выбран - сначала функциональные кнопки, затем кнопка «Изменить ЭЦП» серого цвета (идентификатор NOT_PREFERRED).

Информация о выбранной ЭЦП.

Нажатие по кликабельному лейблу «Просмотреть информацию о выбранной ЭЦП» открывает экран «Информация», в которой отображаются следующие параметры:

Поле	Параметр ЭЦП	Пример
ИИН	KEY_SERIALNUMBER	IIN910511450249
Основное имя	KEY_CN	САРСЕМБАЕВА МЕРУЕРТ
Отчество	KEY_GIVENNAME	КОКЕШЕВНА
Организация	KEY_O	АО «НАЦИОНАЛЬНАЯ КОМПАНИЯ»КАЗАХСКОЕ ИНФОРМАЦИОННОЕ АГЕНТСТВО"
Истекает		31.12.2016

Примечание.

Если ЭЦП выдано на физическое лицо, поле «Организация» должно отсутствовать.

С данного экрана возможен только возврат на предыдущий экран с помощью кнопки «Назад».

Рисунок 4.58. Информация о выбранной ЭЦП

Рисунок 4.59. Информация о выбранной ЭЦП

Кнопка «Выбрать ЭЦП».

Примечание.

Для подписания документов с использованием ЭЦП предварительно необходимо загрузить файл сертификата на устройство. Мобильным приложением поддерживаются только ЭЦП с алгоритмом RSA.

Для ОС Android достаточно скопировать файл ЭЦП в любую папку подключенного к компьютеру смартфона с помощью проводника.

Для iOS необходимо воспользоваться фирменной утилитой iTunes. При подключенном смартфоне перейти в «iPhone» - «Настройки» - «Программы». Найти среди списка программ мобильное приложение Synergy и добавить файл ЭЦП в хранилище с компьютера на смартфон через кнопку «Добавить файл…».

После включения флажка «Использовать ЭЦП» внизу экрана отображается единственная кнопка «Выбрать ЭЦП». По ее нажатию, в зависимости от того, происходил ли выбор ЭЦП в приложении ранее, открывается:

в ОС Android:

• ЭЦП ранее не использовалось - окно (не экран) файлового менеджера (аналогичный выбору файла с устройства) с фильтром, позволяющим отображать в папках только файлы цифровых подписей (с расширением р12 и pfx).

  Если в данном окне пользователь нажимает на кнопку «Назад» / «Отмена» / либо вне области окна, возвращается экран завершения в том же состоянии, что и до нажатия кнопки «Выбрать ЭЦП».

  Если же пользователь нажимает на кнопку «Ок», не выбрав файл, необходимо закрывать окно и выдавать сообщение:

  Выберите файл ЭЦП

  Пользователь выбирает файл ЭЦП и нажимает на кнопку «Ок», открывается экран «Пароль ЭЦП».

• ЭЦП ранее использовалось - сразу экран «Пароль ЭЦП», в котором уже выбран файл последнего использовавшегося сертификата.

в iOS:

• ЭЦП ранее не использовалось - экран файлов приложения «ЭЦП» (куда предварительно загружен файл ЭЦП) с фильтром, позволяющим отображать только файлы цифровых подписей (с расширением р12 и pfx).

  Если на данном экране пользователь нажимает на кнопку «Назад», возвращается экран завершения в том же состоянии, что и до нажатия кнопки «Выбрать ЭЦП».

  Выделение строки - действие tap. После выделения файла пользователь нажимает на кнопку «Выбрать». Действие выполняется, только если выделен какой-либо файл, иначе необходимо выдавать сообщение:

  Файл не выбран

  и не выполнять действие. В случае успешного выполнения открывается экран «Пароль ЭЦП».

  Рисунок 4.60. Выбор ЭЦП в iOS

  
  
  

• ЭЦП ранее использовалось - сразу экран «Пароль ЭЦП», в котором уже выбран файл последнего использовавшегося сертификата.

В обоих вариантах под вариантом «ЭЦП ранее не использовалось» подразумевается, в том числе, сброс текущего выбранного значения ЭЦП при выходе из приложения (с помощью кнопки «Выйти» в настройках).

Пароль ЭЦП.

Параметры экрана ввода пароля.

Параметр экрана	Описание
%название_файла_ЭЦП%	Поле ввода пароля, placeholder «Введите пароль»
Подписать	Кнопка
Изменить ЭЦП	Кнопка

Обязательное поле ввода пароля с лейблом, содержащим полное название файла ЭЦП. В данное поле вводится пароль к сертификату.

По нажатию на кнопку «Подписать» происходит валидация пароля, и в случае успешного пароля - валидация самой подписи. В случае успешной валидации подписи открывается экран завершения в состоянии «выбранного ЭЦП»:

• отображается кликабельный лейбл «Просмотреть информацию о выбранной ЭЦП»;

• после функциональных кнопок добавляется кнопка «Изменить ЭЦП» серого цвета (идентификатор NOT_PREFERRED).

Возможно исполнение альтернативных потоков событий 1-6.

Если на экране «Пароль ЭЦП» пользователь нажимает на кнопку «Назад», возвращается экран завершения в том же состоянии, что и до нажатия кнопки «Выбрать ЭЦП».

По нажатию на кнопку «Изменить ЭЦП» открывается окно/ экран выбора файла ЭЦП. При этом текущее выбранное значение удаляется.

Альтернативные потоки событий.

• Альтернативный поток №1: не заполнено поле пароля. Действие не осуществляется, выходит ошибка:

  Введите пароль

• Альтернативный поток №2: введен некорректный пароль. Действие не осуществляется, выходит ошибка:

  Неверный пароль

• Альтернативный поток №3: выбранный ключ просрочен. Действие не осуществляется, выходит ошибка:

  Указанный ключ просрочен. Выберите другой ключ и повторите попытку.

• Альтернативный поток №4: выбранный ключ отозван. Действие не осуществляется, выходит ошибка:

  Указанный ключ был отозван. Выберите другой ключ и повторите попытку.

• Альтернативный поток №5: выбранный ключ не действителен. Действие не осуществляется, выходит ошибка:

  Указанный ключ не действителен. Выберите другой ключ и повторите попытку.

• Альтернативный поток №6: алгоритм выбранного ключа отличается от RSA. Действие не осуществляется, выходит ошибка:

  Указанный ключ приложением не поддерживается. Выберите другой ключ и повторите попытку.

Рисунок 4.61. Пароль ЭЦП

Рисунок 4.62. Пароль ЭЦП

Функциональные кнопки.

Пользователь нажимает на функциональную кнопку. Если для данного действия обязателен ввод комментария, для незаполненного поля должно отобразиться сообщение:

Введите комментарий

и не выполняться действие.

В случае успешного сохранения открывается экран информации о работе, информация обновляется. В случае неуспешного - выдается сообщение об ошибке, пользователь остается на данном экране.

Если на экране завершения пользователь нажимает на кнопку «Назад», возвращается экран информации о работе в том же состоянии, что и до завершения работы.

Примечание.

Метод API для получения информации о построении окна: kz.arta.synergy.server.api.rest.works#getProcessFinishInfo

Метод API для верификации ЭЦП: kz.arta.synergy.ejb.rest.sign#verificationkey

Метод API для завершения процесса: kz.arta.synergy.server.api.rest.works#finishProcess

Метод получения настроек подписания: kz.arta.synergy.server.api.rest.common.SettingsService#getSettings

Завершение с результатом работы (идентификатор операции POINT_RESULT)

Форма завершения - файл

Внешний вид экрана зависит от того, есть ли подтвержденные результаты дочерних работ или нет. Для того, чтобы это узнать, необходимо вызвать метод API kz.arta.synergy.server.api.rest.works#getWorkCompletionData. Если список previous_results не пустой - значит существуют подтвержденные результаты дочерних работ, иначе - не существуют.

Метод API для выставления результата один и тот же как для работ, у которых есть результат дочерних работ, так и для тех у которых нет: kz.arta.synergy.server.api.rest.works#setWorkResult.

Завершение работы, у которой нет результатов дочерних работ.

Пользователь выставляет 100% прогресса либо нажимает на кнопку «Завершить» - открывается экран «Результат» для выбора файла в качестве формы завершения (илл. «Завершение работы, у которой нет результатов дочерних работ (форма завершения - файл)»).

Рисунок 4.63. Завершение работы, у которой нет результатов дочерних работ (форма завершения - файл)

Рисунок 4.64. Завершение работы, у которой нет результатов дочерних работ (форма завершения - файл)

Кнопка «Готово» не имеет фиксированного положения. Весь экран прокручиваемый.

Результат работы может быть выбран следующими способами.

1. Из файлов работы. При выделении файла (tap) в списке фон соответствующего элемента меняется, в поле «Результат работы» копируется название выделенного файла. При долгом нажатии (долгий tap) файл открывается для просмотра (просмотр осуществляется системными средствами устройства). Если ранее был выбран файл из списка, его выделение отменяется.

2. «С устройства» - пользователь выбирает один из файлов, имеющихся на устройстве, при этом название выбранного файла копируется в поле «Результат работы». Если ранее был выбран файл из списка, его выделение отменяется.

3. «Сфотографировать» - пользователь делает новый снимок, используя фотовозможности устройства, при этом название выбранного файла копируется в поле «Результат работы». Если ранее был выбран файл из списка, его выделение отменяется.

Замечание

При выборе нового файла как результата выполнения работы (выбор с устройства) отображать иконку файла не нужно. При добавлении новой фотографии необходимо отображать вместо иконки превью изображения.

Уже выбранный файл в поле «Результат работы» также можно просмотреть, нажав по нему (tap). Просмотр также осуществляется системными средствами устройства.

Если пользователь нажимает на кнопку «Назад», возвращается экран информации о работе в том же состоянии, что и до завершения работы.

Если пользователь нажимает на кнопку «Готово», но файл результата не задан, приложение должно отобразить сообщение «Выберите результат работы» и не выполнять действие.

Если пользователь нажимает на кнопку «Готово», мобильный клиент возвращает пользователя к экрану информации о работе, информация обновляется.

Завершение работы, у которой есть результаты дочерних работ.

Пользователь выставляет 100% прогресса либо нажимает на кнопку «Завершить» - открывается экран «Результат» для выбора файла в качестве формы завершения (илл. «Завершение работы, у которой есть результаты дочерних работ (форма завершения - файл)»).

Рисунок 4.65. Завершение работы, у которой есть результаты дочерних работ (форма завершения - файл)

Рисунок 4.66. Завершение работы, у которой есть результаты дочерних работ (форма завершения - файл)

Кнопка «Готово» не имеет фиксированного положения. Весь экран прокручиваемый.

Результат работы может быть выбран теми же способами, как и для работы без дочерних результатов, а так же выбором одного из результатов дочерних работ.

Если пользователь в качестве результата выбирает результат дочерней работы, на сервер должен быть передан идентификатор результата дочерней работы.

Для этого пользователю необходимо перейти к вкладке результатов дочерних работ «Перепорученные» и нажать (tap) на один из результатов, при этом выбранный результат отмечается в списке фоном, его название копируется в поле «Результат работы». При долгом нажатии (долгий tap) файл открывается для просмотра (просмотр осуществляется системными средствами устройства).

Если до этого был выделен другой файл работы (будь то из вкладки «Из работы» или «Перепорученные»), его выделение в списке отменяется.

Если пользователь нажимает на кнопку «Назад», возвращается экран информации о работе в том же состоянии, что и до завершения работы.

Если пользователь нажимает на кнопку «Готово», но файл результата не задан, приложение должно отобразить сообщение «Выберите результат работы» и не выполнять действие.

Если пользователь нажимает на кнопку «Готово», мобильный клиент возвращает пользователя к экрану информации о работе, информация обновляется.

Форма завершения - комментарий

Внешний вид экрана зависит от того, есть ли подтвержденные результаты дочерних работ или нет. Для того, чтобы это узнать, необходимо вызвать метод API kz.arta.synergy.server.api.rest.works#getWorkCompletionData. Если список previous_results не пустой - значит существуют подтвержденные результаты дочерних работ, иначе - не существуют.

Метод API для выставления результата один и тот же как для работ, у которых есть результат дочерних работ, так и для тех у которых нет: kz.arta.synergy.server.api.rest.works#setWorkResult.

Завершение работы, у которой нет результатов дочерних работ.

Пользователь выставляет 100% прогресса либо нажимает на кнопку «Завершить» - открывается экран «Результат» для ввода комментария в качестве формы завершения (илл. «Завершение работы, у которой нет результатов дочерних работ (форма завершения - комментарий)»).

Рисунок 4.67. Завершение работы, у которой нет результатов дочерних работ (форма завершения - комментарий)

Рисунок 4.68. Завершение работы, у которой нет результатов дочерних работ (форма завершения - комментарий)

Лейбл «Введите комментарий» и кнопка «Готово» имеют фиксированное положение. Панель для ввода комментария прокручиваема.

Пользователь вводит текст комментария.

Если пользователь нажимает на кнопку «Назад», возвращается экран информации о работе в том же состоянии, что и до завершения работы.

Если пользователь нажимает на кнопку «Готово», но результат работы не выбран, приложение отображает сообщение «Выберите результат работы» и не выполняет действие.

Если пользователь нажимает на кнопку «Готово», мобильный клиент возвращает пользователя к экрану информации о работе, информация обновляется.

Замечание

Метод API для задания результата такой же как и для формы завершения «файл» kz.arta.synergy.server.api.rest.works#setWorkResult

Завершение работы, у которой есть результаты дочерних работ.

Пользователь выставляет 100% прогресса либо нажимает на кнопку «Завершить» - открывается экран «Результат» для ввода/указания комментария в качестве формы завершения (илл. «Завершение работы, у которой есть результаты дочерних работ (форма завершения - комментарий)»).

Рисунок 4.69. Завершение работы, у которой есть результаты дочерних работ (форма завершения - комментарий)

Рисунок 4.70. Завершение работы, у которой есть результаты дочерних работ (форма завершения - комментарий)

Кнопка «Готово» имеет фиксированное положение. Обе панели данного экрана («Выберите из перепорученных» и «Или введите комментарий») прокручиваемы каждая внутри и должны занимать по 50% площади экрана.

Результат работы может быть введен тем же способом, как и для работы без дочерних результатов, а так же выбран из результатов дочерних работ.

Если пользователь в качестве результата выбирает результат дочерней работы, на сервер должен быть передан идентификатор результата дочерней работы.

Для этого пользователю необходимо на панели «Выберите из перепорученных» нажать на один из результатов, при этом выбранный результат отмечается в списке фоном, его название копируется в поле «Результат работы», если до этого был выделен другой комментарий работы, то выделение его в списке отменяется.

Если пользователь выбирает в качестве результата результат дочерней работы и вносит в него изменения, считается, что это новый результат и выделение ранее выбранного результата в списке отменяется.

Если пользователь нажимает на кнопку «Назад», возвращается экран информации о работе в том же состоянии, что и до завершения работы.

Если пользователь нажимает на кнопку «Готово», но комментарий-результат не задан, приложение должно отобразить сообщение «Выберите результат работы» и не выполнять действие.

Если пользователь нажимает на кнопку «Готово», мобильный клиент возвращает пользователя к экрану информации о работе, информация обновляется.

Форма завершения - форма

Внешний вид экрана зависит от того, есть ли подтвержденные результаты дочерних работ или нет. Для того, чтобы это узнать, необходимо вызвать метод API

kz.arta.synergy.server.api.rest.works#getWorkCompletionData

Если список previous_results не пустой - значит существуют подтвержденные результаты дочерних работ, иначе - не существуют.

Метод API для выставления результата один и тот же как для работ, у которых есть результат дочерних работ, так и для тех, у которых нет:

kz.arta.synergy.server.api.rest.works#setWorkResult.

Завершение работы, у которой нет результатов дочерних работ.

Пользователь выставляет 100% прогресса либо нажимает на кнопку «Завершить». Открывается экран проигрывателя формы для заполнения файла по форме. Экран, по сравнению со стандартным проигрывателем, урезан:

• отсутствует иконка «Сохранить», основное действие по кнопке «Готово»;

• в меню отсутствуют пункты переключения в режим просмотра, скачивания и просмотра информации, т.е. доступно только переключение между мобильным представлением и основным в режиме редактирования.

Примечание

В версиях мобильного приложения 3.6 и ниже после того, как пользователь выставляет 100% прогресса либо нажимает на кнопку «Завершить», необходимо вызвать метод API rest/api/asforms/form/{formID}. Если значение параметра isMobile = false, то выдавать сообщение-ошибку:

Действие не может быть выполнено, т.к. форма не имеет мобильного представления

и не выполнять действие. Если isMobile = true, то необходимо открывать экран «Результат» для заполнения файла по форме в мобильном представлении (Проигрыватель формы).

Чтобы получить форму, необходимо вызвать метод API rest/api/asforms/form/{formID}, чтобы получить данные формы - rest/api/asforms/data/{formID}.

Примечание

В версиях мобильного приложения 3.6 и ниже мобильное представление поддерживает только 4 компонента (лейбл, однострочное и мнострочное поле, выпадающий
 список), все они должны отрисовываться как стандартные компоненты в любом другом экране приложения. Кнопка «Готово» имеет фиксированное положение, вся остальная область экрана прокручиваема.

Если пользователь нажимает на кнопку «Назад», возвращается экран информации о работе в том же состоянии, что и до завершения работы.

Если пользователь нажимает на кнопку «Готово», данные по форме должны сохраниться в отдельный файл в «Прочих». Имя такого файла должно быть составлено по формату

%Название формы% - %Фамилия И.О. сохранившего%

Мобильный клиент возвращает пользователя к экрану информации о работе, информация обновляется.

Завершение работы, у которой есть результаты дочерних работ.

Пользователь выставляет 100% прогресса либо нажимает на кнопку «Завершить». Открывается экран «Результат» для выбора либо заполнения файла по форме.

Примечание

В версиях мобильного приложения 3.6 и ниже после того, как пользователь выставляет 100% прогресса либо нажимает на кнопку «Завершить», необходимо вызвать метод API rest/api/asforms/form/{formID}. Если значение параметра isMobile = false, то выдавать сообщение-ошибку «Действие не может быть выполнено, т.к. форма не имеет мобильного представления» и не выполнять действие.
 Если isMobile = true, то необходимо открывать экран «Результат» для выбора/заполнения файла по форме в мобильном представлении (Проигрыватель формы).

Рисунок 4.71. Завершение работы, у которой есть результаты дочерних работ (форма завершения - форма)

Рисунок 4.72. Завершение работы, у которой есть результаты дочерних работ (форма завершения - форма)

Кнопка «Готово» имеет фиксированное положение, вся остальная область экрана (панели «Перепорученные» и «Результат работы») прокручиваемы.

Результат работы может быть выбран из результатов дочерних работ: в таком случае на сервер должен быть передан идентификатор результата дочерней работы.

Для этого пользователю необходимо на панели «Перепорученные» нажать на один из результатов, при этом выбранный результат отмечается в списке фоном, его название копируется в поле «Результат работы». При долгом нажатии (долгий tap) по результату работы открывается проигрыватель формы только для просмотра файла по форме. Экран, по сравнению со стандартным проигрывателем, урезан:

• отсутствует иконка «Сохранить», основное действие по кнопке «Готово»;

• в меню отсутствуют пункты переключения в режим редактирования, скачивания и просмотра информации, т.е. доступно только переключение между мобильным представлением и основным в режиме просмотра.

Кроме того, пользователь может создать новый результат работы, используя кнопку «+» на верхней панели. По ее нажатию открывается экран проигрывателя формы для заполнения файла по форме. Экран, по сравнению со стандартным проигрывателем, урезан:

• отсутствует иконка «Сохранить», основное действие по кнопке «Готово»;

• в меню отсутствуют пункты переключения в режим просмотра, скачивания и просмотра информации, т.е. доступно только переключение между мобильным представлением и основным в режиме редактирования.

Примечание

В версиях мобильного приложения 3.6 и ниже после выбора пользователем на панели «Перепорученные» одного из результатов, выбранный результат отмечается в списке фоном и в панели «Результат работы» отображается данные файла по форме.

Рисунок 4.73. Завершение работы, у которой есть результаты дочерних работ (форма завершения - форма) для версий 3.6 и ниже

Рисунок 4.74. Завершение работы, у которой есть результаты дочерних работ (форма завершения - форма) для версий 3.6 и ниже

По нажатию на кнопку «Готово» :

• если пользователь вносил изменения в панели «Результат работы:», то данные по форме должны сохраниться в отдельный файл в «Прочих», имя такого файла должно быть составлено по формату «%Название формы% - %Фамилия И.О. сохранившего%»;

• если пользователь ничего не изменял в выбранном из перепорученных файле по форме, то результатом данной работы необходимо считать тот выбранный файл по форме.

Если пользователь нажимает на кнопку «Назад», возвращается экран информации о работе в том же состоянии, что и до завершения работы.

Если пользователь нажимает на кнопку «Готово», но файл результата не задан, приложение должно отобразить сообщение:

Выберите результат работы

и не выполнять действие.

Если пользователь нажимает на кнопку «Готово», мобильный клиент возвращает пользователя к экрану информации о работе, информация обновляется.

Завершение процесса резолюции

Пользователь нажимает на кнопку «Завершить» - открывается экран «Внимание» (илл. «Завершение процесса «резолюция», вариант 1», илл. «Завершение процесса «резолюция», вариант 2»). Для завершения действия по процессу резолюции API будет возвращать следующую информацию:

• информация о наборе функциональных кнопок и для каждой из них: название, цвет, действие;

• текст сообщения.

Рисунок 4.75. Завершение процесса «резолюция», вариант 1

Рисунок 4.76. Завершение процесса «резолюция», вариант 1

Рисунок 4.77. Завершение процесса «резолюция», вариант 2

Рисунок 4.78. Завершение процесса «резолюция», вариант 2

Функциональные кнопки имеют фиксированное положение. Вся остальная область экрана прокручиваема.

Параметры завершения процесса резолюции. Вариант 1 - нет ни одной принятой резолюции на документе для выключенной опции конфигуратора «Разрешить накладывать дополнительные резолюции» либо данная опция включена, при этом пользователь имеет право принятия резолюции.

Параметр	Значение
Текстовое сообщение (формулировка текста передается API):	Данный тип работы предполагает принятие резолюции. Вы хотите сделать это сейчас?
	Для принятия резолюции нажмите кнопку «Резолюция», для завершения работы - кнопку «Завершить».

Цвет первого абзаца - #717171, второго - #353535.

Для варианта 1 функциональных кнопок должно быть две: «Резолюция» (с идентификатором PREFERRED) и «Завершить» (с идентификатором NOT_PREFERRED).

Параметры завершения процесса резолюции. Вариант 2 - на документе есть одна принятая резолюция для выключенной опции конфигуратора «Разрешить накладывать дополнительные резолюции», либо принятие резолюции недоступно согласно хода выполнения документа, либо у пользователя отсутствует право принятия резолюции.

Параметр	Значение
Текстовое сообщение (формулировка текста передается API):	Завершить работу? Действие «Резолюция» по этому документу недоступно.
	Возможные причины:
	1. У вас недостаточно прав для принятия резолюции.
	2. Одна резолюция на документе уже имеется, а принятие нескольких резолюций не допускается согласно текущим настройкам системы.

Цвет первого абзаца - #717171, второго - #353535.

Для варианта 2 функциональная кнопак должна быть одна: «Завершить» (с идентификатором PREFERRED).

Если пользователь нажимает на кнопку «Назад», возвращается экран информации о работе в том же состоянии, что и до завершения работы.

По нажатию на кнопку «Резолюция» должен открываться экран резолюции (Работа с резолюциями):

• если данный пользователь еще не принимал резолюцию на данный документ - экран создания новой резолюции;

• если данный пользователь сохранял черновик резолюции на данном документе - экран редактирования черновика резолюции;

• если данный пользователь уже принимал резолюцию на данный документ - экран редактирования принятой резолюции.

В случае успешного выполнения действия открывается экран информации о работе, информация обновляется. В случае неуспешного - выдается сообщение об ошибке, пользователь остается на данном экране.

По нажатию на кнопку «Завершить» работа сразу (без подтверждения действия) должна завершиться. В результате успешного выполнения действия происходит возврат к списку работ, в котором обновляется плашка данной работы. В случае неудачного выполнения пользователь остается на этом же экране.

Замечание

Метод API для получения информации о построении окна rest/api/workflow/screen_resolution_info.

Пользователь нажимает на соответствующую кнопку: открывается экран «Отправить». Приложение запрашивает у сервера дополнительную информацию для отображения данного экрана (зависит от действия): название родительской работы; название и цвет кнопки; отображать или нет неподчиненных пользователей в компоненте выбора пользователя, значение по умолчанию для времени завершения (илл. «Отправить на согласование»).

Рисунок 4.87. Отправить на согласование

Рисунок 4.88. Отправить на согласование

Управляющая кнопка имеет фиксированное положение. Вся остальная область экрана прокручиваема (поля не имеют фиксированной высоты и растягиваются по последнему содержимому).

Параметры отправки работы.

Если пользователь нажимает на кнопку «Назад», возвращается экран информации о работе в том же состоянии, что и до вызова данного экрана.

После ввода всех необходимых параметров работы пользователь нажимает на управляющую кнопку. Действие отправки выполняется при выполнении следующих условий:

В случае успешного выполнения действия открывается экран со списком работ, список обновляется.

В случае неуспешного - выдается сообщение об ошибке, действие выполняться не должно, пользователь остается на экране отправки работы. Если не введены формулировка работы и/или ответственный - ошибка «Заполните все поля».

Пользователь нажимает на соответствующую кнопку: открывается экран «Отправить». Приложение запрашивает у сервера дополнительную информацию для отображения данного экрана (зависит от действия): название родительской работы; название и цвет кнопки; отображать или нет неподчиненных пользователей в компоненте выбора пользователя, значение по умолчанию для времени завершения (илл. «Перепоручить работу»).

Рисунок 4.89. Перепоручить работу

Рисунок 4.90. Перепоручить работу

Управляющая кнопка имеет фиксированное положение. Вся остальная область экрана прокручиваема (поля не имеют фиксированной высоты и растягиваются по последнему содержимому).

Параметры перепоручения работы.

Если пользователь нажимает на кнопку «Назад», возвращается экран информации о работе в том же состоянии, что и до вызова данного экрана.

После ввода всех необходимых параметров работы пользователь нажимает на управляющую кнопку. Действие перепоручения выполняется при выполнении следующих условий:

В случае успешного выполнения действия открывается экран со списком работ, список обновляется.

В случае неуспешного - выдается сообщение об ошибке, действие выполняться не должно, пользователь остается на экране перепоручения работы. Если не введены формулировка работы и/или ответственный (для включенного флажка) - ошибка «Заполните все поля». Если для выключенного флажка не выбрано ни одного исполнителя - ошибка «Работа не может быть создана: не указан ни ответственный, ни исполнители».

Пользователь нажимает на соответствующую кнопку: открывается экран «Отправить». Приложение запрашивает у сервера дополнительную информацию для отображения данного экрана (зависит от действия): название родительской работы; название и цвет кнопки; отображать или нет неподчиненных пользователей в компоненте выбора пользователя, значение по умолчанию для времени завершения (илл. «Передать работу»).

Рисунок 4.91. Передать работу

Рисунок 4.92. Передать работу

Управляющая кнопка имеет фиксированное положение. Вся остальная область экрана прокручиваема (поля не имеют фиксированной высоты и растягиваются по последнему содержимому).

Параметры передачи работы.

Если пользователь нажимает на кнопку «Назад», возвращается экран информации о работе в том же состоянии, что и до вызова данного экрана.

После ввода всех необходимых параметров работы пользователь нажимает на управляющую кнопку. Действие передачи выполняется при выполнении следующих условий:

В случае успешного выполнения действия открывается экран со списком работ, список обновляется.

В случае неуспешного - выдается сообщение об ошибке, действие выполняться не должно, пользователь остается на экране передачи работы. Если не введены формулировка работы и/или ответственный - ошибка «Заполните все поля».

Кнопка «Подписать» должна отображаться только при совпадении всех следующих условий:

Если хотя бы одно условие не выполняется, то кнопка «Подписать» отсутствует. Если выполняются оба условия одновременно, то кнопка отображается последней в списке.

Пользователь нажимает на соответствующую кнопку: открывается экран «Подписать». Для выполнения действия необходимо получить следующую информацию:

Рисунок 4.93. Подписание документа без использования ЭЦП

Рисунок 4.94. Подписание документа без использования ЭЦП

Рисунок 4.95. Подписание документа, файл ЭЦП еще не выбран

Рисунок 4.96. Подписание документа, файл ЭЦП еще не выбран

Рисунок 4.97. Подписание документа, файл ЭЦП выбран

Рисунок 4.98. Подписание документа, файл ЭЦП выбран

Все кнопки имеют фиксированное положение внизу экрана. Вся остальная область прокручиваема.

Параметры завершения с действием.

Если функция ЭЦП настроена на стороне сервера (поле API enableEDS = true), а также при наличии цифровой подписи на устройстве, возможно его использование при подписании.

Значение по умолчанию флажка «Использовать ЭЦП» зависит от настроек, полученных при загрузке приложения (требовать ли ключ и сертификат, параметр в API: needCert):

Если функция ЭЦП не настроена на стороне сервера (поле API enableEDS = false), то:

Кликабельный лейбл Просмотреть информацию о выбранной ЭЦП отображается только в том случае, если файл ЭЦП уже выбран. По его нажатию открывается экран с информацией (см. ниже).

Для значения «Использовать ЭЦП» = «Выкл» внизу экрана отображается функциональная кнопки «Подписать» зеленого цвета (идентификатор PREFERRED).

Для значения «Использовать ЭЦП» = «Вкл» внизу экрана отображаются:

Информация о выбранной ЭЦП.

Нажатие по кликабельному лейблу «Просмотреть информацию о выбранной ЭЦП» открывает экран «Информация», в которой отображаются следующие параметры:

С данного экрана возможен только возврат на предыдущий экран с помощью кнопки «Назад».

Рисунок 4.99. Информация о выбранной ЭЦП

Рисунок 4.100. Информация о выбранной ЭЦП

Кнопка «Выбрать ЭЦП».

После включения флажка «Использовать ЭЦП» внизу экрана отображается единственная кнопка «Выбрать ЭЦП». По ее нажатию, в зависимости от того, происходил ли выбор ЭЦП в приложении ранее, открывается:

в ОС Android:

в iOS:

В обоих вариантах под вариантом «ЭЦП ранее не использовалось» подразумевается, в том числе, сброс текущего выбранного значения ЭЦП при выходе из приложения (с помощью кнопки «Выйти» в настройках).

Пароль ЭЦП.

Параметры экрана ввода пароля.

Обязательное поле ввода пароля с лейблом, содержащим полное название файла ЭЦП. В данное поле вводится пароль к сертификату.

По нажатию на кнопку «Подписать» происходит валидация пароля, и в случае успешного пароля - валидация самой подписи. В случае успешной валидации подписи открывается экран подписания в состоянии «выбранного ЭЦП»:

Возможно исполнение альтернативных потоков событий 1-6.

Если на экране «Пароль ЭЦП» пользователь нажимает на кнопку «Назад», возвращается экран подписания в том же состоянии, что и до нажатия кнопки «Выбрать ЭЦП».

По нажатию на кнопку «Изменить ЭЦП» открывается окно/ экран выбора файла ЭЦП. При этом текущее выбранное значение удаляется.

Альтернативные потоки событий.

Рисунок 4.102. Пароль ЭЦП

Рисунок 4.103. Пароль ЭЦП

Функциональная кнопка.

Пользователь нажимает на функциональную кнопку. В случае успешного выполнения действия открывается экран информации о работе, информация обновляется. В случае неуспешного - выдается сообщение об ошибке, пользователь остается на данном экране.

Если на экране подписания пользователь нажимает на кнопку «Назад», возвращается экран информации о работе в том же состоянии, что и до завершения работы.