Компоненты формы

Системные компоненты выбора (выпадающий список, дата/время)

В данном разделе объединены компоненты выбора, в которых будут использоваться системные компоненты:

  • выпадающий список

  • дата

  • время

Выпадающий список

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

Выбор (действие tap) значения никак не выделяет строку, сам список в таком случае закрывается. При открытии списка выбранное значение также никак не выделено.

Дата/время

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

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

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

При открытии данного компонента отображается либо уже выбранное время (при наличии), либо 00:00 (если значение у компонента еще отсутствует).

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

Вся остальная логика этих компонентов - на стороне проигрывателя форм.

Компонент выбора файла

Компонент формы «Файл» позволяет прикреплять к форме копию файла из хранилища или с мобильного устройства.

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

  • С устройства

  • Из хранилища

Примечание.

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

Пункт «С устройства» соответствует варианту добавления файла «С компьютера». По его нажатию открывается системный экран / окно выбора файла с устройства, аналогичный таковому, например, в окне информации о работе.

Если компонент обладает свойством отображения содержимого загруженного файла, то в обеих ОС должна открываться галерея изображений (должна быть возможность выбора только изображения в формате GIF, JPЕG, PNG).

По нажатию на пункт «Из хранилища» открывается нативный экран выбора файла из хранилища.

Если компонент обладает свойством отображения содержимого загруженного файла, то диалог выбора должны содержать фильтр, при котором отображаются только изображения в формате GIF, JPЕG, PNG.

Проигрыватель форм. Переход по ссылкам.

По нажатию на ссылку с названием файла он скачивается на устройство и открывается системными средствами.

Компонент настройки ссылки

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

В режиме просмотра файла по форме является активной ссылкой, в режиме редактирования - открывает нативный экран «Настройки ссылки» (илл. «Экран «Настройки ссылки»»).

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

Рисунок 8.11. Экран «Настройки ссылки»

Экран «Настройки ссылки»

Рисунок 8.12. Экран «Настройки ссылки»

Экран «Настройки ссылки»

Элементы управления экрана «Настройки ссылки».

Элемент управления Расположение на экране Описание

URL

Вверху основной области

Поле ввода с плейсхолдером «Введите URL ссылки»

Надпись

После URL

Поле ввода с плейсхолдером «Введите надпись к ссылке»

Открывать в отдельном окне

После надписи

Флажок

Готово

Внизу

Кнопка

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

Проигрыватель форм. Переход по ссылкам.

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

Компонент для выбора пользователей

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

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

Рисунок 8.13. Экран «Пользователи» с множественным выбором

Экран «Пользователи» с множественным выбором

Рисунок 8.14. Экран «Пользователи» с множественным выбором

Экран «Пользователи» с множественным выбором

Рисунок 8.15. Экран «Пользователи» с единственным выбором

Экран «Пользователи» с единственным выбором

Рисунок 8.16. Экран «Пользователи» с единственным выбором

Экран «Пользователи» с единственным выбором

Для построения экрана компонент принимает следующие параметры:

  • имеется ли связь с компонентом;

  • единственный или множественный выбор;

  • отображать ли группы;

  • отображать ли пользователей из резерва;

  • отображать подчиненных или всех пользователей;

  • идентификатор действия.

Элементы управления экрана «Пользователи».

Элемент управления Расположение на экране Описание

Верхняя панель

|

Справа |

«Навигатор» - кнопка перехода к навигатору экрана

Компонент «Путь»

Ниже верхней панели

Компонент, отображающий путь до выделенной ноды навигатора, согласно которой отображается текущий список пользователей

Рабочая область

Поле поиска

Вверху основной области

Поле ввода с плейсхолдером «Поиск пользователей» и иконкой лупы справа

Панель со списком пользователей

Вся основная область

Плашки, отображающие информацию о пользователях

Выбрать

Внизу

Кнопка

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

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

Рисунок 8.17. Навигатор выбора пользователей

Навигатор выбора пользователей

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

  • Выбранные

  • Часто выбираемые

  • Группы (присутствует только, если необходимо отображать группы)

  • %Название_организации% (выделен по умолчанию при открытии экрана)

Первые две ноды не имеют дочерних элементов. «Группы» содержат дерево групп всех уровней. «%Название_организации%», в свою очередь, - дерево всей орг.структуры.

В остальном, навигатор повторяет поведение аналогичных навигаторов, например, в хранилище:

  • после выделения узла в навигаторе необходимо автоматически отображать соответствующий список;

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

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

  • иконки свернутости и развернутости, их кликабельная область;

  • отступы дочерних элементов дерева (включая вариант, при котором уровни вложенности, начиная с 8-й, должны иметь отступ как для 7-го уровня);

  • градиент невмещающегося текста;

  • скрытие навигатора свайпом от левой стороны экрана к правой, нажатием по левой стороне экрана либо кнопкой «Назад» (для ОС Android).

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

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

Примеры.

Для ноды «Выбранные», «Часто выбираемые» путь, соответственно, отображает:

  • Выбранные

  • Часто выбираемые

Для выбранной группы путь отображает:

  • Группы > ДРТ > Разработчики

Для выбранного подразделения орг.структуры путь отображает:

  • Фонд поддержки молодежи > Административный отдел > Снабжение

Отображаемый список пользователей зависит от того, что выделено в навигаторе:

  • Выбранные - все текущие пользователи, напротив которых установлен флажок выбора;

  • Часто выбираемые - список часто выбираемых пользователей;

  • Группы - список групп и/или пользователей;

  • %Название_организации% - список пользователей, принадлежащих выбранному подразделению орг. структуры.

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

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

Плашки могут отличаться, в зависимости от отображаемой информации:

  • Плашка пользователя содержит:

    • первый блок - ФИО (полное либо с инициалами - зависит от настройки конфигуратора «Отображать полное ФИО пользователя в компоненте выбора пользователя»);

    • второй блок - список должностей пользователя через запятую (для пользователей из резерва - отсутствует);

    • третий блок - статус календаря (при наличии, цвет определяется настройками статуса).

  • Плашка группы содержит:

    • первый блок - полное название группы;

    • второй блок - полное название родительской группы (для групп первого уровня - отсутствует).

  • Плашка контакта из адресной книги содержит:

    • первый блок - ФИО либо название организации + <электронная почта>;

    • второй блок содержит лейбл Контакт из адресной книги (цвет #ff4800).

  • Плашка произвольного текста содержит:

    • первый блок - произвольный текст;

    • второй блок содержит лейбл Введен вручную (цвет #ff4800).

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

Список отображается с постепенной догрузкой. Изначально подгружается 30 пользователей. При прокрутке пользователем вниз список дополняется новыми 30 пользователями.

Список пользователей сортируется по возрастанию ФИО. Список групп и пользователей, в свою очередь, так: сначала группы, затем пользователи, между собой по возрастанию названия / ФИО.

Поведение экрана:

  • Для компонента с единственным выбором:

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

    • Повторное нажатие на строку не снимает выделение.

    • При выделении пользователя в списке, выделение предыдущего элемента снимается.

  • Для компонента с множественным выбором:

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

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

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

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

Поиск пользователей осуществляется только внутри отображаемого списка и только в узлах навигатора «%Название_организации%» и «Группы» (а также их подузлах, в остальных узлах поле отсутствует вовсе). Поиск является «живым» и производится по названию (для групп) либо ФИО (для пользователей), его результаты фильтруют отображаемый список. При вводе текста иконка лупы заменяется на иконку крестика. Очистить поле ввода можно, нажав на крестик (крестик заменяется на иконку лупы). Пустой запрос поиска - отображается список со всеми пользователями данного узла навигатора.

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

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

  • в нативных диалогах приложения - через запятую, имя каждого пользователя в формате %Фамилия И.О.%;

  • иначе - согласно проигрывателю формы.

Примечание

Метод получения списка пользователей описан в javadoc:

kz.arta.synergy.server.api.rest.userchooser#getUsersExt

Метод получения списка должностей описан в javadoc:

kz.arta.synergy.server.api.rest.userchooser#getPositions

Метод получения списка подразделений описан в javadoc:

kz.arta.synergy.server.api.rest.userchooser#getDepartments

Метод получения списка часто выбираемых пользователей описан в javadoc:

kz.arta.synergy.server.api.rest.userchooser#getOftenChosenUsers

Метод получения списка групп описан в javadoc:

kz.arta.synergy.server.api.rest.groups#getGroups

Компонент для выбора должности

Компонент для выбора должности представляет собой кликабельное поле ввода, по нажатию которой открывается нативный экран «Должности».

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

Для построения экрана компонент принимает следующие параметры:

  • имеется ли связь с компонентом;

  • отображать ли вакантные должности.

Элементы управления экрана «Должности».

Элемент управления Расположение на экране Описание

Верхняя панель

|

Справа |

«Навигатор» - кнопка перехода к навигатору экрана

Компонент «Путь»

Ниже верхней панели

Компонент, отображающий путь до выделенной ноды навигатора, согласно которой отображается текущий список должностей

Рабочая область

Поле поиска

Вверху основной области

Поле ввода с плейсхолдером «Поиск должностей» и иконкой лупы справа

Панель со списком должностей

Вся основная область

Плашки, отображающие информацию о должностях

Выбрать

Внизу

Кнопка

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

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

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

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

  • Выбранные

  • %Название_организации% (выделен по умолчанию при открытии экрана) - содержит дерево всей орг.структуры.

Компонент «Путь» содержит полный путь до выделенного узла навигатора. Содержимое компонента: полные названия узлов от корневой родительской до текущей открытой, включая ее саму.

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

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

Плашки могут отличаться, в зависимости от отображаемой информации:

  • Плашка должности содержит:

    • первый блок - полное название должности;

    • второй блок - полное название ближайшего родительского подразделения, к которому относится данная должность.

  • Плашка произвольного текста содержит:

    • первый блок - произвольный текст;

    • второй блок содержит лейбл Введен вручную (цвет #ff4800).

Во всех вариантах невмещающиеся по ширине названия должностей / подразделений переносятся на новую строку.

Список отображается с постепенной догрузкой. Изначально подгружается 30 должностей. При прокрутке пользователем вниз список дополняется новыми 30 должностями.

Список должностей сортируется следующим образом:

  • должности сортируются по убыванию уровня орг. структуры вне зависимости от уровня должности;

  • должности в одном подразделении сортируются в следующем порядке:

    • руководитель;

    • и.о. руководителя;

    • заместитель руководителя;

    • специалист.

Поведение экрана:

  • Для выбора должности необходимо нажать на строку, вся строка выделится фоном.

  • Повторное нажатие на строку не снимает выделение.

  • При выделении должности в списке, выделение предыдущего элемента снимается.

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

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

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

  • в нативных диалогах приложения - как текст;

  • иначе - согласно проигрывателю формы.

Примечание

Метод получения списка пользователей описан в javadoc:

kz.arta.synergy.server.api.rest.userchooser#getPositions

Метод получения списка подразделений описан в javadoc:

kz.arta.synergy.server.api.rest.userchooser#getDepartments

Компонент для выбора подразделений

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

Компонент может иметь состояния: активен и не активен. Последнее означает, что значение данного экземпляра компонента менять нельзя и по клику по нему не должен открываться экран выбора подразделения (-ий).

Для построения экрана компонент принимает следующие параметры:

  • имеется ли связь с компонентом;

  • единственный или множественный выбор.

Элементы управления экрана «Подразделения».

Элемент управления Расположение на экране Описание

Верхняя панель

|

Справа |

«Навигатор» - кнопка перехода к навигатору экрана

Компонент «Путь»

Ниже верхней панели

Компонент, отображающий путь до выделенной ноды навигатора, согласно которой отображается текущий список подразделений

Рабочая область

Поле поиска

Вверху основной области

Поле ввода с плейсхолдером «Поиск подразделений» и иконкой лупы справа

Панель со списком подразделений

Вся основная область

Плашки, отображающие информацию о подразделениях

Выбрать

Внизу

Кнопка

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

В целом, логика выбора подразделения аналогична выбору пользователя(-ей).

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

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

  • Выбранные

  • %Название_организации% (выделен по умолчанию при открытии экрана) - содержит дерево всей орг.структуры.

Компонент «Путь» содержит полный путь до выделенного узла навигатора. Содержимое компонента: полные названия узлов от корневой родительской до текущей открытой, включая ее саму.

Отображаемый список подразделений зависит от того, что выделено в навигаторе:

  • Выбранные - все текущие подразделения, напротив которых установлен флажок выбора;

  • %Название_организации% - список подразделений, принадлежащих выбранному подразделению орг. структуры.

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

Плашки могут отличаться, в зависимости от отображаемой информации:

  • Плашка подразделения содержит:

    • первый блок - полное название подразделения;

    • второй блок - полное название ближайшего родительского подразделения, к которому относится данное подразделение (для подразделения первого уровня - отсутствует).

  • Плашка произвольного текста содержит:

    • первый блок - произвольный текст;

    • второй блок содержит лейбл Введен вручную (цвет #ff4800).

Во всех вариантах невмещающиеся по ширине названия подразделений переносятся на новую строку.

Список отображается с постепенной догрузкой. Изначально подгружается 30 подразделений. При прокрутке пользователем вниз список дополняется новыми 30 подразделениями.

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

Поведение экрана:

  • Для компонента с единственным выбором:

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

    • Повторное нажатие на строку не снимает выделение.

    • При выделении подразделения в списке, выделение предыдущего элемента снимается.

  • Для компонента с множественным выбором:

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

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

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

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

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

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

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

  • в нативных диалогах приложения - через запятую;

  • иначе - согласно проигрывателю формы.

Примечание

Метод получения списка должностей описан в javadoc:

kz.arta.synergy.server.api.rest.userchooser#getPositions

Метод получения списка подразделений описан в javadoc:

kz.arta.synergy.server.api.rest.userchooser#getDepartments

Компонент периода повторения

Компонент формы «Период повторения» позволяет задавать период повторения.

В режиме редактирования представляет собой выпадающий список с вариантами периода:

  • Нет

  • По дням недели

  • По дням месяца

  • Ежегодно

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

Содержимое экрана зависит от того, какой выбран вариант периода повторения.

Общее для всех вариантов экранов

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

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

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

Все варианты периода повторения поддерживают множественный выбор путем выделения (действие tap) соответствующих значений.

По дням недели.

Рисунок 8.18. По дням недели

По дням недели

Рисунок 8.19. По дням недели

По дням недели

Элемент управления Расположение на экране Описание

По дням недели

Верхняя панель

Заголовок экрана

%сетка_дней_недели%

Вверху основной области

Панель с днями недели

Готово

Внизу

Кнопка

Панель содержит список дней недели:

  • Понедельник

  • Вторник

  • Среда

  • Четверг

  • Пятница

  • Суббота

  • Воскресенье

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

По дням месяца.

Рисунок 8.20. По дням месяца

По дням месяца

Рисунок 8.21. По дням месяца

По дням месяца

Элемент управления Расположение на экране Описание

По дням месяца

Верхняя панель

Заголовок экрана

%сетка_31_дня%

Вверху основной области

Панель с 31 календарными днями

Готово

Внизу

Кнопка

Панель содержит календарные дни с 1 по 31. Разделение на дни недели отсутствует, сетка всегда заполнена строго от верхнего левого угла панели.

Выделение и выбор дня месяца осуществляется нажатием на число (действие tap), соответствующая ячейка сетки выделяется фоном. Повторное выделение снимает этот выбор.

Ежегодно.

Рисунок 8.22. Ежегодно

Ежегодно

Рисунок 8.23. Ежегодно

Ежегодно

Элемент управления Расположение на экране Описание

Ежегодно

Верхняя панель

Заголовок экрана

<

Вверху основной области (слева)

Кнопка перехода к предыдущему месяцу

%название_месяца%

Вверху основной области

Выпадающий список месяцев

>

Вверху основной области (справа)

Кнопка перехода к следующему месяцу

%сетка_дней_месяца%

После месяца

Панель с днями выбранного месяца

Выбрано:

После панели с днями

Список выбранных дней (в виде тегов)

Готово

Внизу

Кнопка

Панель содержит календарные дни выбранного месяца. Выбор месяца осуществляется несколькими способами:

  • при каждом открытии экрана в нем, по умолчанию, выбран текущий месяц на сервере;

  • выпадающий список над панелью отображает текущий выбранный месяц, по его нажатию можно выбрать другой месяц:

    • Январь

    • Февраль

    • Март

    • Апрель

    • Май

    • Июнь

    • Июль

    • Август

    • Сентябрь

    • Октябрь

    • Ноябрь

    • Декабрь

  • возможно переключение на предыдущий месяц (относительно выбранного) с помощью кнопки либо свайпом слева направо;

  • аналогично, возможно переключение на следующий месяц (относительно выбранного) с помощью кнопки либо свайпом справа налево;

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

Разделение на дни недели отсутствует, сетка всегда заполнена строго от верхнего левого угла панели. Количество дней зависит от месяца (при этом февраль всегда содержит 29 дней).

Выделение и выбор дня месяца осуществляется нажатием на число (действие tap): соответствующая ячейка сетки выделяется фоном, в список выбранных добавляется тег, при этом фокус остается на панели (это актуально для случая, когда количество тегов таково, что экран прокручивается). Повторное выделение снимает этот выбор, а также удаляет тег. Смена месяца не отменяет предыдущий выбор в других месяцах.

Надпись «Выбрано:» отображается только в том случае, когда выбрано хотя бы одно значение в сетке (иначе отсутствует вовсе). Каждому выбранному значению соответствует тег в данном списке в формате:

%день_(простой_формат)% %мес%

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

Все теги имеют одинаковую ширину: такую, чтобы на одну строку поместилось 4 тега. Они сортируются в порядке возрастания даты на календаре. Например, 1 мар будет расположено левее и/или выше 1 апр.

Примечание.

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

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

Вы действительно хотите удалить тег %тег%?

Утвердительный ответ удаляет тег и снимает соответствующее выделение в сетке календаря.

Компонент для выбора портфеля или проекта

Компонент формы «Ссылка на проект/портфель» позволяет добавлять на форму ссылку на проект или портфель, открывать их местоположение в модуле «Проекты».

В режиме просмотра файла по форме является активной ссылкой, в режиме редактирования - поле с кнопкой, по нажатию которой открывается нативный экран «Портфели и проекты».

Рисунок 8.24. Экран «Портфели и проекты»

Экран «Портфели и проекты»

Рисунок 8.25. Экран «Портфели и проекты»

Экран «Портфели и проекты»

Элементы управления экрана «Портфели и проекты».

Элемент управления Расположение на экране Описание

Верхняя панель

|

Справа |

«Навигатор» - кнопка перехода к навигатору экрана

Компонент «Путь»

Ниже верхней панели

Компонент, отображающий путь до выделенной ноды навигатора, согласно которой отображается текущий список портфелей и проектов

Рабочая область

Панель со списком портфелей и проектов

Вся основная область

Плашки, отображающие название и тип элемента выбора

Выбрать

Внизу

Кнопка

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

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

Рисунок 8.26. Навигатор выбора портфелей

Навигатор выбора портфелей

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

Сортировка в дереве соответствует модулю «Проекты». По умолчанию, в нем выделена и раскрыта корневая нода, остальное дерево свернуто.

В остальном, навигатор повторяет поведение аналогичных навигаторов, например, в хранилище:

  • после выделения узла в навигаторе необходимо автоматически отображать соответствующий список;

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

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

  • иконки свернутости и развернутости, их кликабельная область;

  • отступы дочерних элементов дерева (включая вариант, при котором уровни вложенности, начиная с 8-й, должны иметь отступ как для 7-го уровня);

  • градиент невмещающегося текста;

  • скрытие навигатора свайпом от левой стороны экрана к правой, нажатием по левой стороне экрана либо кнопкой «Назад» (для ОС Android).

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

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

Пример.

Для выбранного портфеля путь отображает:

  • Фонд поддержки молодежи > Спортивные мероприятия

Отображаемый список портфелей и проектов зависит от того, какая выделена нода дерева, и содержит:

  • сначала дочерние портфели первого уровня вложенности относительно выделенной;

  • затем проекты, принадлежащие непосредственно выделенному портфелю.

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

Плашка списка отображает информацию:

  • первый блок - полное название портфеля или проекта;

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

Невмещающиеся по ширине названия переносятся на новую строку.

Поведение экрана:

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

  • Повторное нажатие на строку не снимает выделение.

  • При выделении портфеля или проекта в списке, выделение предыдущего элемента снимается.

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

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

Запись не выбрана

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

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

Проигрыватель форм. Переход по ссылкам.

По нажатию на ссылку выводится сообщение о невозможности ее открытия:

В мобильной версии просмотр портфеля и проекта не поддерживается

Ссылка не открывается.

Компонент для выбора записи реестра

Компонент формы «Ссылка на реестр» позволяет добавлять на форму кликабельную ссылку на определенную запись определенного реестра.

В режиме просмотра файла по форме является активной ссылкой, в режиме редактирования - поле с кнопкой, по нажатию которой открывается нативный экран «Записи реестра».

Если в настройках компонента не выбран реестр, то по нажатию на эту кнопку необходимо не открывать диалог и выводить системную ошибку:

Не выбран реестр. Обратитесь к методологу.

Рисунок 8.27. Записи реестра: сортировка по убыванию и неполные плашки

Записи реестра: сортировка по убыванию и неполные плашки

Рисунок 8.28. Записи реестра, сортировка по убыванию и неполные плашки

Записи реестра, сортировка по убыванию и неполные плашки

Рисунок 8.29. Записи реестра, сортировка по возрастанию и полные плашки

Записи реестра, сортировка по возрастанию и полные плашки

Рисунок 8.30. Записи реестра, сортировка по возрастанию и полные плашки

Записи реестра, сортировка по возрастанию и полные плашки

Элементы управления экрана «Записи реестра».

Элемент управления Расположение на экране Описание

Записи реестра

Верхняя панель

Заголовок экрана

|

Верхняя панель, справа |

«Вид» - кнопка переключения между двумя видами плашек списка (краткий либо полный)

|

Верхняя панель, левее | кнопки «Вид»

«Сортировка» - кнопка перехода к настройкам сортировки списка

Поле поиска

Вверху основной области

Поле ввода с плейсхолдером «Поиск записей» и иконкой лупы справа

Панель со списком записей реестра

Вся основная область

Плашки, отображающие информацию о записях конкретного реестра

Выбрать

Внизу

Кнопка

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

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

%Название_столбца%: %значение%

Количество данных в плашке зависит от того, какой используется вид просмотра:

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

  • Полный: плашка отображает все отображаемые столбцы. При отображении полного списка кнопка «Вид» принимает значение для переключения в краткий вид.

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

Список записей отображается с постепенной догрузкой. Изначально подгружается 30 записей. При прокрутке пользователем вниз список дополняется новыми 30 записями.

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

  • сортировка, настроенная в реестре (отображается по умолчанию при первом входе в компонент и пока не изменили сортировку):

  • сортировка по убыванию, настроенная в данном экране:

  • сортировка по возрастанию, настроенная в данном экране:

Изменять данную сортировку можно, нажав на соответствующую кнопку (см. ниже).

Поведение экрана «Записи реестра»:

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

  • Повторное нажатие на строку не снимает выделение.

  • При выделении записи в списке, выделение предыдущего элемента снимается.

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

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

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

Запись не выбрана

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

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

Проигрыватель форм. Переход по ссылкам.

По нажатию на ссылку открывается экран информации о документе реестра.

Окно сортировки записей реестра

По нажатию на кнопку «Сортировка» открывается меню Сортировать по полю (для ОС Android) либо Сортировать (для iOS). Внешний вид меню - системный, с доработками.

В построении меню участвуют те столбцы реестра, которые удовлетворяют следующим требованиям.

  • Во-первых, в меню попадают только те столбцы, по которым возможна сортировка, т.е. сюда не должны входить столбцы на основе компонентов:

    • Таблица (статическая, динамическая)

    • Страница

    • Неизменяемый текст

    • Выбор вариантов

    • Изображение

    • Файл

    • Лист подписей

    • Ход выполнения

    • Ссылка на документ

    • Свойства документа

    • Ссылка на файл в хранилище

    Кроме того, компоненты внутри статической таблицы сюда попадают, а внутри динамической - нет.

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

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

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

Для ОС Android.

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

При открытии окна справа от пункта, по которому отсортирован список записей в данный момент, отображается иконка направления сортировки. При первом открытии иконка отсутствует вовсе.

Поведение окна «Сортировать по полю»:

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

    • по убыванию (по умолчанию):

    • по возрастанию:

  • Повторное нажатие на строку меняет направление сортировки на противоположное.

  • При выделении пункта, выделение предыдущего пункта снимается.

Кнопка «Сортировка» может быть в одном из следующих видов:

  • сортировка, настроенная в реестре (отображается по умолчанию при первом входе в компонент и пока не изменили сортировку):

  • сортировка по убыванию, настроенная в данном экране:

  • сортировка по возрастанию, настроенная в данном экране:

Рисунок 8.31. Сортировка в ОС Android, начало списка

Сортировка в ОС Android, начало списка

Рисунок 8.32. Сортировка в ОС Android, середина списка

Сортировка в ОС Android, середина списка

Рисунок 8.33. Сортировка в ОС Android, конец списка

Сортировка в ОС Android, конец списка

Для iOS.

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

При открытии окна справа от пункта, по которому отсортирован список записей в данный момент, отображается иконка направления сортировки. При первом открытии иконка отсутствует вовсе.

Поведение окна «Сортировать»:

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

    • по убыванию (по умолчанию):

    • по возрастанию:

  • Повторное нажатие на строку меняет направление сортировки на противоположное.

  • При выделении пункта, выделение предыдущего пункта снимается.

Рисунок 8.34. Сортировка в iОS

Сортировка в iОS

Для обеих ОС.

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

Для того, чтобы отменить действие и закрыть окно, необходимо нажать на кнопку «Отмена» либо в пустой области экрана, дополнительно для ОС Android - с помощью кнопки «Назад».

Компонент для выбора записи адресной книги

Компонент формы «Ссылка на адресную книгу» позволяет добавлять на форму кликабельную ссылку на определенную запись адресной книги.

В режиме просмотра файла по форме является активной ссылкой, в режиме редактирования - поле с кнопкой, по нажатию которой открывается нативный экран «Адресная книга».

Рисунок 8.35. Экран «Люди»

Экран «Люди»

Рисунок 8.36. Экран «Люди»

Экран «Люди»

Рисунок 8.37. Экран «Организации»

Экран «Организации»

Рисунок 8.38. Экран «Организации»

Экран «Организации»

Элементы управления экрана «Адресная книга».

Элемент управления Расположение на экране Описание

«Люди» либо «Организации»

Верхняя панель

Заголовок экрана, также является выпадающим списком

Поле поиска

Вверху основной области

Поле ввода с плейсхолдером «Поиск записей» и иконкой лупы справа

Панель со списком контактов

Вся основная область

Плашки, отображающие информацию о контактах адресной книги

Выбрать

Внизу

Кнопка

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

По нажатию на заголовок экрана открывается стандартный выпадающий список с двумя типами контактов:

  • Люди (выбран по умолчанию)

  • Организации

Отображаемый список контактов зависит от того, какой тип контактов необходимо отображать согласно значению заголовка экрана, и содержит:

  • для типа контактов «Люди»:

    • первый блок - %Фамилия% %Имя% %Отчество%;

    • второй блок - %Организация%.

  • для типа контактов «Организации»:

    • первый блок - %Организация%;

    • второй блок - %Адрес%.

Примечание.

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

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

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

Между собой контакты в списке сортируются согласно их следованию в модуле «Адресная книга», а именно по возрастанию фамилии для «Людей» и названия для «Организаций». Изменять данную сортировку нельзя.

Поведение экрана:

  • Для выбора контакта необходимо нажать на строку, вся строка выделится фоном.

  • Повторное нажатие на строку не снимает выделение.

  • При выделении контакта в списке, выделение предыдущего элемента снимается.

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

При смене типа контакта (люди/организации) поле поиска очищается.

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

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

Запись не выбрана

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

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

Проигрыватель форм. Переход по ссылкам.

По нажатию на ссылку выводится сообщение о невозможности ее открытия:

В мобильной версии просмотр адресной книги не поддерживается

Ссылка не открывается.

Компонент выбора файла из хранилища

Компонент формы «Ссылка на файл в Хранилище» позволяет добавлять на форму ссылку на файл, открывать как файл, так и его местоположение в хранилище.

По нажатию на кнопку «Выбрать файл» открывается нативный экран «С хранилища» (илл. «Экран «С хранилища»»).

Рисунок 8.39. Экран «С хранилища»

Экран «С хранилища»

Рисунок 8.40. Экран «С хранилища»

Экран «С хранилища»

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

Панель со списком папок и файлов имеет следующие особенности:

  • Папки:

    • С понижением уровня папки и файлы смещаются вправо (при этом уровни вложенности, начиная с 8-й, должны иметь отступ как для 7-го уровня).

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

  • Файлы:

    • Каждый файл располагается правее группы самого нижнего уровня, в которой он находится.

    • Только в строке файла присутствует выделение строки (действие tap).

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

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

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

Проигрыватель форм. Переход по ссылкам.

По нажатию на ссылку с названием файла он скачивается на устройство и открывается системными средствами.

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