Функція помилок
Застосовується до:
програм Canvas Програм на основі моделі
Надання відомостей про помилки для попередніх змін у джерелі даних.
Зведення
Помилки можуть виникати в разі змінення запису джерела даних. Із-поміж безлічі можливих причин можна відмітити відключення мережі, відсутність дозволів та конфлікти, пов’язані з редагуванням.
Функції, які змінюють дані в джерелах даних, як-от Patch, Collect, Remove, RemoveIf, Update, UpdateIf і SubmitForm, звітують про помилки у два способи:
- Кожна з цих функцій повертає значення помилки в результаті операції. Помилки можна виявити за допомогою isError і замінити або приглушити за допомогою ifError і App.OnError, як завжди. Додаткову інформацію див. в розділі Обробка помилок.
- Після операції функція Errors також повертатиме помилки для попередніх операцій. Це знадобитися для відображення повідомлення про помилку на екрані форми без потреби записування помилки в змінній стану.
Виникненню деяких помилок можна запобігти, якщо скористатися функціями Validate і DataSourceInfo. Пропозиції щодо роботи з помилками та їх уникнення див. в розділі про роботу із джерелами даних.
Опис
Функція Errors повертає таблицю помилок, що містить перелічені нижче стовпці.
- Запис. Запис у джерелі даних, щодо якого виникла помилка. Якщо помилка сталася під час створення запису, цей стовпець буде пустим.
- Стовпець. Стовпець, що спричинив помилку, якщо її можна віднести до одного стовпця. В іншому разі цей стовпець буде пустим.
- Повідомлення. Опис помилки. Цей рядок помилки може відображатися для кінцевого користувача. Зауважте, що повідомлення може створюватися джерелом даних і може бути довгим та містити необроблені імена стовпців, які можуть нічого не означати для користувача.
- Помилка. Код помилки, який можна використовувати у формулах для усунення помилки.
| ErrorKind | Опис |
|---|---|
| ErrorKind.Conflict | До того самого запису було внесено іншу зміну, що призвело до конфлікту змінення. Скористайтеся функцією Refresh, щоб перезавантажити запис і знову спробувати внести зміну. |
| ErrorKind.ConstraintViolation | Порушено одне або кілька обмежень. |
| ErrorKind.CreatePermission | Здійснено спробу створити запис, але поточний користувач не має дозволу на створення записів. |
| ErrorKind.DeletePermission | Здійснено спробу видалити запис, але поточний користувач не має дозволу на видалення записів. |
| ErrorKind.EditPermission | Здійснено спробу редагувати запис, але поточний користувач не має дозволу на редагування записів. |
| ErrorKind.GeneratedValue | Здійснено спробу змінити стовпець, який джерело даних створює автоматично. |
| ErrorKind.MissingRequired | У записі відсутнє значення для обов’язкового стовпця. |
| ErrorKind.None | Помилки відсутні. |
| ErrorKind.NotFound | Здійснено спробу редагувати або видалити запис, однак запис не вдалося знайти. Можливо, запис змінив інший користувач. |
| ErrorKind.ReadOnlyValue | Здійснено спробу змінити стовпець лише для читання. |
| ErrorKind.Sync | Джерело даних повідомило про помилку. Додаткові відомості див. в стовпці «Message». |
| ErrorKind.Unknown | Сталася помилка невідомого типу. |
| ErrorKind.Validation | Виявлено загальну проблему перевірки, що не відповідає іншим типам. |
Помилки можуть повертатися для всього джерела даних або тільки для вибраного рядка через використання аргументу Record функції.
Patch або інша функція даних може повернути порожнє значення, якщо, наприклад, запис не вдалося створити. У цих випадках можна передати пусте значення до функції Errors, і вона поверне відповідні відомості про помилки. Подальше застосування функцій даних до того самого джерела даних призведе до видалення цих відомостей про помилки.
У разі відсутності помилок таблиця, яку повертає функція Errors, буде пустою, і її можна перевірити за допомогою функції IsEmpty.
Синтаксис
Помилки( Джерело даних[, Запис ] )
- Джерело даних– Обов’язковий. Джерело даних, для якого потрібно повернути помилки.
- Запис – необов’язковий. Певний запис, для якого потрібно повернути помилки. Якщо не вказати цей аргумент, функція повертатиме помилки для всього джерела даних.
Приклади
Покрокові інструкції
У цьому прикладі будемо працювати з джерелом даних IceCream (Морозиво).
У програмі користувач завантажує запис «Chocolate» (Шоколадне) у форму введення даних, а потім змінює значення стовпця Quantity (Кількість) на 90. Запис, з яким потрібно працювати, розміщується в змінній контекстуEditRecord.
- UpdateContext( { EditRecord: LookUp( IceCream, Flavor = "Chocolate" ) } )
Для внесення цієї зміни до джерела даних використовується функція Patch.
- Патч ( IceCream, EditRecord, Gallery.Updates )
У ній: Gallery.Updates обчислює значення { Quantity: 90 }, оскільки зміни зазнала лише властивість Quantity.
На жаль, якраз перед викликом функції Patch, хтось змінив значення Quantity для запису «Chocolate» на 80. Power Apps виявить це та попередить виникнення конфліктного змінення. Цю ситуацію можна перевірити за допомогою нижчезазначеної формули.
- IsEmpty( Помилки( IceCream, EditRecord ) )
Вона повертає значення false, тому що функція Errors повернула наведену нижче таблицю.
| Запис | Стовпчик | Повідомлення | Помилка |
|---|---|---|---|
| { Flavor: "Chocolate", Quantity: 100 } | Порожній | «Інший користувач змінив запис, який ви намагається змінити. Перезавантажте запис і повторіть спробу.» | ErrorKind.Conflict |
У формі можна розмістити підпис, щоб показати цю помилку користувачеві.
- Для відображення помилки настройте властивість Text елемента керування «Підпис» відповідно до зазначеної нижче формули.
Label.Text = First(Errors( IceCream, EditRecord )). Повідомлення
Також до форми можна додати кнопку Перезавантажити, щоб користувач міг ефективно вирішити конфлікт.
- Для відображення кнопки тільки в разі виникнення конфлікту настройте властивість Visible елемента керування «Кнопка» відповідно до нижченаведеної формули.
! IsEmpty( lookup( errors( IceCream, EditRecord ), error = ErrorKind.Conflict ) ) - Щоб натискання користувачем кнопки призводило до скасування змін, настройте властивість кнопки OnSelect відповідно до вказаної нижче формули.
ReloadButton.OnSelect = повернутися( IceCream, EditRecord )