### Добавление файла в хранилище {#sec.files_add}

Функция добавления файла в хранилище доступна только в меню 
«Создать» и соответствует пункту `upload_document` параметра 
API `files_items`. В соответствии с этим параметром название 
группового пункта меню может быть произвольным. Названия двух 
подпунктов неизменяемы: «С устройства» и «Сфотографировать».

Кроме наличия параметра в методе API для добавления файла 
необходимо наличие права «Добавление нового элемента» (`ADD`) 
на папку, в которой он будет расположен.

*   При выборе подпункта добавления файла «С устройства» 
    приложение выдает стандартное (системное) диалоговое окно 
    выбора файла.

*   При выборе подпункта добавления файла «Сфотографировать» 
    вызывается встроенный фотомодуль устройства. При таком 
    добавлении файла приложение должно задавать имя файлу в 
    следующем формате: `Снимок dd MM yyyy HH:mm`.

В случае успешного добавления сразу создается новая плашка 
файла в списке (по общепринятым правилам сортировки), иначе - 
отображается сообщение об ошибке:

*   Если введенное название файла совпадает с уже 
    существующим в данной родительской папке файлом:
    
    `Файл %название% уже существует. Действие не выполнено`

По нажатию "Отмена" действие не выполняется.

> **Примечание**
> 
> Метод для добавления файла в хранилище описан в javadoc:
> 
> kz.arta.synergy.server.api.rest.storage#add.
> 
> http://tdd.lan.arta.kz/docs/synergy/trunk/sdk-doc/javadoc/kz/arta/synergy/server/api/rest/storage/StorageService.html#add%28java.lang.String,%20java.lang.String,%20java.lang.String,%20java.lang.String%29




