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