Функція перевірки
Застосовується до:
програм Canvas Програм на основі моделі
Функція Validate перевіряє, чи припустиме значення одного стовпця або повного запису для джерела даних.
Опис
Перш ніж користувач надішле зміну даних, ви можете отримати негайний відгук щодо припустимості цього надходження, а це покращить досвід користування.
Джерела даних можуть надавати відомості про те, що являють собою припустимі значення в записі. Ці відомості можуть містити багато обмежень, як наприклад:
- чи стовпець вимагає значення
- яким довгим може бути рядок тексту
- наскільки високим чи низьким може бути число
- наскільки ранньою чи пізньою може бути дата
Функція Validate використовує ці відомості, щоб визначити, чи є значення припустимим, а також для повернення відповідного повідомлення про помилку, якщо значення неприпустиме. Ви можете використати функцію DataSourceInfo, щоб переглянути ті самі відомості, які використовує функція Validate.
Різні джерела даних можуть надавати різну кількість відомостей для перевірки та навіть не надавати їх узагалі. Функція Validate може перевірити значення лише на основі цих відомостей. Навіть якщо функція Validate не знайде проблеми, вам може все одно не вдатися застосувати зміну до даних. Щоб отримати відомості про помилку, можна використати функцію Errors.
Якщо функція Validate знаходить проблему, вона повертає повідомлення про помилку, яке можна показати користувачу програми. Якщо всі значення припустимі, функція Validate повертає blank. Коли ви працюєте з колекцією, яка не має відомостей про перевірку, значення завжди припустимі.
Синтаксис
Validate( DataSource, Column, Value )
- DataSource — обов’язковий аргумент. Джерело даних, за яким потрібно виконати перевірку.
- Column — обов'язковий аргумент. Стовпець, який потрібно перевірити.
- Value — обов'язковий аргумент. Значення для вибраного стовпця, який потрібно перевірити.
Validate( DataSource, OriginalRecord, Updates )
- DataSource — обов’язковий аргумент. Джерело даних, за яким потрібно виконати перевірку.
- OriginalRecord — обов’язковий аргумент. Запис, оновлення якого потрібно перевірити.
- Updates — обов’язковий аргумент. Зміни, які необхідно застосувати до вихідного запису.
Приклади
Для цих прикладів значення в стовпці Percentage джерела даних Scores мають бути в межах від 0 до 100 включно. Якщо дані проходять перевірку, функція поверне пусте значення. В іншому разі функція повертає повідомлення про помилку.
Перевірка одного стовпця
| Формула | Опис | Результат |
|---|---|---|
| Validate( Scores, Percentage, 10 ) | Перевіряє, чи 10 є припустимим значенням для стовпця Percentage у джерелі даних Scores. | пусто |
| Validate( Scores, Percentage, 120 ) | Перевіряє, чи 120 є припустимим значенням для стовпця Percentage у джерелі даних Scores. | "Значення має знаходитися в діапазоні 0–100." |
Перевірка повного запису
| Формула | Опис | Результат |
|---|---|---|
| Validate( Scores, EditRecord, Gallery.Updates ) | Перевіряє, чи значення в усіх стовпцях припустимі для джерела даних Scores. У цьому прикладі значення у стовпці Percentage становить 10. | пусто |
| Validate( Scores, EditRecord, Gallery.Updates ) | Перевіряє, чи значення в усіх стовпцях припустимі для джерела даних Scores. У цьому прикладі значення у стовпці Percentage становить 120. | "Значення має знаходитися в діапазоні 0–100." |