Excel

Элементы группы Office 365 → Excel предназначены для работы с книгами Excel, хранящимися в OneDrive или SharePoint: чтения и записи ячеек и диапазонов, работы с листами и таблицами. Microsoft Excel на машине робота не требуется — все операции выполняются в облаке через Microsoft Graph. Все элементы размещаются внутри контейнера Microsoft 365.

Необходимые разрешения Microsoft Graph: Files.ReadWrite.All, для книг в SharePoint дополнительно Sites.ReadWrite.All. Подробнее — в разделе Настройка доступа к Microsoft 365.

Элементы

• Создать книгу — создание новой книги Excel в OneDrive или SharePoint.
• Чтение диапазона — чтение диапазона ячеек в таблицу данных.
• Прочитать ячейку — чтение значения одной ячейки.
• Читать колонку — чтение значений столбца начиная с указанной ячейки.
• Читать строку — чтение значений строки начиная с указанной ячейки.
• Запись в ячейку — запись значения в ячейку.
• Запись в диапазон — запись таблицы данных в диапазон.
• Добавить диапазон — добавление строк после последней заполненной строки листа.
• Копировать диапазон — копирование значений или формул диапазона.
• Очистить диапазон — очистка диапазона.
• Удалить диапазон — удаление ячеек со сдвигом.
• Поиск в диапазоне — поиск значения в диапазоне (аналог функции ВПР).
• Получить цвет ячейки — получение цвета заливки ячейки.
• Установить цвет диапазона — установка цвета заливки диапазона.
• Листы — получение списка, добавление, копирование, переименование и удаление листов.
• Таблицы — создание таблиц Excel, вставка и удаление строк и столбцов таблиц.

Общие свойства элементов

Книга — объект DriveItem, указывающий на файл .xlsx. Его возвращают элементы группы Файлы — Получить файл или папку, Найти папки и файлы, Загрузить файл, а также элемент Создать книгу. Путь к файлу или его URL в свойство Книга передать нельзя.

Лист — имя листа книги, например "Лист1". Регистр букв не важен.

Диапазон и Ячейка — адрес в формате A1: "A1", "B2:D10".

Важно: Во всех элементах имя листа по умолчанию — "Sheet1". В книгах, созданных в русскоязычном Excel, и в книгах, созданных элементом Создать книгу, первый лист называется "Лист1" — укажите имя листа явно.

Примечание: Изменения сохраняются в книге сразу после выполнения элемента. Если книга одновременно открыта у пользователя в Excel Online, он увидит изменения в реальном времени.

Типовой сценарий

1. Найти папки и файлы — найти книгу в OneDrive, результат — files.
2. Выбрать нужный файл выражением files.First(f => f.Name == "Отчет.xlsx") и сохранить в переменную book.
3. Чтение диапазона — прочитать данные листа в DataTable.
4. Обработать данные и записать результат элементом Запись в диапазон или Добавить диапазон.