入力ウィジェットによるデータ検証

ウィジェット、ボタン、トリガーを使ってTulipでデータを検証する方法について説明します。

オペレーターの入力にデータバリデーションを使用することで、品質の問題を減らし、プロセスで使用されるフォームを標準化します。ユーザーがバリデーション要件に一致しないデータ値を入力すると、エラーメッセージが表示されます。さらに、トリガーロジックを使用して、入力されたデータが要件を満たしていない場合、オペレーターがアプリを続行できないようにすることもできます。

データ・バリデーションは、以下の利点により、アプリ構築をよりシームレスにします：

• トリガー管理の簡素化トリガーの量と複雑さを減らし、アプリ開発とメンテナンスを合理化します。アプリ開発に費やす時間を短縮できます。
• ダイナミックなステップの作成ボタンの有効/無効機能を通じてアプリにダイナミックなコントロールを追加し、より高いインタラクティブ性と柔軟性を実現します。
• アプリのメンテナンスの軽減アプリのレビューや理解に費やす時間を短縮できます。トリガーの影響を気にすることなく、ウィジェットをコピー＆ペーストできます。

また、動的に有効・無効化されるボタンにより、直感的なアプリ体験を提供できます。

入力ウィジェットごとに利用可能なバリデーションルール

データ検証のためにすべての入力ウィジェットを使用できますが、一部の入力にはデータのパラメータを設定するための検証ルールがあります。以下の表はInput Widgetごとに利用可能な検証ルールの概要です。

| 入力ウィジェット｜バリデーションルール｜---｜チェックボックス｜N/A｜テキスト｜含む, で始まる, で終わる, 最大文字数制限, 最小文字数制限, 電子メールである, URLである｜マルチライン｜含む, で始まる, で終わる, 最大文字数制限, 最小文字数制限｜ファイル｜N/A｜数値｜等しい, 等しくない、より大きい, より大きいか等しい, より小さい, 以下, 範囲の内側（含む）, 範囲の外側（排他的）｜｜単一選択｜N/A｜｜複数選択｜｜最小選択｜最大選択｜｜｜データピッカー｜｜である, 前である, 後である, 範囲の内側（含む）, 範囲の外側（排他的）｜｜画像｜N/A｜｜電子署名｜N/A｜｜である。

バリデーション・ルールの作成

1. 利用可能な検証ルールがある入力ウィジェットを選択します（上の表を参照）。
2. コンテキストペインで、検証ルールの横にある**+**アイコンをクリックします。
3. 入力ウィジェットに追加するルールを選択します。

1. 検証ルールのデータソースを選択します。これは静的値または変数です。

1. 追加ルールを追加するには、[**+]**ボタンをクリックします。

検証ルールの順序変更

検証ルールの順序は、入力されたデータ値が失敗した場合に表示される最初のエラーメッセージに対応します。

以下の例では、入力されたデータは両方の検証ルールに失敗しています。しかし、表示されるエラーメッセージは、最初に設定されたルールに関連しています。

例1"Contains Tulip" は最初に失敗するルールなので、エラーメッセージもそれに従って表示されます。

例2"Helloで始まる "は最初に失敗するルールなので、エラーメッセージもそれに従って表示されます。

これにより、アプリビルダーはオペレータに表示するエラーメッセージの優先順位を指定できます。 検証ルールの順序を変更するには、6つの点のアイコンをクリックし、ルールの前後にドラッグします。

入力データを必須にする

バリデーションルールを必須とマークすると、入力が有効とみなされるには、オペレータによって入力が完了されなければならないというルールが追加されます。これはすべての入力ウィジェットタイプに使用できます。入力ウィジェットが必須とマークされると、アプリの入力ウィジェットの横に赤いアスタリスクが表示されます。 これを行うには、コンテキストペインの検証ルールセクションヘッダーの下にある必須マークスライダーを切り替えます。

入力バリデーションエラープロンプト

コンテキスト ペインのValidation rulesセクション内のError formattingドロップダウンには、アプリが Player で実行されているときに、入力データのエラーがオペレータにどのように表示されるかのオプションがあります。

オペレータにエラーを表示するための3つのオプションがあります：
1.検証ルールのエラーメッセージを表示する* 入力フィールドを赤でアウトライン化し、オペレータにエラーメッセージを表示する 2.入力フィールドのみアウトライン表示* 入力フィールドを赤でアウトライン表示 3.エラーを隠す* 視覚的な表示はありません

ボタンを動的に有効/無効にする

ダイナミックコントロールで、オペレータがいつボタンを押すことができるかを決定します。ボタンが無効になると、そのボタンはミュートされた色で表示され、オペレータはそのボタンを押すことができなくなります。

このコントロールは、電子署名ウィジェットでも使用できます。

選択したボタンのコンテキスト ペインの [**相互作用]**セクションで [有効] 状態を設定することで、ボタンを動的に有効または無効にできます。デフォルトでは、ボタンの有効状態は「はい」に設定されています。

ボタンの有効状態を決定する動的制御を追加する方法はいくつかあります： 1.ブール変数を指定する 2.バリデーション・ルールを持つ入力ウィジェットを使用したステップでのユーザ入力の有効性 3.入力されたすべての入力がバリデーション・ルールを満たすかどうかをチェックするAll widgetsオプション。

1. 式の使用

式を使ってボタンを有効/無効にする

ウィジェットのサブセットに基づいてボタンを有効または無効にする場合は、[式を使用] を選択してカスタム条件を記述します。

ブーリアン条件 (真または偽) に評価される式を記述する必要があります。有効な式を正しく作成すると、式エディタの左下にその旨が表示されます。

例1以下の例では、モジュロ演算を使用して、数値入力ウィジェットに入力された値が奇数か偶数かを判定します。値が奇数の場合、ボタンは有効になります。値が偶数の場合、ボタンは無効になります。

例2式を使用すると、追加の条件を組み合わせることもできます。 以下の例では、ボタンを有効にするには、値が奇数で、数値入力ウィジェットに設定された検証条件を満たす必要があります。

以下の入力値では、ボタンは無効になります。入力された値が奇数であっても、入力ウィジェットの検証ルールを満たしていません。

下の入力値は、入力された値が奇数であり、入力ウィジェットの検証ルールを満たしているため、ボタンが有効になります。

トリガーでの入力ウィジェット検証

入力ウィジェット検証は、トリガーのIf条件の一部として使用できます。これにより、アプリビルダーは、オペレータによって入力された特定の値ではなく、それらの値の妥当性に依存するロジックをすばやく作成できます。

ウィジェットの有効性情報は、トリガーを使って変数やテーブルレコードに保存することもできます。

お探しのものは見つかりましたか？

community.tulip.coで質問を投稿したり、他の人が同じような質問に直面していないか確認することもできます！