Validate 関数

適用対象: キャンバス アプリ モデル駆動型アプリ

Validate関数は、1 つの列または完全なレコードの値がデータ ソースに対して有効かどうかをチェックします。

内容

ユーザーがデータの変更を送信する前に、送信内容の有効性についてその場でフィードバックを返し、ユーザー エクスペリエンスを向上させることができます。

データ ソースでは、レコード内で値が有効になるための要素に関する情報を指定できます。 この情報として指定できる制約には、次に挙げたものをはじめ、さまざまなものがあります。

• 列に値が必要かどうか
• テキストの文字列の長さ
• 数値の範囲
• 日付の範囲

Validate関数は、この情報を使用して値が有効かどうかを判断し、有効でない場合は適切なエラー メッセージを返します。 DataSourceInfo 関数を使用すると、Validateが使用するのと同じ情報を表示できます。

有効性に関して提供される情報の量は、データ ソースによって異なります。まったく情報を提供しないデータ ソースもあります。 Validate は、この情報に基づいて値を検証することしかできません。 Validate問題が見つからない場合でも、データ変更の適用は失敗する可能性があります。 変更の失敗に関する情報を取得するには、Errors 関数を使用します。

Validate問題が見つかると、アプリのユーザーに表示できるエラー メッセージが返されます。 すべての値が有効な場合、 Validate は空白を返 します。 検証に関する情報のないコレクション の場合には、値が常に有効になります。

構文

Validate( DataSource, Column, Value )

• DataSource – 必須。 検証に使用するデータ ソース。
• 列 – 必須。 検証する列。
• 値 – 必須。 検証対象として選択した列の値。

Validate( DataSource、 OriginalRecord、 Updates )

• DataSource – 必須。 検証に使用するデータ ソース。
• OriginalRecord - 必須。 更新内容が検証されるレコード。
• 更新 - 必須。 元のレコードに適用される変更。

例

ここに挙げた例では、Scores データ ソースの Percentage 列の値が 0 以上 100 以下に収まっている必要があります。 データが検証に合格すると、関数は空白を返します。 これに対して、検証に合格しなかった場合には、エラー メッセージが返されます。

Validate 1 つの列を含む

計算式	内容	結果
Validate( Scores, Percentage, 10 )	10 が Scores データ ソースの Percentage 列の値として有効であるかどうかを確認します。	空白
Validate( Scores, Percentage, 120 )	120 が Scores データ ソースの Percentage 列の値として有効であるかどうかを確認します。	"値は 0 から 100 の間である必要があります。"

Validate 完全なレコードを含む

計算式	内容	結果
Validate( Scores, EditRecord, Gallery.Updates )	Score データ ソースのすべての列の値が有効かどうかを確認します。 この例では、Percentage 列の値は 10 です。	空白
Validate( Scores, EditRecord, Gallery.Updates )	Score データ ソースのすべての列の値が有効かどうかを確認します。 この例では、Percentage 列の値は 120 です。	"値は 0 から 100 の間である必要があります。"