Работа с файлами в МК. Android

Для iOS

Для работы с файлами в мобильном приложении предназначены: экран "Файлы", атрибуты типа "Файл" на экране карточки объекта и экранах редактирования объектов. Также файл можно прикрепить к объекту при добавлении комментария.

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

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

Список файлов на экране "Файлы"

На экране "Файлы" отображается список всех файлов, прикрепленных к объекту.

Чтобы перейти на экран "Файлы ()", откройте карточку объекта и на нижней панели нажмите кнопку "Файлы ()".

На экране "Файлы ()" отображаются:

  • Иконка возврата на карточку объекта (1) и название экрана "Файлы ()" с указанием общего количества файлов (2).
  • Название объекта, для которого открыт список файлов (является ссылкой на карточку объекта)(3).
  • Блок со списком файлов (4). Элементы списка разделены горизонтальной линией.

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

  • Кнопка "Добавить" (5).

Атрибуты типа "Файл"

Атрибуты типа "Файл" отображаются в списке объектов и на карточке объекта. Каждый файл с новой строки.

Отображение атрибута зависит от представления для отображения, установленного в параметрах атрибута типа "Файл":

  • Изображение — файлы jpg, jpeg, gif, png, bmp, svg, svgz отображается в виде изображения.

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

  • Ссылка для скачивания — отображается название файла. На карточке объекта название файла является ссылкой для скачивания файла. В списке объектов название файла не является ссылкой.

Просмотр содержания файла

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

Загрузка файлов

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

Приложения для просмотра файлов

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

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

Добавление файлов

Новые файлы можно добавить к объекту на экране "Файлы", в карточке объекта как отдельный атрибут или прикрепить при добавлении комментария.

Источники добавления файла

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

  • Сделать фото — для добавления нового фото.
  • Сделать видео — для добавления нового видео.
  • Загрузить изображение — для добавления изображения из библиотеки.
  • Загрузить файл — для добавления любого типа файлов с помощью стандартного менеджера файлов.

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

Добавление файла на экране "Файлы ()"

Онлайн-режим

Чтобы добавить файл, откройте карточку объекта и на нижней панели нажмите иконку "Файлы ()". На экране "Файлы ()" нажмите кнопку "Добавить", укажите источник добавления файла и выберите файл или несколько файлов, если выбранный источник поддерживает множественный выбор и загрузку файлов.

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

Отмена загрузки файла

Для отмены загрузки перейдите на другой экран до окончания процесса загрузки или нажмите на крестик в центре прогресс-бара .

Ошибки при загрузке файла

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

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

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

Офлайн-режим

Для добавления файла в офлайн-режиме карточка объекта должна быть сохранена в кэше приложения.

После добавления файла действие помещается в очередь синхронизации. На экране отображается сообщение: "Файл добавлен в очередь синхронизации и будет отправлен при появлении доступа к серверу".

Время добавления файла будет соответствовать дате и времени синхронизации с сервером.

Добавление файла как атрибута

Атрибуты типа "Файл" доступны для редактирования на формах добавления и редактирования.

В поле атрибута отображается: кнопка "Добавить файл" (1), список значений атрибута (названия файлов) (2), иконка для исключения файла из списка значений атрибута (3).

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

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

Ошибки при загрузке

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

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

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

  • "Повторить" — для повторной попытки загрузки файла.
  • "Убрать из списка" — для удаления файла из списка значений атрибута.
  • "Отмена" — для закрытия меню.

Удаление файлов

Удаление файлов доступно на экране "Файлы ()".

Онлайн-режим

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

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

Чтобы удалить выбранные файлы, нажмите иконку "Корзина".

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

Выход из режима выбора файлов выполняется при нажатии на иконку "Назад" на верхней панели экрана, при нажатии на системную кнопку "Назад", при снятии отметок выбора со всех файлов и после выполнения удаления.

Офлайн-режим

Для удаления файла в офлайн-режиме карточка объекта должна быть сохранена в кэше приложения.

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

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

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