入力ウィジェットのデータ検証

Prev Next

ウィジェット、ボタン、トリガーを使用してTulipでデータを検証する方法についてご覧ください。

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

データ検証により、アプリ構築がよりシームレスになり、次のような利点があります:

  • トリガー管理の簡素化:トリガーの数と複雑さを軽減し、アプリの開発と保守を効率化します。アプリ開発にかかる時間を短縮できます。
  • 動的なステップの作成:ボタンの有効化/無効化機能を通じてアプリに動的な制御を追加し、より高いインタラクティブ性と柔軟性を実現します。
  • アプリの保守負担を軽減:アプリの確認や理解に費やす時間を削減できます。トリガーへの影響を気にすることなく、ウィジェットをコピー&ペーストできます。

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

入力ウィジェットごとに利用可能な検証ルール

すべての入力ウィジェットでデータ検証を行うことは可能ですが、一部の入力ウィジェットには、データのパラメータを設定するための検証ルールが用意されています。以下の表は、各Input Widgetで利用可能な検証ルールをまとめたものです。

入力ウィジェット 検証ルール
チェックボックス 該当なし
テキスト 「含む」、「含まない」、「で始まる」、「で終わる」、最大文字数制限、最小文字数制限、メールアドレスである、URLである(こちらの規定による)
複数行 「含む」、「で始まる」、「で終わる」、最大文字数、最小文字数、「含まない」
ファイル 該当なし
数値 等しい、等しくない、より大きい、以上、より小さい、以下、範囲内(範囲を含む)、範囲外(範囲を含まない)、小数点以下の桁数
単一選択 該当なし
複数選択 選択された最小値、選択された最大値
Datapicker 「は」、「以前」、「以後」、「範囲内(範囲を含む)」、「範囲外(範囲を含まない)」、「~日以前」、「~日以降」
画像 該当なし
電子署名 該当なし

検証ルールを作成する

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

Validation Rules side pane ex

  1. 検証対象となるデータソースを選択します。静的な値または変数を選択できます。

Validation rules configuration ex

  1. 「+」ボタンをクリックして、ルールを追加します。

検証ルールの順序変更

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

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

例1:「『Tulip』を含む」というルールが最初に失敗したため、それに応じてエラーメッセージが表示されます。

Validation Rule Order Ex1

例2:「Hello で始まる」というルールが最初に失敗したため、それに応じてエラーメッセージが表示されます。

Validation Rule Order Ex2

これにより、アプリ開発者は、オペレーターにどのエラーメッセージを表示するかの優先順位を指定できます。検証ルールの順序を変更するには、6つのドットのアイコンをクリックし、ルールの前または後にドラッグしてください。

Reorder Validation Rules

入力データの必須指定

検証ルールに「必須」のマークを付けると、入力が有効とみなされるためには、オペレーターがその入力を完了しなければならないというルールが追加されます。 これは、すべての入力ウィジェットタイプで使用できます。入力ウィジェットが必須としてマークされると、アプリ内のその入力ウィジェットの横に赤いアスタリスクが表示されます。これを行うには、サイドペインの「検証ルール」セクションの見出しの下にある「必須にする」スライダーを切り替えます。

Validation rules mark required

入力検証エラーの表示

サイドペインの「検証ルール」セクション内にある「エラーの表示形式」ドロップダウンでは、アプリがPlayerで実行されている際に、入力データのエラーがオペレーターにどのように表示されるかを設定できます。

Validation rules error formatting

オペレーターへのエラー表示に関する3つのオプション:1.検証ルールのエラーメッセージを表示 * 入力フィールドを赤で囲み、オペレーターにエラーメッセージを表示します2.入力フィールドのみを囲む * 入力フィールドを赤で囲みます3.エラーを非表示 * 視覚的な表示は行われません

ボタンの動的な有効化と無効化

動的コントロールを使用して、オペレーターがボタンを押せるタイミングを決定します。ボタンが無効になっている場合、色は淡色で表示され、オペレーターはボタンを押すことができません。

Enabled vs disabled buttons

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

Enabled vs disabled eSignature

選択したボタンのサイドペインにある「インタラクション」セクションで**「有効」状態**を設定することにより、ボタンを動的に有効または無効にできます。デフォルトでは、ボタンの有効状態は「はい」に設定されています。

button side pane enabled state yes

ボタンの有効状態を決定する動的制御を追加するには、いくつかの方法があります。1. ブール変数を指定する 2. 検証ルールが設定された入力ウィジェットを含むステップにおけるユーザー入力の有効性 3. すべての入力項目が検証ルールに適合しているかどうかを確認する「すべてのウィジェット」オプション

Button side pane enabled state all widgets

  1. 式を使用する

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

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

ブール値(true または false)として評価される式を記述する必要があります。有効な式を正しく構築すると、式エディタの左下にその旨が表示されます。

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

enable-disable buttons expressions ex1(1)

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

enable-disable buttons expressions ex2(1)

以下の入力値の場合、ボタンは無効になります。入力された値は奇数ですが、入力ウィジェットの検証ルールに合致していないためです。

enable-disable buttons expressions ex2 invalid input

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

enable-disable buttons expressions ex2 valid input

トリガーにおける入力ウィジェットの検証

トリガー内の「If」条件の一部として、入力ウィジェットの検証を使用できます。これにより、アプリ構築者は、オペレーターが入力した特定の値そのものではなく、その値の妥当性に基づいてロジックを迅速に作成できます。

Input validation trigger ex1

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

Input validation trigger ex2


お探しの情報は見つかりましたか?

community.tulip.coにアクセスして、質問を投稿したり、他のユーザーが同様の質問を投稿していないか確認することもできます!