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());
	}
);