Создать книгу

Элемент создает новую пустую книгу Excel в OneDrive или в библиотеке SharePoint и возвращает ссылку на нее. Для корректной работы следует поместить элемент в контейнер Microsoft 365.

Созданная книга содержит один лист с именем Лист1.

Свойства

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

Свойство	Тип	Описание
Аккаунт:
Учетная запись	String	Пользователь, в OneDrive которого создается книга, например `"robot@company.ru"`. Если не заполнено и не указана Папка — OneDrive пользователя, под которым выполнен вход
Параметры:
Имя*	String	Имя файла книги с расширением, например `"Отчет.xlsx"`
Папка	DriveItem	Папка OneDrive или SharePoint, в которой создается книга. Получается элементами Получить файл или папку, Найти папки и файлы или Создать папку. Если не заполнено — корень диска
Конфликт	-	Действие, если файл с таким именем уже существует. Доступные значения: `Replace` — заменить, `Fail` — завершить с ошибкой, `Rename` — создать файл с измененным именем. По умолчанию `Replace`
Результат:
Результат	DriveItem	Переменная для сохранения созданной книги. Используется как значение свойства Книга в других элементах Excel
URL	String	Переменная для сохранения веб-адреса книги

Важно: Расширение .xlsx автоматически не добавляется — указывайте его в свойстве Имя.

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

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

Пример 1: ежедневный отчет в OneDrive робота

Учетная запись: "robot@company.ru"
Имя: "Отчет_" + DateTime.Today.ToString("yyyy-MM-dd") + ".xlsx"
Конфликт: Rename
Результат: book

Далее — Запись в диапазон с Книгой book и Листом "Лист1".

Пример 2: книга в папке SharePoint

Получить файл или папку — папка Отчеты на сайте SharePoint, результат — folder.
Создать книгу: Имя — "Итоги.xlsx", Папка — folder, Результат — book.

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

Ошибка	Причина и решение
`Не указано имя`	Не заполнено свойство Имя
`nameAlreadyExists`	Файл уже существует, а Конфликт = `Fail`
`Access is denied` / `/me request is only valid with delegated authentication flow`	При входе от имени приложения не заполнены ни Учетная запись, ни Папка