Получить файл или папку

Элемент получает файл или папку OneDrive или SharePoint по идентификатору либо по ссылке и сохраняет в переменную типа DriveItem. Для корректной работы следует поместить элемент в контейнер Microsoft 365.

Свойства

Описание общих свойств элемента см. в разделе Свойства элемента . Символ * в названии свойства указывает на обязательность его заполнения.

Свойство	Тип	Описание
Аккаунт:
Учетная запись	String	Пользователь, в OneDrive которого находится объект. Используется вместе с ID. См. Где искать файлы
SharePoint:
URL	String	Адрес сайта SharePoint. Используется вместе с ID
Диск	String	Имя библиотеки документов. Используется вместе с ID
Параметры:
ID*	String	Идентификатор файла или папки. Значение `"root"` — корневая папка диска
URL файла*	String	Ссылка на файл: адрес из адресной строки браузера или ссылка «Поделиться». Если заполнено, ID, Учетная запись, URL и Диск не учитываются
Результат:
Результат	DriveItem	Переменная для сохранения полученного объекта

Примечание: Должно быть заполнено хотя бы одно из свойств ID или URL файла.

Практические примеры

Пример 1: файл по ссылке из письма

URL файла: "https://company.sharepoint.com/:x:/s/Finance/EaBcD..."
Результат: file

Пример 2: корневая папка библиотеки SharePoint

URL: "https://company.sharepoint.com/sites/Finance"
Диск: "Документы"
ID: "root"
Результат: rootFolder

Полученную папку можно передать в свойство Папка элементов Создать папку и Загрузить файл.

Пример 3: файл по сохраненному идентификатору

Учетная запись: "robot@company.ru"
ID: savedFileId
Результат: file

Возможные ошибки

Ошибка	Причина и решение
`Не указан ни ID ни URL файла`	Не заполнены ни ID, ни URL файла
`itemNotFound`	Объект с таким ID не найден на выбранном диске
`accessDenied`	Нет доступа к файлу по ссылке или не выданы разрешения