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

Excel Online (OneDrive)

Поставщик подключений Excel Online (OneDrive) позволяет работать с файлами Excel, хранящимися в OneDrive. Этот поставщик подключений поддерживает только личные учетные записи (MSA).

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

Услуга Class Регионы
Copilot Studio Стандарт Все регионы Power Automate , кроме следующих:
     — Облако Китая, управляемое 21Vianet
Логические приложения Стандарт Все регионы Logic Apps
Power Apps - Недоступно
Power Automate Стандарт Все регионы Power Automate , кроме следующих:
     — Облако Китая, управляемое 21Vianet
Метаданные соединителя
Publisher Microsoft

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

  • Максимальный размер файла Excel, поддерживаемого соединителем Excel Online (OneDrive), составляет 5 МБ.
  • Данные могут не быть актуальными (может быть задержка) при фильтрации или сортировке используется в действии List rows present in a table .
  • Действие поддерживает базовую List rows present in a table фильтрацию и сортировку:
    • Поддерживает следующие функции фильтра: eq, ne, contains, startswith, endswith.
    • К столбцу может применяться только 1 функция фильтра.
    • Для сортировки можно использовать только 1 столбец.
  • Действие List rows present in a table возвращает до 256 строк по умолчанию. Чтобы получить все строки, включите разбивку на страницы.
  • Файл Excel может быть заблокирован в OneDrive для обновления или удаления до 12 минут с момента последнего использования соединителя.
  • Одновременные изменения файлов, внесенные другими соединителями или ручными изменениями, не поддерживаются. Пользователи должны избегать записи данных в один файл Excel из нескольких клиентов одновременно (Excel Desktop, Excel Web, Power Automate, LogicApps или PowerApps). Это может привести к возможным конфликтам слияния и несоответствию данных.
  • Соединитель поддерживает файлы в форматах электронной таблицы Microsoft Excel Open XML (*.xlsx) и microsoft Excel Binary Workbook (XLXB).
  • Соединитель извлекает строки для 500 столбцов максимум в действии List rows present in a table . Строки для первых 500 столбцов возвращаются по умолчанию. Вы можете указать разделенный запятыми список определенных столбцов для извлечения в Select Query параметре.
  • Соединитель не поддерживает использование параметров OData для таблиц, содержащих скрытые столбцы.
  • Время ожидания соединителя, вызванное повторными вычислениями, может произойти либо есть сложные формулы, либо на листе слишком много строк. В обоих случаях данные можно вставить несколько раз из-за политики повторных попыток. В качестве обходного решения можно узнать, могут ли быть упрощены или сокращены формулы. В противном случае можно задать режим вычисления для этой книги вручную. Дополнительные сведения см. здесь
  • Для всех действий требуется доступ на запись к файлу, в противном случае API Graph вернет 403 Forbidden ошибку. Кроме того, соединитель вернет ошибку 502 BadGateway , если электронная таблица находится в режиме только для чтения. Чтобы отключить режим только для чтения, см. дополнительные сведения здесь.
  • Filter Query / Order By / Select Query Параметры операции поддерживают только буквенно-цифровые имена столбцов.
  • Таблицы сводной таблицы не поддерживаются из-за ограничений API Graph.
  • Если пользователь выполняет слишком много запросов в течение короткого периода времени, можно получить ответ 429. Ограничение регулирования уникально для каждого запроса и зависит от количества запросов, используемого памяти и других важных факторов.
  • В таких операциях, key column как Delete a rowполеcase-sensitive.
  • В случае нескольких совпадений в таких операциях, как Update a rowоперации, Delete a row только первая строка будет обновлена или удалена.
  • Изменения, зафиксированные такими операциями, как Create a row, Update a rowDelete a row не всегда влияют сразу после успешного ответа от соответствующих действий Power Automate, LogicApps или Power Apps. Ожидается задержка до 30 секунд из-за базовых ограничений серверной службы.
  • Соединитель может заполнять до 64000 строк автоматически, если Insert auto generated id into Excel table параметр выбран во время импорта таблицы в PowerApps.
  • Заголовки столбцов таблиц, содержащие только число, могут привести к неожиданному поведению в операциях, Delete a row таких как Update a rowиз-за ограничений серверной службы. В качестве обходного решения переименуйте такие столбцы, чтобы они также содержали другие символы.
  • Файл Excel может быть изменен, и новая версия может отображаться в журнале версий файла, даже если выполняется действие только для чтения. Это поведение обусловлено внутренними механизмами сохранения серверной службы соединителя.
  • Расшифрованные или помеченные как защищенные листы вызывают ошибку поврежденного файла, даже если файл можно открыть вручную.

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

Обратите внимание, что имена столбцов в результатах ответа действия могут быть преобразованы, чтобы быть совместимым с форматом OData:

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

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

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

  • Key column: столбец в таблице, которая будет использоваться для поиска значения (key value)
  • Key value: значение в объекте key column , которое будет использоваться для идентификации определенной строки.

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

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

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

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

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

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

Действия

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

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

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

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

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

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

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

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

Получение строки с помощью ключевого столбца. Это действие извлекает все значения указанной строки, заданной столбцом и ключевым столбцом.
Получение таблиц

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

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

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

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

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

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

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

Параметры

Имя Ключ Обязательно Тип Описание
Файл
 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.

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

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

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

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

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

Параметры

Имя Ключ Обязательно Тип Описание
Файл
 file True string

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

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

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

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

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

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

Параметры

Имя Ключ Обязательно Тип Описание
Файл
 file True string

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

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

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

Формат DateTime.

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

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

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

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

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

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

Параметры

Имя Ключ Обязательно Тип Описание
Файл
 file True string

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

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

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

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

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

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

Параметры

Имя Ключ Обязательно Тип Описание
Файл
 file True string

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

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

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

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

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

Формат DateTime.

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

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

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

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

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

Параметры

Имя Ключ Обязательно Тип Описание
Файл
 file True string

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

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

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

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

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

Получение строки с помощью ключевого столбца. Это действие извлекает все значения указанной строки, заданной столбцом и ключевым столбцом.

Параметры

Имя Ключ Обязательно Тип Описание
Файл
 file True string

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

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

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

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

Формат DateTime.

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

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

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

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

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

Параметры

Имя Ключ Обязательно Тип Описание
Файл
 file True string

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

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

Имя Путь Тип Описание
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

Стиль таблицы.

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

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

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

Параметры

Имя Ключ Обязательно Тип Описание
Файл
 file True string

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

Имя листа.

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

Тело
WorksheetMetadata

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

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

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

Параметры

Имя Ключ Обязательно Тип Описание
Файл
 file True string

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

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

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

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

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

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

Тело
TableMetadata

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

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

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

Параметры

Имя Ключ Обязательно Тип Описание
Файл
 file True string

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

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

Выберите столбец из раскрывающегося списка.
Значение ключа
 id True 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

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