Validate функція

Застосовується до: Програми canvas Model-driven

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

Опис

Перш ніж користувач надішле зміну даних, ви можете отримати негайний відгук щодо припустимості цього надходження, а це покращить досвід користування.

Джерела даних можуть надавати відомості про те, що являють собою припустимі значення в записі. Ці відомості можуть містити багато обмежень, як наприклад:

• чи стовпець вимагає значення
• яким довгим може бути рядок тексту
• наскільки високим чи низьким може бути число
• наскільки ранньою чи пізньою може бути дата

Ця Validate функція використовує ці відомості, щоб визначити, чи є значення припустимим, і повернути відповідне повідомлення про помилку, якщо ні. За допомогою функції DataSourceInfo можна переглядати ті самі відомості, які Validate використовуються.

Різні джерела даних можуть надавати різну кількість відомостей для перевірки та навіть не надавати їх узагалі. Validate може перевіряти лише значення на основі цих відомостей. Навіть якщо Validate не вдається знайти проблему, застосування зміни даних все одно може бути невдалим. Щоб отримати відомості про помилку, можна використати функцію Errors.

Якщо Validate виявиться проблема, функція повертає повідомлення про помилку, яке можна відобразити користувачу програми. Якщо всі значення припустимі, Validate повертає значення пусте. Коли ви працюєте з колекцією, яка не має відомостей про перевірку, значення завжди припустимі.

Синтаксис

Validate( DataSource, Column, Value )

• Джерело даних– Обов’язковий. Джерело даних, за яким потрібно виконати перевірку.
• Стовпчик– обов’язковий. Стовпець, який потрібно перевірити.
• Value – обов’язковий. Значення для вибраного стовпця, який потрібно перевірити.

Validate( DataSource, OriginalRecord, Updates )

• Джерело даних– Обов’язковий. Джерело даних, за яким потрібно виконати перевірку.
• OriginalRecord - Обов’язковий. Запис, оновлення якого потрібно перевірити.
• Оновлення- Обов’язкові. Зміни, які необхідно застосувати до вихідного запису.

Приклади

Для цих прикладів значення в стовпці Percentage джерела даних Scores мають бути в межах від 0 до 100 включно. Якщо дані проходять перевірку, функція поверне пусте значення. В іншому разі функція повертає повідомлення про помилку.

Validate з одним стовпцем

Формула	Опис	Результат
Validate( Бали, відсоток, 10 )	Перевіряє, чи 10 є припустимим значенням для стовпця Percentage у джерелі даних Scores.	Порожній
Validate( Бали, відсоток, 120 )	Перевіряє, чи 120 є припустимим значенням для стовпця Percentage у джерелі даних Scores.	"Значення має знаходитися в діапазоні 0–100."

Validate з повним записом

Формула	Опис	Результат
Validate( Оцінки, Редагуватизапис, Колекція.Оновлення )	Перевіряє, чи значення в усіх стовпцях припустимі для джерела даних Scores. У цьому прикладі значення у стовпці Percentage становить 10.	Порожній
Validate( Оцінки, Редагуватизапис, Колекція.Оновлення )	Перевіряє, чи значення в усіх стовпцях припустимі для джерела даних Scores. У цьому прикладі значення у стовпці Percentage становить 120.	"Значення має знаходитися в діапазоні 0–100."