Получение данных: выборка структурированных записей

Средний уровень Power Automate

Dani Kahil

Solution Architect | Microsoft MVP

В каждом коннекторе есть действие для получения списка

 

Действие Power Automate Get items (SharePoint) развёрнуто в конструкторе v3: отображаются Site Address, List Name и все дополнительные параметры — Filter Query, Order By, Top Count, Limit Columns by View, Limit Entries to Folder и Include Nested Items

 

  • Dataverse: List rows
  • SharePoint: Get items
  • Excel: List rows present in a table
  • Salesforce: Get records
  • Все возвращают массив записей
Средний уровень Power Automate

Устройство действия Get items

 

screenshot_get_items_anatomy: действие Power Automate Get items (SharePoint) развёрнуто — отображаются Site Address, List Name и дополнительные параметры Filter Query, Order By, Top Count и Limit Columns by View на карточке действия.

 

  • Filter Query — выражение OData
  • Order By — столбец и asc / desc
  • Top Count — ограничивает количество записей
  • Limit Columns by View — ограничивает количество столбцов
Средний уровень Power Automate

Фильтрация на стороне источника

 

Filter Query — это выражение OData: поле, оператор, значение.

Status eq 'Active'
EndDate le '@{addDays(utcNow(), 60)}'
Status eq 'Active' and EndDate le
  '@{addDays(utcNow(), 60)}'

Для полей выбора нужна отображаемая метка в кавычках; для дат — строка ISO в одинарных кавычках, обёрнутая в @{...}.

Средний уровень Power Automate

Фильтрация на источнике и в потоке

nanobanana: иллюстрация-сравнение с вертикальным разделителем. Слева, с подписью "Filter at the source": обобщённая иконка хранилища данных (стилизованный цилиндр с надписью "List / Table") с воронкой; стрелка с подписью "5 records" ведёт в блок потока Power Automate. Сверху парит маленькая зелёная галочка. Справа, с подписью "Filter in the flow": та же иконка хранилища данных; стрелка с подписью "5,000 records" ведёт к блоку потока Power Automate, где действие Filter Array отправляет 4995 записей в маленькую иконку корзины, а 5 проходят дальше. Над правой частью парит маленький красный значок восклицания. Плоская векторная графика, зелёно-синяя палитра, белый фон.

 

  • Filter Query выполняется на стороне источника
  • Filter Array выполняется внутри потока
  • Результат тот же, а затраты — разные

$$

Совет: если фильтр можно выразить на языке запросов источника, выполняйте его там же

Средний уровень Power Automate

Сокращение объёма данных

nanobanana: концептуальная плоская векторная иллюстрация с двумя карточками записей рядом на белом фоне. Левая карточка, с подписью "Without Limit Columns by View": запись с примерно двенадцатью видимыми полями, большинство из которых затенены — системные поля, поля аудита, неиспользуемые столбцы — выделены зелёным только два. Правая карточка, с подписью "With Limit Columns by View + Top 50": более компактная запись, где показаны только выделенные зелёным строки, с небольшим значком "Top 50" в углу. Между карточками — небольшая стрелка с подписью "trim". Зелёно-синяя палитра, подписи без засечек.

 

  • Представление не выбрано → возвращаются все столбцы
  • Limit Columns by View → только то, что использует поток
  • Top Count ограничивает количество записей
Средний уровень Power Automate

Давайте потренируемся!

Средний уровень Power Automate

Preparing Video For Download...