Функции Update и UpdateIf

Применимо к: Приложениям Canvas Приложениям, управляемым моделями

Обновление записей в источнике данных.

Description

Функция Update

Используйте функцию Update для замены всей записи в источнике данных. Функции UpdateIf и Patch, наоборот, изменяют одно или несколько значений в записи, оставляя другие значения без изменений.

При использовании коллекции вся запись должна совпадать. В коллекциях допускаются повторяющиеся записи, так что возможны совпадения нескольких записей. Для обновления всех экземпляров записи можно использовать аргумент RemoveFlags.All, иначе обновляется только один экземпляр записи.

Если в источнике данных значение столбца создается автоматически, такое значение требует повторного подтверждения.

Функция UpdateIf

Используйте функцию UpdateIf для изменения одного или нескольких значений в одной или нескольких записях, которые соответствуют одному или нескольким условиям. Условием может быть любая формула, которая возвращает результат true или false и может содержать ссылки на столбцы в источнике данных (по имени). Функция оценивает условие для каждой записи и изменяет все записи, для которых возвращен результат true.

Чтобы указать изменение, используйте запись изменения, содержащую новые значения свойств. Если указать эту запись изменения в фигурных скобках, формулы свойств смогут ссылаться на свойства изменяемой записи. Такое поведение можно использовать для изменения записей на основе формул.

Так же как и функцию UpdateIf, функцию Patch можно использовать для изменения определенных столбцов записи без изменения других столбцов.

Функции Update и UpdateIf возвращают измененный источник данных в виде таблицы. Необходимо использовать любую из этих функций в формуле поведения.

Делегирование

При использовании с источником данных эти функции невозможно делегировать. Будет извлечена только первая часть источника данных, затем будет применена функция. Это может не отражать ситуацию в целом. Во время разработки может появиться предупреждение, чтобы напомнить вам об этом ограничении.

Поддержка делегирования (экспериментальная версия)

Поддержка делегирования для UpdateIf и RemoveIf теперь находится на стадии экспериментальной предварительной версии (по умолчанию отключено) для источников данных, которые ее поддерживают. Если источник данных не поддерживает эту функцию, Power Apps теперь отправит запрос на сервер и получит все данные, соответствующие выражению фильтра, вплоть до максимального размера 500, 2000 или размера страницы данных. Затем он обновит эти записи и отправит каждую обратно на сервер для обновления.

Синтаксис

Обновление( DataSource, OldRecord, NewRecord [, RemoveFlags.All ] )

• Источник данных – обязателен. Это источник данных, содержащий записи, которые требуется заменить.
• OldRecord – Обязательно. Это запись для замены.
• NewRecord – Обязательно. Запись, которой нужно заменить исходную запись. Она не является записью изменения. Выполняется замена всей записи, а для отсутствующих свойств будет указано значение blank.
• RemoveFlags.All – Необязательно. В коллекции может существовать несколько копий одной записи. Укажите аргумент RemoveFlags.All, чтобы обновить все копии записи.

UpdateIf( ИсточникДанных, Условие1, ИзменитьЗапись1 [, Условие2, ИзменитьЗапись2, ... ] )

• Источник данных – обязателен. Это источник данных, содержащий запись или записи, которые требуется изменить.
• Условия – Обязательны. Формула, возвращающая значение true для одной или нескольких записей, которые необходимо изменить. В формуле можно использовать названия столбцов из аргумента DataSource.
• ChangeRecords - Обязательно. Для каждого соответствующего условия запись изменений нового значения свойства должна применяться к записям аргумента DataSource, которые удовлетворяют этому условию. Если запись указывается в фигурных скобках, значения свойств существующей записи можно использовать в формулах свойств.

Примеры

В этих примерах выполняется замена или изменение записей в источнике данных под названием IceCream, в начале которого указаны данные из этой таблицы:

Формула	Описание	Результат
Обновление( Мороженое, First( Filter( IceCream, Flavor="Chocolate" ) ), { ID: 1, Flavor: "Mint Chocolate", Quantity:150 } )	Выполняется замена записи из источника данных.	Источник данных IceCream изменен.
UpdateIf( Мороженое, Количество > 175, { Количество: Количество + 10 } )	Выполняется изменение записей, в которых значение Quantity больше 175. Значение в поле Quantity увеличивается на 10, а остальные поля остаются без изменений.	Источник данных IceCream изменен.
Обновление( Мороженое, First( Filter( IceCream, Flavor="Strawberry" ) ), { ID: 3, Flavor: "Strawberry Swirl"} )	Выполняется замена записи из источника данных. Свойство Quantity не указано в записи замены, так что для него будет возвращено значение blank.	Источник данных IceCream изменен.
UpdateIf( IceCream, true, { Количество: 0 } )	Эта формула устанавливает значение 0 для свойства Quantity во всех записях в источнике данных.	Источник данных IceCream изменен.

Пошаговое руководство

1. Импортируйте или создайте коллекцию с именем Inventory и отобразите ее в коллекции, как описано в этой статье.

2. Присвойте коллекции имя ProductGallery.

3. Добавьте ползунок с именем UnitsSold и для его свойства Max задайте значение в виде следующего выражения:
   ProductGallery.Selected.UnitsInStock

4. Добавьте кнопку и задайте следующую формулу в качестве значения свойства OnSelect:
   UpdateIf(Inventory, ProductName = ProductGallery.Selected.ProductName, {UnitsInStock:UnitsInStock-UnitsSold.Value})

5. Нажмите клавишу F5, выберите продукт в коллекции, укажите значение с помощью ползунка и затем нажмите кнопку.

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