自動問合せのルールの作成

サイトで入力された値がルール・ロジックで定義された受入基準を満たしていない場合に、自動問合せを生成するルールを作成できます。問合せメッセージを使用すると、ユーザーは入力を検証してエラーを修正する必要があることを把握できます。

注意:

自動問合せを作成するルールがすべてのデータに対して公開されると、公開されたすべてのルールが試験内のすべてのデータに対して再実行されます。つまり、データ更新なしでユーザーが以前にクローズした試験内のすべての問合せが再オープンされます。

これを回避するには、将来のデータに対してのみルールを公開してください。詳細は、単一ルールの公開を参照してください。

割当済問合せをトリガーするルールが更新されて割当リストに新規ロールが追加された場合、この更新は新規問合せが作成されたときにのみ使用可能になります。既存のオープン問合せは影響を受けず、割当リストに追加した新しいロールに割り当てられません。クエリーを閉じて再度開くと、新しく追加されたロールにそのクエリーが表示されます。

フォームで使用する値を計算するルールや、Eメール通知を送信するルールを作成することもできます。参照:

必要な要素を含む試験バージョンがテスト・コンテナにある必要があります。ルール・インタフェースへのアクセスの説明に従って、特定の試験バージョンおよびサイトからルール・インタフェースにアクセスします。

テスト・モードで目的の試験に移動し、施設を選択します(複数の施設にアクセスできる場合)。
表で、編集するビジット・カードを見つけてクリックします。
左側で、ルールを作成するフォームをクリックします。
ルールを含む質問を選択し、該当する場合は問合せの実行先を選択します。
右側で、「ルール」ペインを展開し、「ルールの追加」をクリックします。

ルール・エディタで、次のフィールドに入力します。次に、「次」をクリックします。

フィールド	説明
ルール名	ルールの名前を入力します。各名前は試験内で一意である必要があり、文字数は512を超えないようにする必要があります。
説明	4000文字を超えないルールの簡単な説明を入力します。このフィールドは必須ではありません。ただし、説明を追加すると、試験で各ルールとその目的を区別するのに役立ちます。これは、ルールを再利用する場合に便利です。
フォームのブロック解除	ルールの実行中にブロックされることなく、サイト・ユーザーがフォームを編集および保存できるようにする場合は、このトグルをオンにします。注意: 複雑なルールの実行には時間がかかります。サイト・ユーザーは、ルールの実行中に引き続き値を入力してフォームを保存できます。ただし、複雑なルールによって生成されたフォームの更新は遅延でき、ページのリフレッシュ後にのみ表示されます。

フィールド

説明

ルール名

ルールの名前を入力します。各名前は試験内で一意である必要があり、文字数は512を超えないようにする必要があります。

説明

4000文字を超えないルールの簡単な説明を入力します。

このフィールドは必須ではありません。ただし、説明を追加すると、試験で各ルールとその目的を区別するのに役立ちます。これは、ルールを再利用する場合に便利です。

フォームのブロック解除

ルールの実行中にブロックされることなく、サイト・ユーザーがフォームを編集および保存できるようにする場合は、このトグルをオンにします。

注意:

複雑なルールの実行には時間がかかります。サイト・ユーザーは、ルールの実行中に引き続き値を入力してフォームを保存できます。ただし、複雑なルールによって生成されたフォームの更新は遅延でき、ページのリフレッシュ後にのみ表示されます。

「変数」セクションで、ルール変数を定義します。
「式」セクションで、問合せを生成するために評価されるJavaScript式を入力します。
例:
```
if (diastolic>systolic){
    return false;        //query is raised when return false condition is met
} 
else{    
    return true;
}
```
注意:
- アクション・アイテムが動的である場合、ルール式には、クエリーがトリガーされる前にアイテムが表示されるようにするロジックを含める必要があります。
- デフォルトでは、ルールは、フォームを含む試験のすべてのビジットおよびすべての試験バージョンに対して実行されます。
  - ルールの実行対象となる試験バージョンを制限するには、isStudyVersion()ヘルパー関数を使用します。
  - ルールを適用し、特定のビジットに対してのみ実行する必要がある場合は、getCurrentVisitPropertyValue (Control)ヘルパー関数を使用できます。
ヒント:
予測テキスト機能は、使用可能なサブジェクト属性、ルール・ヘルパー関数などを使用して、入力時に使用できます。予測テキストを使用したルールの記述を参照してください。

「アクション」ドロップダウンから、目的の問合せタイプを選択します。

オプション

説明

問合せの作成

このオプションを選択すると、ルール式によって返される値がFalseになるたびに問合せが自動的に生成されます。

割当済問合せの作成

特定の試験ロールに問合せを割り当てるには、このオプションを選択します。このオプションでは、表示されるフィールドをクリックし、「ロール」ドロップダウン・リストから1つ以上の試験ロールを選択する必要があります。問合せは選択したロールにのみ割り当てられます。

ノート:

「ロール」ドロップダウン・リストには、試験で作成された試験ロールのみが表示されます。テンプレート・スタディ・ロールは含まれていません。

適切なテキスト・ボックスに問合せメッセージを入力します。
どちらの問合せタイプでも、問合せメッセージを追加する必要があります。
「保存」をクリックします。

これで、ルールが作成され、「ドラフト」ステータスになりました。

ルールを本番で使用可能にします。ルールをテスト、承認および公開する必要があります。ルールはスタディ・バージョンに依存せず、「公開済」状態になると、すべてのモードで適用されます。

このルールを削除してやり直す場合は、メニュー・アイコン()をクリックし、「削除」を選択します。

カスタム・ルールの開発例および詳細は、次を参照してください。

親トピック: ルール・エディタを使用したルールの作成