Документация для разработчиков
Темная тема

disk.storage.uploadfile

Scope: disk Права на выполнение: для всех

Описание

disk.storage.uploadfile

Загружает новый файл в корне хранилища.

В случае успеха возвращает структуру, аналогичную приведенной в disk.file.get.

Пример ответа:

"result": {
	"ID": "10",
	"NAME": "2511.jpg",
	"CODE": null,
	"STORAGE_ID": "4",
	"TYPE": "file",
	"PARENT_ID": "8",
	"DELETED_TYPE": "0",
	"CREATE_TIME": "2015-04-24T10:41:51+03:00",
	"UPDATE_TIME": "2015-04-24T15:52:43+03:00",
	"DELETE_TIME": null,
	"CREATED_BY": "1",
	"UPDATED_BY": "1",
	"DELETED_BY": "0",
	"DOWNLOAD_URL": "https://test.bitrix24.ru/disk/downloadFile/10/?&ncc=1&filename=2511.jpg&auth=******",
	"DETAIL_URL": "https://test.bitrix24.ru/workgroups/group/3/disk/file/2511.jpg"
}

Параметры

Параметр Описание
id Идентификатор хранилища.
fileContent Аналогично 'DETAIL_PICTURE' в примере Обработка файлов.
data Массив, описывающий файл. Обязательное поле NAME - имя нового файла.
generateUniqueName Необязательный, по умолчанию false. При указании true, для загружаемого файла будет уникализировано имя, добавлением суффикса (1), (2) Пример:

avatar (1).jpg
avatar (2).jpg
и т.п.
rights Необязательный, по умолчанию пустой массив. Массив прав доступа на загружаемый файл.

Пример

Обратите внимание, что список доступных идентификаторов `TASK_ID` для установки прав можно получить rest-методом disk.rights.getTasks.

BX24.callMethod(
	"disk.storage.uploadFile",
	{
		id: 4,
		data: {
			NAME: "avatar.jpg"
		},
		fileContent: document.getElementById('test_file_input'),
		generateUniqueName: true,
		rights: [
			{
				TASK_ID: 42,
				ACCESS_CODE: 'U35' //доступ для пользователя с ID=35, для получения названия типа доступа можно воспользоваться https://dev.1c-bitrix.ru/rest_help/general/access_name.php
			},
			{
				TASK_ID: 38,
				ACCESS_CODE: 'U2' //доступ для пользователя с ID=35, для получения названия типа доступа можно воспользоваться https://dev.1c-bitrix.ru/rest_help/general/access_name.php
			}
			]
	},
	function (result)
	{
		if (result.error())
			console.error(result.error());
		else
			console.dir(result.data());
	}
);


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

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

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
0
Алексей Коновалов
Сообщение не промодерировано, возможны ошибки и неточности.
А где метод который позволяет получить список прав по уже загруженному в хранилище файлу или папке ?
3
Антон Долганин
Обратите особое внимание - метод грузит именно в корень. Вроде бы логична возможность тут в параметры добавить и айди папки, чтобы грузило сразу туда, но нет - здесь исключительно в корень.
Для загрузки в папку, используйте соответствующие методы по работе с папками.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024