Поделиться через

Excel Online (бизнес)

Соединитель Excel Online (Бизнес) позволяет работать с файлами Excel в библиотеках документов, поддерживаемых Microsoft Graph (OneDrive для бизнеса, сайтов SharePoint и групп Office 365).

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Стандарт Все регионы Power Automate , кроме следующих:
     — Облако Китая, управляемое 21Vianet
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     — Регионы Azure Для Китая
Power Apps Стандарт Все регионы Power Apps , кроме следующих:
     — Облако Китая, управляемое 21Vianet
Power Automate Стандарт Все регионы Power Automate , кроме следующих:
     — Облако Китая, управляемое 21Vianet
Контакт
Имя Excel Online (бизнес)
URL https://learn.microsoft.com/en-us/connectors/excelonlinebusiness/
Адрес электронной почты [email protected]
Метаданные соединителя
Publisher Microsoft
Website https://products.office.com/excel
Политика конфиденциальности https://privacy.microsoft.com/
Категории Искусственный интеллект; Бизнес-аналитика

Известные проблемы и ограничения с действиями

Краткое описание Operations Длинное описание
Устаревшие данные Вывод списка строк, присутствующих в таблице Данные могут не быть актуальными (может быть некоторая задержка) при фильтрации или сортировке используется в строках списка, присутствующих в действии таблицы .
Возможности фильтрации Вывод списка строк, присутствующих в таблице Строки списка, присутствующих в действии таблицы, поддерживают базовую фильтрацию и сортировку:
— поддерживает следующие функции фильтра: eq, ne, contains, startswith. endswith
— К столбцу может применяться только 1 функция фильтра.
— Для сортировки можно использовать только 1 столбец.
Фильтры с накоплением Вывод списка строк, присутствующих в таблице Если фильтр применяется с помощью строк списка действий, присутствующих в таблице, он будет добавлен поверх существующих фильтров.
Не стекаемые фильтры Вывод списка строк, присутствующих в таблице Если фильтр не применяется с помощью строк списка, присутствующих в действии таблицы, все фильтры, уже заданные в файле Excel, будут игнорироваться. Действие извлекает все строки независимо от существующих фильтров в Excel.
Постраничная разбивка Вывод списка строк, присутствующих в таблице Строки списка, присутствующих в действии таблицы, возвращают до 256 строк по умолчанию. Чтобы получить все строки, включите разбивку на страницы.
Выбор неквалентных строк Вывод списка строк, присутствующих в таблице Соединитель извлекает строки для 500 столбцов максимум в строках списка, присутствующих в действии таблицы . Строки для первых 500 столбцов возвращаются по умолчанию. Список отдельных столбцов, разделенных запятыми, можно указать в параметре Select Query .
Имя поля ключевого столбца Добавление ключевого столбца в таблицу
Удаление строки
Получение строки
Обновление строки		 Поле ключевого столбца учитывает регистр.
Обновление и удаление нескольких строк Удаление строки
Обновление строки		 В случае нескольких совпадений в таких операциях, как обновление строки и удаление строки, будет обновлена или удалена только первая строка.
Поддержка электронной таблицы в Microsoft Excel Macro-Enabled Запуск скрипта Действие скрипта запуска также поддерживает формат Электронной таблицы (*.xlsm) Microsoft Excel Macro-Enabled. Дополнительные сведения см. в разделе "Использование файлов макросов в потоках Power Automate".
Ограничение заголовков столбцов таблицы Добавление строки
Обновление строки
Удаление строки		 Изменения, зафиксированные операциями, такими как добавление строки, обновление строки, удаление строки не всегда влияет сразу после успешного ответа от соответствующих действий Power Automate, LogicApps или Power Apps. Ожидается задержка до 30 секунд из-за базовых ограничений серверной службы.
Ограничения операций выполнения скрипта Запуск скрипта Выполнение операции скрипта позволяет выполнять до 3 вызовов в 10 секунд и до 1600 вызовов в день.
Поддержка независимых облаков для выполнения операций скрипта Запуск скрипта Операция выполнения скрипта недоступна в национальных облаках (включая Gcc, GccHigh, DoD и другие более высокие облака).

Распространенные ошибки

Ошибка Solution
403 Запрещено Убедитесь, что файл имеет доступ на запись.
502 BadGateway Эти ошибки будут отображаться, если электронная таблица находится в режиме только для чтения. Чтобы узнать об отключении режима только для чтения, перейдите к разделу "Изменить электронную таблицу Excel" только для чтения.
429 — слишком много запросов Это происходит, если пользователь выполняет слишком много запросов в течение короткого периода времени. Ограничение регулирования уникально для каждого запроса и зависит от количества запросов, используемого памяти и других важных факторов. Если происходит регулирование, рекомендуется добавить явные задержки вокруг действия соединителя.
Из-за ограничений регулирования в API Graph это также может произойти из-за нескольких причин:
1. Если глобальное число запросов из потока превышает ограничение, некоторые запросы будут регулироваться. Какие запросы получают регулирование и которые не выбираются случайным образом решением регулирования Azure.
2. Даже если он не попал в предел в #1, он может по-прежнему регулироваться из-за разных причин. Ниже приведены наиболее распространенные причины регулирования:
a. Нажмите на политику регулирования служб Sharepoint.
б. Например, политика службы Excel Online была заполнена из-за слишком большого количества запросов.
c. Запрос ожидается в очереди дольше, чем ожидалось. Например, запросы, которые занимают больше 30-х, могут возвращать 504 и продолжать 504 в результате регулирования.
d. Слишком много последовательных сбоев в сеансе книги.
д) Когда запрос выполняется в OfficeScripting по идентификатору операции RunScriptProd, и если эти запросы более 3 в течение 10 секунд, он регулируется.

Общие известные проблемы и ограничения

  • Максимальный размер файла Excel, поддерживаемого соединителем Excel Online (бизнес), составляет 25 МБ.
  • Файл Excel может быть заблокирован для обновления или удаления до 6 минут с момента последнего использования соединителя.
  • Одновременные изменения файлов, внесенные другими соединителями, или изменения вручную не поддерживаются. Пользователи должны избегать записи данных в один файл Excel из нескольких клиентов одновременно (Excel Desktop, Excel Web, Power Automate, LogicApps или Power Apps). Это может привести к возможным конфликтам слияния и несоответствию данных.
  • Соединитель поддерживает файлы в форматах электронной таблицы Microsoft Excel Open XML (*.xlsx) и двоичной книги Microsoft Excel (*.xlxb).
  • Свойство File , ожидаемое действиями соединителя, должно быть заполнено одним из следующих параметров:
    • Выберите файл из средства выбора файлов.
    • Используйте выходные данные из триггеров и действий соединителя OneDrive для бизнеса (файл Id или File identifier свойство, в зависимости от того, какой из них присутствует для конкретного действия или триггера OneDrive для бизнеса).
    • Используйте выходные данные триггеров и действий соединителя SharePoint (файл или Identifier свойствоId, в зависимости от того, какой из них присутствует для конкретного действия или триггера SharePoint).
    • Введите путь к файлу, начиная с диска. Примеры:
      • Если файл находится в OneDrive , а полный путь — OneDrive/file.xlsx , а параметр Drive — OneDriveвходные file.xlsx.
      • Если файл находится в группах O365 и полный путь — Documents/Inner Documents/file.xlsx, а параметр диска — Documentsвходные внутренние документы/file.xlsx.
  • Соединитель не поддерживает использование параметров OData для таблиц, содержащих скрытые столбцы.
  • Время ожидания соединителя, вызванное повторными вычислениями, может произойти, если есть сложные формулы или слишком много строк на листе. В обоих случаях данные можно вставить несколько раз из-за политики повторных попыток. В качестве обходного решения можно узнать, могут ли быть упрощены или сокращены формулы. В противном случае можно задать режим вычисления для этой книги вручную. Дополнительные сведения см. здесь.
  • Filter Query / Order By / Select Query Параметры операции поддерживают только буквенно-цифровые имена столбцов.
  • Таблицы сводной таблицы не поддерживаются из-за ограничений API Graph.
  • Соединитель всегда возвращает все библиотеки документов, доступные в раскрывающемся списке библиотеки документов. Для большинства пользователей будет возвращена только одна библиотека документов, но если доступно несколько, все из них будут перечислены. Чтобы узнать больше о библиотеке документов (например, о ресурсах диска) и ожидаемом поведении для пользователей, групп и сайтов, перейдите к списку дисков — примечания.
  • Соединитель может заполнять до 64 000 строк автоматически, если параметр "Вставить автоматически созданный идентификатор в таблицу Excel " выбран во время импорта таблицы в Power Apps.
  • Заголовки столбцов таблиц, содержащие только число, могут привести к непредвиденному поведению в операциях, таких как обновление строки, удаление строки из-за ограничений серверной службы. В качестве обходного решения переименуйте такие столбцы, чтобы они также содержали другие символы.
  • Файл Excel может быть изменен, и новая версия может отображаться в журнале версий файла, даже если выполняется действие только для чтения. Это поведение обусловлено внутренними механизмами сохранения серверной службы соединителя.
  • Гостевые пользователи не могут получить доступ к документу, если они находятся в другом клиенте, чем у основных пользователей. В этом случае пользователь получит ошибку HTTP 404 (не найдена).
  • В Fairfax Logic Apps этот соединитель поддерживает только подключения с помощью коммерческой учетной записи (.com).
  • Файлы SharePoint могут быть недоступны. API Graph не передает IP-адрес пользователя в SharePoint. Таким образом, если включена политика на основе расположения, SharePoint не может определить, находится ли пользователь в пределах доверенной границы. По этой причине при доступе к библиотеке SharePoint может появиться сообщение об ошибке "Из-за политик организации вы не сможете получить доступ к этим ресурсам из этого сетевого расположения". Дополнительные сведения см. здесь.
  • Средство выбора файлов будет отображать только до 200 элементов в папке. Пользователи могут столкнуться с проблемами при поиске элементов, если у них более 200 элементов в папке.
  • При наличии непрерывных ошибок 504 клиенты могут столкнуться с регулированием из-за различных ограничений API Graph. Ниже приведены некоторые рекомендации по сокращению 504 для длительных операций:
    • Обновите таблицу, чтобы она была максимально простой с меньшим количеством формул и зависимостей.
    • Используйте другой пустой лист или книгу с тем же форматом таблицы, если число строк большое.
  • Для всех действий требуется доступ на запись к файлу, в противном случае API Graph вернет 403 Forbidden ошибку. Кроме того, соединитель вернет ошибку 502 BadGateway , если электронная таблица находится в режиме только для чтения. Чтобы отключить режим только для чтения, см. дополнительные сведения здесь.
  • Максимальный поддерживаемый размер каждого запроса соединителя составляет 5 МБ.

Обработка имен столбцов

Имена столбцов в результатах ответа действия можно преобразовать для совместимости с форматом OData:

Character Закодированное значение
. _x002e_
@ _x0040_
: _x003a_
# _x0023_

Например, Column [one]#1 —>Column [one]_x0023_1

Общие ограничения

Имя Ценность
Максимальное количество вариантов столбцов удостоверений, которые можно использовать для получения и вставки, обновления и удаления строки из одной таблицы Excel. Текущее значение имеет значение 2, что означает, что для одной конкретной таблицы должно использоваться до двух вариантов имени столбца. 2

Основные понятия и примеры

  • Ключевой столбец: Столбец в таблице, которая будет использоваться для поиска значения (ключевого значения).
  • Значение ключа: Значение в ключевом столбце, который будет использоваться для идентификации определенной строки.

В следующей таблице приведен пример. Для выполнения операции строки во второй строке таблицы key column должно быть Column 1key value и должно быть 200.

Столбец 1 Столбец 2 Столбец 3
100 A-2 A-3
200 B-2 B-3
300 C-2 C-3

Ограничения регулирования

Имя Вызовы Период обновления
Вызовы API для каждого подключения 100 60 секунд

Действия

Вывод списка строк, присутствующих в таблице

Вывод списка строк, присутствующих в таблице.
Добавление ключевого столбца в таблицу

Добавьте ключевой столбец в таблицу Excel. Новый столбец будет добавлен справа.
Добавление строки в таблицу

Добавьте новую строку в таблицу Excel.
Добавление строки в таблицу [НЕ РЕКОМЕНДУЕТСЯ]

Это действие устарело. Вместо этого используйте строку "Добавить в таблицу ".

Добавьте новую строку в таблицу Excel.
Запуск скрипта

Запускает скрипт Office для книги Excel. Используйте это действие при сохранении скрипта в расположении по умолчанию.
Запуск скрипта из библиотеки SharePoint

Запускает скрипт Office для книги Excel. Используйте это действие, если скрипт сохраняется вне расположения по умолчанию.
Обновить строку

Обновите строку с помощью ключевого столбца. Входное значение перезаписывает указанные ячейки и столбцы, оставшиеся пустыми, не будут обновлены. Чтобы добавить (вместо перезаписи) значение, используйте действие "Получить строку", чтобы сначала получить содержимое.
Получение листов

Получите список листов в книге Excel.
Получение строки

Получение строки с помощью ключевого столбца.
Получение таблиц

Получение списка таблиц в книге Excel.
Создание листа

Создайте лист в книге Excel.
Создание таблицы

Создайте таблицу в книге Excel.
Удаление строки

Удалите строку с помощью ключевого столбца.

Вывод списка строк, присутствующих в таблице

Идентификатор операции:
GetItems

Вывод списка строк, присутствующих в таблице.

Параметры

Имя Ключ Обязательно Тип Описание
Местоположение
 source True string

Выберите из раскрывающегося списка или укажите один из следующих вариантов: "me" - "URL-адрес сайта SharePoint" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (двоеточие обязательны).
Библиотека документов
 drive True string

Выберите библиотеку документов из раскрывающегося списка.
Файл
 file True string

Выберите файл Excel с помощью обзора файлов.
Таблица
 table True string

Выберите таблицу из раскрывающегося списка.
Запрос фильтра
 $filter string

Запрос фильтра ODATA для ограничения возвращаемых записей.
Заказ по
 $orderby string

Запрос oDATA orderBy для указания порядка записей.
Первое число
 $top integer

Общее количество записей для получения (по умолчанию = все).
Пропустить число
 $skip integer

Количество пропускаемых записей (по умолчанию = 0).
Выбор запроса
 $select string

Список столбцов, разделенных запятыми (сначала 500 по умолчанию).
Формат DateTime
 dateTimeFormat string

Формат DateTime.
Извлечение метки конфиденциальности
 extractSensitivityLabel boolean

Логическое значение, указывающее, следует ли извлекать идентификатор метки конфиденциальности для связанного артефакта.
Метаданные метки конфиденциальности
 fetchSensitivityLabelMetadata boolean

Логическое значение, указывающее, следует ли получить метаданные метки конфиденциальности для связанного LabelId.

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Добавление ключевого столбца в таблицу

Идентификатор операции:
CreateIdColumn

Добавьте ключевой столбец в таблицу Excel. Новый столбец будет добавлен справа.

Параметры

Имя Ключ Обязательно Тип Описание
Местоположение
 source True string

Выберите из раскрывающегося списка или укажите один из следующих вариантов: "Me" - "URL-адрес сайта SharePoint" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (обязательны двоеточия).
Библиотека документов
 drive True string

Выберите библиотеку документов из раскрывающегося списка.
Файл
 file True string

Выберите файл Excel с помощью обзора файлов.
Таблица
 table True string

Выберите таблицу из раскрывающегося списка.
Ключевой столбец
 idColumn string

Укажите имя ключевого столбца.

Добавление строки в таблицу

Идентификатор операции:
AddRowV2

Добавьте новую строку в таблицу Excel.

Параметры

Имя Ключ Обязательно Тип Описание
Местоположение
 source True string

Выберите в раскрывающемся списке или укажите один из следующих вариантов: "Me" - "URL-адрес сайта SharePoint" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (двоеточие обязательны).
Библиотека документов
 drive True string

Выберите библиотеку документов из раскрывающегося списка.
Файл
 file True string

Выберите файл Excel с помощью обзора файлов.
Таблица
 table True string

Выберите таблицу из раскрывающегося списка.
Row
 item True dynamic

Строка для добавления в указанную таблицу Excel.
Формат DateTime
 dateTimeFormat string

Формат DateTime.

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Добавление строки в таблицу [НЕ РЕКОМЕНДУЕТСЯ]

Идентификатор операции:
AddRow

Это действие устарело. Вместо этого используйте строку "Добавить в таблицу ".

Добавьте новую строку в таблицу Excel.

Параметры

Имя Ключ Обязательно Тип Описание
Местоположение
 source True string

Выберите в раскрывающемся списке или укажите один из следующих вариантов: "Me" - "URL-адрес сайта SharePoint" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (двоеточие обязательны).
Библиотека документов
 drive True string

Выберите библиотеку документов из раскрывающегося списка.
Файл
 file True string

Выберите файл Excel с помощью обзора файлов.
Таблица
 table True string

Выберите таблицу из раскрывающегося списка.
Row
 item True dynamic

Строка для вставки в указанную таблицу Excel.

Запуск скрипта

Идентификатор операции:
RunScriptProd

Запускает скрипт Office для книги Excel. Используйте это действие при сохранении скрипта в расположении по умолчанию.

Параметры

Имя Ключ Обязательно Тип Описание
Местоположение
 source True string

Выберите в раскрывающемся списке или укажите один из следующих вариантов: "Me" - "URL-адрес сайта SharePoint" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (двоеточие обязательны).
Библиотека документов
 drive True string

Выберите библиотеку документов из раскрывающегося списка.
Файл
 file True string

Выберите файл Excel с помощью обзора файлов.
Скрипт
 scriptId True string

Выберите сценарий Office, который вы хотите запустить в раскрывающемся списке.
ScriptParameters
 ScriptParameters True dynamic

Укажите параметры скрипта Office.

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Запуск скрипта из библиотеки SharePoint

Идентификатор операции:
RunScriptProdV2

Запускает скрипт Office для книги Excel. Используйте это действие, если скрипт сохраняется вне расположения по умолчанию.

Параметры

Имя Ключ Обязательно Тип Описание
Расположение книги
 source True string

Выберите в раскрывающемся списке или укажите один из следующих вариантов: "Me" - "URL-адрес сайта SharePoint" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (двоеточие обязательны).
Библиотека книг
 drive True string

Выберите библиотеку документов из раскрывающегося списка.
Книга
 file True string

Выберите книгу Excel с помощью обзора файлов.
Расположение скрипта
 scriptSource True string

Выберите из раскрывающегося списка или укажите один из следующих вариантов: "Me" - "URL-адрес сайта SharePoint" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (обязательны двоеточия).
Библиотека сценариев
 scriptDrive True string

Выберите библиотеку SharePoint файла скрипта Office (OSTS) в раскрывающемся списке.
Скрипт
 scriptId True string

Выберите файл скрипта Office (OSTS) в библиотеке SharePoint в раскрывающемся списке.
ScriptParameters
 ScriptParameters True dynamic

Укажите параметры скрипта Office.

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Обновить строку

Идентификатор операции:
PatchItem

Обновите строку с помощью ключевого столбца. Входное значение перезаписывает указанные ячейки и столбцы, оставшиеся пустыми, не будут обновлены. Чтобы добавить (вместо перезаписи) значение, используйте действие "Получить строку", чтобы сначала получить содержимое.

Параметры

Имя Ключ Обязательно Тип Описание
Местоположение
 source True string

Выберите из раскрывающегося списка или укажите один из следующих вариантов: "me" - "URL-адрес сайта SharePoint" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (двоеточие обязательны).
Библиотека документов
 drive True string

Выберите библиотеку документов из раскрывающегося списка.
Файл
 file True string

Выберите файл Excel с помощью обзора файлов.
Таблица
 table True string

Выберите таблицу из раскрывающегося списка.
Ключевой столбец
 idColumn True string

Выберите столбец из раскрывающегося списка.
Значение ключа
 id True string

Введите значение ключа.
Укажите свойства элемента
 item True dynamic

Укажите свойства элемента.
Формат DateTime
 dateTimeFormat string

Формат DateTime.

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Получение листов

Идентификатор операции:
GetAllWorksheets

Получите список листов в книге Excel.

Параметры

Имя Ключ Обязательно Тип Описание
Местоположение
 source True string

Выберите в раскрывающемся списке или укажите один из следующих вариантов: "Me" - "URL-адрес сайта SharePoint" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (двоеточие обязательны).
Библиотека документов
 drive True string

Выберите библиотеку документов из раскрывающегося списка.
Файл
 file True string

Выберите файл Excel с помощью обзора файлов.
Извлечение метки конфиденциальности
 extractSensitivityLabel boolean

Логическое значение, указывающее, следует ли извлекать идентификатор метки конфиденциальности для связанного артефакта.
Метаданные метки конфиденциальности
 fetchSensitivityLabelMetadata boolean

Логическое значение, указывающее, следует ли получить метаданные метки конфиденциальности для связанного LabelId.

Возвращаемое значение

Имя Путь Тип Описание
value
 value array of WorksheetMetadata
sensitivityLabelInfo
 sensitivityLabelInfo array of SensitivityLabelMetadata

Получение строки

Идентификатор операции:
GetItem

Получение строки с помощью ключевого столбца.

Параметры

Имя Ключ Обязательно Тип Описание
Местоположение
 source True string

Выберите из раскрывающегося списка или укажите один из следующих вариантов: "me" - "URL-адрес сайта SharePoint" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (двоеточие обязательны).
Библиотека документов
 drive True string

Выберите библиотеку документов из раскрывающегося списка.
Файл
 file True string

Выберите файл Excel с помощью обзора файлов.
Таблица
 table True string

Выберите таблицу из раскрывающегося списка.
Ключевой столбец
 idColumn True string

Выберите столбец из раскрывающегося списка.
Значение ключа
 id True string

Введите значение ключа.
Формат DateTime
 dateTimeFormat string

Формат DateTime.
Извлечение метки конфиденциальности
 extractSensitivityLabel boolean

Логическое значение, указывающее, следует ли извлекать идентификатор метки конфиденциальности для связанного артефакта.
Метаданные метки конфиденциальности
 fetchSensitivityLabelMetadata boolean

Логическое значение, указывающее, следует ли получить метаданные метки конфиденциальности для связанного LabelId.

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Получение таблиц

Идентификатор операции:
GetTables

Получение списка таблиц в книге Excel.

Параметры

Имя Ключ Обязательно Тип Описание
Местоположение
 source True string

Выберите в раскрывающемся списке или укажите один из следующих вариантов: "Me" - "URL-адрес сайта SharePoint" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (двоеточие обязательны).
Библиотека документов
 drive True string

Выберите библиотеку документов из раскрывающегося списка.
Файл
 file True string

Выберите файл Excel с помощью обзора файлов.
Извлечение метки конфиденциальности
 extractSensitivityLabel boolean

Логическое значение, указывающее, следует ли извлекать идентификатор метки конфиденциальности для связанного артефакта.
Метаданные метки конфиденциальности
 fetchSensitivityLabelMetadata boolean

Логическое значение, указывающее, следует ли получить метаданные метки конфиденциальности для связанного LabelId.

Возвращаемое значение

Имя Путь Тип Описание
value
 value array of object
Идентификатор
 value.id string

Идентификатор таблицы.
Имя
 value.name string

Имя таблицы.
Отображение столбцов с чередованием
 value.showBandedColumns boolean

Отображение группированных столбцов.
Выделение первого столбца
 value.highlightFirstColumn boolean

Выделите первый столбец.
Выделение последнего столбца
 value.highlightLastColumn boolean

Выделите последний столбец.
Отображение строк с чередованием
 value.showBandedRows boolean

Показывать чередуемые строки.
Кнопка "Показать фильтр"
 value.showFilterButton boolean

Кнопка "Показать фильтр".
Отображение заголовков
 value.showHeaders boolean

Показывать заголовки.
Отображение итогов
 value.showTotals boolean

Показать итоги.
Style
 value.style string

Стиль таблицы.
sensitivityLabelInfo
 sensitivityLabelInfo array of SensitivityLabelMetadata

Создание листа

Идентификатор операции:
CreateWorksheet

Создайте лист в книге Excel.

Параметры

Имя Ключ Обязательно Тип Описание
Местоположение
 source True string

Выберите в раскрывающемся списке или укажите один из следующих вариантов: "Me" - "URL-адрес сайта SharePoint" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (двоеточие обязательны).
Библиотека документов
 drive True string

Выберите библиотеку документов из раскрывающегося списка.
Файл
 file True string

Выберите файл Excel с помощью обзора файлов.
Имя
 name string

Имя листа.

Возвращаемое значение

Тело
WorksheetMetadata

Создание таблицы

Идентификатор операции:
CreateTable

Создайте таблицу в книге Excel.

Параметры

Имя Ключ Обязательно Тип Описание
Местоположение
 source True string

Выберите из раскрывающегося списка или укажите один из следующих вариантов: "Me" - "URL-адрес сайта SharePoint" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (обязательны двоеточия).
Библиотека документов
 drive True string

Выберите библиотеку документов из раскрывающегося списка.
Файл
 file True string

Выберите файл Excel с помощью обзора файлов.
Имя таблицы
 TableName string

Введите имя таблицы Excel.
Диапазон таблиц
 Range True string

Введите адрес таблицы с помощью нотации A1.
Имена столбцов
 ColumnsNames string

Введите имена столбцов, разделенных ";" или ",".

Возвращаемое значение

Метаданные таблицы

Тело
TableMetadata

Удаление строки

Идентификатор операции:
DeleteItem

Удалите строку с помощью ключевого столбца.

Параметры

Имя Ключ Обязательно Тип Описание
Местоположение
 source True string

Выберите из раскрывающегося списка или укажите один из следующих вариантов: "me" - "URL-адрес сайта SharePoint" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (двоеточие обязательны).
Библиотека документов
 drive True string

Выберите библиотеку документов из раскрывающегося списка.
Файл
 file True string

Выберите файл Excel с помощью обзора файлов.
Таблица
 table True string

Выберите таблицу из раскрывающегося списка.
Ключевой столбец
 idColumn True string

Выберите столбец из раскрывающегося списка.
Значение ключа
 id True string

Введите значение ключа.

Триггеры

Для выбранной строки

Активирует поток для выбранной строки в таблице Excel. (Доступно только для Power Automate.)

Для выбранной строки

Идентификатор операции:
OnRowSelected

Активирует поток для выбранной строки в таблице Excel. (Доступно только для Power Automate.)

Параметры

Имя Ключ Обязательно Тип Описание
operationId
 operationId True string
host
 host object
parameters
 parameters True object
schema
 schema True object
headersSchema
 headersSchema object

Возвращаемое значение

Имя Путь Тип Описание
Строк
 body.rows array of object
items
 body.rows object
Идентификатор пользователя
 headers.x-ms-user-id-encoded guid

Уникальный идентификатор пользователя, активировавшего поток в AAD.
Электронная почта пользователя
 headers.x-ms-user-email-encoded byte

Адрес электронной почты пользователя, активировавшего поток.
Имя пользователя
 headers.x-ms-user-name-encoded byte

Отображаемое имя пользователя, активировавшего поток.
Отметка времени
 headers.x-ms-user-timestamp string

Время активации потока.

Определения

TableMetadata

Метаданные таблицы

Имя Путь Тип Описание
имя
 name string

Имя таблицы
title
 title string

Заголовок таблицы
X-ms-permission
 x-ms-permission string

Разрешение таблицы
возможности-x-ms
 x-ms-capabilities TableCapabilitiesMetadata

Метаданные таблицы (возможности)
schema
 schema Object
referencedEntities
 referencedEntities Object
webUrl
 webUrl string

Ссылка url-адреса

TableCapabilitiesMetadata

Метаданные таблицы (возможности)

Имя Путь Тип Описание
sortRestrictions
 sortRestrictions TableSortRestrictionsMetadata

Метаданные таблицы (ограничения сортировки)
filterRestrictions
 filterRestrictions TableFilterRestrictionsMetadata

Метаданные таблицы (ограничения фильтра)
selectRestrictions
 selectRestrictions TableSelectRestrictionsMetadata

Метаданные таблицы (выбор ограничений)
isOnlyServerPagable
 isOnlyServerPagable boolean

Ограничения на разбиение по страницам сервера
filterFunctionSupport
 filterFunctionSupport array of string

Список поддерживаемых возможностей фильтра
serverPagingOptions
 serverPagingOptions array of string

Список поддерживаемых возможностей подкачки на основе сервера

Object

TableSortRestrictionsMetadata

Метаданные таблицы (ограничения сортировки)

Имя Путь Тип Описание
Сортируемый
 sortable boolean

Указывает, имеет ли эта таблица сортируемые столбцы
unsortableProperties
 unsortableProperties array of string

Список несортируемых свойств
возрастаниеOnlyProperties
 ascendingOnlyProperties array of string

Список свойств, поддерживающих только возрастание

TableFilterRestrictionsMetadata

Метаданные таблицы (ограничения фильтра)

Имя Путь Тип Описание
Фильтруемый
 filterable boolean

Указывает, имеет ли эта таблица фильтруемые столбцы
nonFilterableProperties
 nonFilterableProperties array of string

Список нефильтруемых свойств
requiredProperties
 requiredProperties array of string

Список обязательных свойств

TableSelectRestrictionsMetadata

Метаданные таблицы (выбор ограничений)

Имя Путь Тип Описание
Выбор
 selectable boolean

Указывает, имеет ли эта таблица доступные для выбора столбцы

WorksheetMetadata

Имя Путь Тип Описание
Идентификатор
 id string

Идентификатор листа.
Имя
 name string

Имя листа.
Position
 position integer

Положение листа.
Видимость
 visibility string

Видимость листа.

КонфиденциальностьLabelMetadata

Имя Путь Тип Описание
sensitivityLabelId
 sensitivityLabelId string

Идентификатор КонфиденциальностиLabel.
имя
 name string

Имя Конфиденциальности.
отображаемое имя
 displayName string

Сведения о отображаемом имени конфиденциальности
подсказка
 tooltip string

Сведения о конфиденциальности в подсказке.
priority
 priority integer

Приоритет КонфиденциальностиLabel.
color
 color string

Цвет КонфиденциальностиLabel.
Зашифровано
 isEncrypted boolean

— ЧувствительностьLabel Encrypted.
isEnabled
 isEnabled boolean

Включена ли ЧувствительностьLabel.
isParent
 isParent boolean

Указывает, является ли Конфиденциальность родительской.
parentSensitivityLabelId
 parentSensitivityLabelId string

Идентификатор родительской конфиденциальности.