Функції Sort і SortByColumns

Стаття
10/16/2024

Застосовується до: програм Canvas Потоків робочого столу Програм Power Pages Power Platform CLI на основі моделі

Нотатка

Команди PAC CLI pac power-fx не підтримують функцію SortByColumns .

Опис

Функція Sort сортує таблицю на основі формули.

Формула виконується для кожного запису таблиці, а результати використовуються для сортування таблиці. Результатом формули має стати число, рядок або логічне значення. Її результатом не може бути таблиця або запис.

Поля оброблюваного запису доступні у формулі. Використовуйте оператор ThisRecord або просто вкажіть посилання на поля за іменем, як у випадку з будь-яким іншим значенням. Оператор As також можна використовувати для призначення імені оброблюваного запису, що спростить сприймання формули та зробить вкладені записи доступними. Додаткову інформацію див. у прикладах нижче та в статті Робота з областю застосування записів.

Щоб відсортувати спочатку за одним стовпцем, а потім за іншим, потрібно вбудувати одну формулу Sort в іншу. Наприклад, можна використати цю формулу для сортування таблиці Контактні особи спочатку за стовпцем Прізвище, а потім за стовпцем Ім’я: Sort( Sort( Contacts, LastName ), FirstName )

Функцію SortByColumns також можна використовувати для сортування таблиці на основі одного або кількох стовпців.

Список параметрів для функції SortByColumns містить імена стовпців, за яким потрібно сортувати, а також напрямок сортування для кожного стовпця. Сортування виконується в порядку параметрів (спочатку сортується за першим стовпцем, потім за другим тощо). Імена стовпців вказуються як рядки, що потребують подвійних лапок, якщо вони безпосередньо включені до списку параметрів. Наприклад, SortByColumns( CustomerTable, "Прізвище" ).

Можна об’єднати функцію SortByColumns з елементом керування Drop down або List box, щоб дозволити користувачам вибирати стовпець, за яким потрібно сортувати.

Крім сортування за зростанням або за спаданням функція SortByColumns може сортувати на основі таблиці з одним стовпцем значень. Наприклад, можна відсортувати запис на основі назви дня тижня, ввівши ["Понеділок", "Вівторок", "Середа", "Четвер", "П'ятниця", "Субота", "Неділя"] як порядок сортування. Усі записи, що мають Понеділок, будуть відображатися першими, а потім Вівторок тощо. Знайдені записи, які не відображаються в таблиці сортування, буде розташовано в кінці списку.

Таблиці є значенням Power Apps, так само як рядок або число. Їх можна передавати в функції та повертати від функцій. Функції «Сортування » та «SortByColumn » не змінюють таблицю, натомість вони беруть таблицю як аргумент і повертають нову відсортовану таблицю. Додаткові відомості див. в розділі Робота з таблицями.

Делегування

За можливості Power Apps делегуватимуть операції фільтрування й сортування джерелу даних і розбиватимуть результати на сторінки за запитом. Наприклад, якщо ви запустите програму, яка показує Галерею даних, на пристрій спочатку буде завантажено лише перший набір записів. Додаткова інформація завантажуватиметься з джерела даних, коли користувач прокручуватиме галерею. Це прискорює запуск програм і доступ до дуже великих наборів даних.

Утім, делегування не завжди можливе. Джерела даних відрізняються за наборами функцій і операторів, які вони підтримують під час делегування. Якщо повністю делегувати формулу неможливо, неделеговану частину буде виділено в редакторі з попередженням. Якщо можливо, спробуйте змінити формулу, відмовившись від функцій і операторів, які не можна делегувати. У списку делегування перелічено всі джерела даних і операції, які можна делегувати.

Якщо делегування неможливе, Power Apps завантажить лише невеликий набір записів для локальної обробки. Функції фільтрування й сортування працюватимуть з обмеженим набором записів. Тобто в Галереї може відображатися не вся історія, що може спантеличити користувачів.

Додаткову інформацію див. у статті Огляд делегування.

Синтаксис

Сортувати( Таблиця, Формула [, Порядок сортування])

Таблиця - обов’язковий. Таблицю, яку потрібно відсортувати.
Формула - Обов’язкова. Ця формула виконується для кожного запису таблиці, а результати використовуються для сортування таблиці. В таблиці можна посилатися на стовпці.
SortOrder - необов’язковий. Укажіть Порядок сортування.За спаданням, щоб відсортувати таблицю за спаданням. SortOrder.Ascending є значенням за замовчуванням.

SortByColumns(Table,ColumnName1 [, SortOrder1,ColumnName2,SortOrder2 , ... ] )

Таблиця - обов’язковий. Таблицю, яку потрібно відсортувати.
ColumnNames- Обов’язковий . Імена стовпців можна сортувати як рядки.
SortOrders- Необов’язковий . SortOrder.Ascending або SortOrder.Descending. SortOrder.Ascending є стандартним. Якщо додаються кілька Імен стовпців, усі окрім останнього стовпця мають містити значення Порядок сортування.

Нотатка

Для джерел даних SharePoint і Excel, які містять імена стовпців із пробілами, укажіть кожен пробіл як "_x0020_". Наприклад, укажіть "Ім’я стовпця" як "Ім’я_x0020_стовпця".

SortByColumns( Таблиця, Назва стовпця, Таблиця сортування )

Таблиця - обов’язковий. Таблицю, яку потрібно відсортувати.
ColumnName - обов’язковий. Ім’я стовпця, який потрібно сортувати як рядки.
SortOrderTable - обов’язковий. Таблиця з одним стовпцем значень, яку потрібно відсортувати.

Нотатка

Для джерел даних SharePoint і Excel, які містять імена стовпців із пробілами, укажіть кожен пробіл як "_x0020_". Наприклад, укажіть "Ім’я стовпця" як "Ім’я_x0020_стовпця".

Приклади

Для наступних прикладів ми будемо використовувати джерело даних IceCream («Морозиво»), в якому містяться дані в цій таблиці:

Приклад Iceсream.

Формула	Опис	Результат
Сорт ( Морозиво, Смак ) SortByColumns( Морозиво, "Смак" )	Сортує Морозиво за її стовпцем Смак. У стовпці Смак містяться рядки, тому таблицю можна відсортувати в алфавітному порядку. Значення за замовчуванням: за зростанням.
Сорт ( Морозиво, кількість ) SortByColumns( Морозиво, "Кількість" )	Сортує Морозиво за її стовпцем Кількість. У стовпці Кількість містяться числа, тому таблицю можна відсортувати за числовими значеннями. Значення за замовчуванням: за зростанням.
Сортувати( Морозиво, Кількість, Сортувати Порядок.За спаданням ) SortByColumns( IceCream, "Кількість", SortOrder.Спадання )	Сортує Морозиво за її стовпцем Кількість. У стовпці Кількість містяться числа, тому сортування виконується за числовими значеннями. Порядок сортування вибрано за спаданням.
Сортування (морозиво, кількість + під замовлення)	Сортує Морозиво за сумою його стовпців Кількість та Замовлення для кожного запису окремо. Сума — це число, тому таблиця сортується за числовими значеннями. Значення за замовчуванням: за зростанням. Оскільки ми сортуємо за формулою, а не за необробленими значеннями стовпців, не існує еквівалента використанню SortByColumns.
Сортувати ( Сортувати ( Морозиво, На замовлення ), Кількість ) SortByColumns( IceCream, "OnOrder", SortOrder.Ascending, "Quantity", SortOrder.Ascending )	Сортує Морозивоспочатку за його стовпцем Замовлення, а потім за стовпцем Кількість. Зверніть увагу, що "Фісташки" відображається вище "Ваніль" у першому сортуванні на основі стовпця Замовлення, а потім разом вони переносяться у відповідне місце на основі стовпця Кількість.
SortByColumns( Морозиво, "Смак", [ "Фісташка", "Полуниця" ] )	Сортує Морозиво за його стовпцем Смак на основі таблиці з одним стовпцем, що містить "Фісташки" і "Полуниця". Записи, які мають Смак "Фісташки", відображатимуться першими в результаті, а потім записи, що містять "Полуниця". Значення у стовпці Смак, які не відповідають умовам, наприклад "Ваніль", відобразяться після елементів, які відповідають умовам пошуку.

Покрокові інструкції

Щоб виконати ці приклади самостійно, створіть джерело даних Морозиво в колекції:

Додайте кнопку та налаштуйте її властивість OnSelect відповідно до нижченаведеної формули.
ClearCollect( Морозиво, { Смак: "Шоколад", Кількість: 100, Під замовлення: 150 }, { Аромат: "Ваніль", Кількість: 200, Під замовлення: 20 }, { Аромат: "Полуниця", Кількість: 300, Під замовлення: 0 }, { Смак: "М’ятний шоколад", Кількість: 60, Під замовлення: 100 }, { Смак: "Фісташка", Кількість: 200, Під замовлення: 10 } )
Перегляньте програму, натисніть кнопку, а потім натисніть клавішу Esc, щоб повернутися до робочої області за замовчуванням.
Виберіть Колекції в меню Файл, щоб відобразити щойно створену колекцію, а потім натисніть клавішу Esc, щоб повернутися до робочої області за замовчуванням.

Сортувати

Додайте іншу кнопку та налаштуйте для її властивості Замовлення нижченаведену формулу.
ClearCollect( SortByFlavor, Sort( Морозиво, Смак ) )

У попередній формулі створюється друга колекція з назвою Сортувати за смаком, яка містить ті ж дані, що й Морозиво. Проте нова колекція містить дані, відсортовані в алфавітному порядку за стовпцем Смак у порядку зростання.
Натисніть клавішу F5, натисніть нову кнопку, а потім натисніть клавішу Esc.
Виберіть Колекції в меню Файл, щоб відобразити обидві колекції, а потім натисніть клавішу ESC, щоб повернутися до робочої області за замовчуванням.
Повторіть останні три кроки, але змініть ім’я колекції, яку необхідно створити, і замініть формулу Сортування іншою формулою з таблиці прикладів на початку цього розділу, в якій використовується Сортування.

SortByColumns

Додайте іншу кнопку та налаштуйте для її властивості Замовлення нижченаведену формулу.
ClearCollect( SortByQuantity, SortByColumns( IceCream, "Кількість", SortOrder.Ascending, "Flavor", SortOrder.Descending ) )

У попередній формулі створюється третя колекція з назвою Сортувати за кількістю, яка містить ті ж дані, що й Морозиво. Проте нова колекція містить дані, відсортовані за числами за стовпцем Кількість у порядку зростання, а потім за стовпцем Смак у порядку спадання.
Натисніть клавішу F5, натисніть нову кнопку, а потім натисніть клавішу Esc.
Виберіть Колекції в меню Файл, щоб відобразити всі три колекції, а потім натисніть клавішу ESC, щоб повернутися до робочої області за замовчуванням.
Повторіть останні три кроки, але змініть ім’я колекції, яку необхідно створити, і замініть формулу Сортувати за стовпцями іншою формулою з таблиці прикладів на початку цього розділу, в якій використовується Сортувати за стовпцями.

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