Глава 5. Файлы

Ревизия VCS: 7896

Дата сборки документа: 2017.03.13 11:33:48

Содержание

Список файлов
Навигатор хранилища
Поиск файлов
Действия в хранилище
Добавление файла в хранилище
Создание папки хранилища
Переименование элемента хранилища
Перемещение элемента хранилища
Скачивание файла из хранилища
Удаление элемента хранилища

Список файлов

Экран со списком файлов представлен на илл. «Список файлов».

Рисунок 5.1. Список файлов

Список файлов

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

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

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

|

Слева |

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

«Файлы»

По центру

Выпадающий список для переключения между модулями

|

Справа |

«Создать» - кнопка добавления файла, создания новой папки и и создания документа

|

Левее кнопки «Создать» |

«Поиск» - кнопка для перехода к поиску по файлам

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

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

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

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

Вся рабочая область ниже пути

Плашки, отображающие информацию о папке / файле

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

Рисунок 5.2. Переключение между модулями

Переключение между модулями

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

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

Например, из структуры папок Хранилище -> Папка 1 -> Папка 1.1 пользователю согласно его ролям доступна только Папка 1.1. В качестве пути будет отображаться не полный (абсолютный) путь Хранилище -> Папка 1 -> Папка 1.1, а относительный Папка 1.1.

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

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

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

  • переход только в дочерние папки из общего списка папок и файлов;

  • переход в родительские папки, используя компонент «Путь».

Пример навигации, используя компонент «Путь»:

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

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

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

Список папок и файлов сортируется следующим образом. Сначала отображаются папки, затем файлы, между собой элементы должны быть отсортированы по названию в порядке возрастания (сначала 0-9, затем A-Z, затем А-Я).

Плашка элемента хранилища.

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

Рисунок 5.3. Плашка папки

Плашка папки

Рисунок 5.4. Плашка файла

Плашка файла

Элемент Расположение Описание Поле API

|

В левой части всей плашки |

Тип элемента хранилища |

is_folder

Справа от иконки; все строки, кроме последней

Полное название папки или файла

name

Абдрешен Л.С.

Справа от иконки; последняя строка плашки, слева

ФИО пользователя, выполнившего последнее изменение папки или файла

userName

01.01.16 09:00:00

Справа от иконки; последняя строка плашки, справа

Дата и время последнего изменения папки или файла

modified

Тип элемента хранилища отображается в виде пиктограммы папки (is_folder = true) или файла (is_folder = false). Пример иконки папки приведен в таблице выше. Иконки файлов зависят от расширения, они аналогичны таковым в панели вложений работы.

Пользователь, выполнивший последнее изменение элемента хранилища. Отображается в формате %Фамилия И.О.%

Дата и время последнего изменения элемента хранилища. Отображается в формате %ДД.ММ.ГГ ЧЧ:ММ:СС%.

Возможные действия на экране.

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

По нажатию на кнопку «+» вызывается меню «Создать» (аналогичное в модуле «Работы»), в построении которого участвуют пункты параметра files_items:

  • favorite_documents;

  • all_documents;

  • upload_document;

  • new_folder.

Рисунок 5.5. Меню создания в модуле «Файлы»

Меню создания в модуле «Файлы»

Действия favorite_documents и all_documents соответствуют пунктам создания документов.

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

Действие new_folder соответствует пункту создания новой папки.

Кнопка «+» может отсутствовать вовсе, см. подробнее в разделе Действия в хранилище. В таком случае кнопка «Поиск» должна переместиться на место кнопки «Создать». В целом же логика меню «Создать» и экрана «Избранное» не отличается от таковой в работах.

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

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

По нажатию на кнопку «Назад»:

Возможные действия с плашкой папки:

  1. При выделении папки (tap) обновляется список: в нем должно отображаться содержимое выделенной папки.

  2. В результате долгого нажатия по плашке возможно появление меню для осуществления дополнительных действий с папкой. Набор пунктов меню зависит от прав пользователя на папку. Если нет прав для совершения ни одного действия - меню не отображается. Возможные пункты меню:

Возможные действия с плашкой файла:

  1. При выделении файла (tap) он скачивается на устройство и открывается системными средствами.

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

Примечание

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

kz.arta.synergy.server.api.rest.stotage#listFiles.

http://tdd.lan.arta.kz/docs/synergy/trunk/sdk-doc/javadoc/kz/arta/synergy/server/api/rest/storage/StorageService.html#listFiles%28java.lang.String,%20boolean,%20java.lang.String%29