Funkce Validate
Platí pro:
aplikace plátna modelem řízené aplikace
Funkce Validate kontroluje, jestli je hodnota jednoho sloupce nebo celého záznamu platná pro zdroj dat.
Popis
Předtím, než uživatel odešle změnu dat, můžete poskytnout okamžitou zpětnou vazbu ohledně její platnosti, aby se uživatelům příjemněji pracovalo.
Zdroje dat dokážou poskytovat informace o tom, jaké jsou platné hodnoty v rámci záznamu. Mezi tyto informace patří spousta omezení, například:
- Jestli sloupec vyžaduje hodnotu
- Jak dlouhý může být textový řetězec
- Jak vysoké a nízké může být číslo
- Jak brzké nebo pozdní může být datum
Funkce Validate pomocí těchto informací určuje, jestli je nějaká hodnota platná, a pokud není, vrátí příslušnou chybovou zprávu. Pomocí funkce DataSourceInfo můžete zobrazit informace, které funkce Validate používá.
Zdroje dat se liší v tom, kolik ověřovacích informací poskytují, včetně možnosti, kdy neposkytují vůbec žádné. Funkce Validate dokáže ověřovat hodnoty jen na základě těchto informací. I když funkce Validate nenajde žádný problém, nemusí být změna dat úspěšná. Ke získání informací o chybě můžete použít funkci Errors.
Když funkce Validate najde nějaký problém, vrátí chybovou zprávu, kterou můžete zobrazit uživateli aplikace. Pokud jsou všechny hodnoty platné, vrátí funkce Validate hodnotu blank. Při práci s kolekcí, která nemá žádné ověřovací informace, jsou hodnoty vždycky platné.
Syntaxe
Validate( ZdrojDat; Sloupec; Hodnota )
- ZdrojDat – povinné. Zdroj dat, vůči kterému se má provést ověření.
- Sloupec – povinné. Sloupec, který se má ověřit.
- Hodnota – povinné. Hodnota vybraného sloupce, která se má ověřit.
Validate( ZdrojDat; PůvodníZáznam; Aktualizace )
- ZdrojDat – povinné. Zdroj dat, vůči kterému se má provést ověření.
- PůvodníZáznam – povinné. Záznam, jehož aktualizace se mají ověřit.
- Aktualizace – povinné. Změny, které se mají uplatnit na původní záznam.
Příklady
V těchto příkladech musí být hodnoty ve sloupci Percentage zdroje dat Scores mezi 0 a 100 (včetně). Pokud data projdou ověřením, vrátí funkce prázdnou hodnotu. V opačném případě vrátí funkce chybovou zprávu.
Ověření jednoho sloupce
| Vzorec | Popis | Výsledek |
|---|---|---|
| Validate( Scores; Percentage; 10 ) | Zkontroluje, jestli je 10 platná hodnota sloupce Percentage ve zdroji dat Scores. | prázdný |
| Validate( Scores; Percentage; 120 ) | Zkontroluje, jestli je 120 platná hodnota sloupce Percentage ve zdroji dat Scores. | Hodnoty musí být mezi 0 a 100. |
Ověření úplného záznamu
| Vzorec | Popis | Výsledek |
|---|---|---|
| Validate( Scores; EditRecord; Gallery.Updates ) | Zkontroluje, jestli jsou pro zdroj dat Scores platné hodnoty ve všech sloupcích. V tomto příkladu je ve sloupci Percentage hodnota 10. | prázdný |
| Validate( Scores; EditRecord; Gallery.Updates ) | Zkontroluje, jestli jsou pro zdroj dat Scores platné hodnoty ve všech sloupcích. V tomto příkladu je ve sloupci Percentage hodnota 120. | Hodnoty musí být mezi 0 a 100. |