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

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

注意:

自動問合せを作成するルールがすべてのデータに対して公開され、「承認済」状態の場合、このルールを含む試験バージョンが「テスト中」から「承認済」に移動すると、公開されたすべてのルールが試験のすべてのデータに対して再実行されます。つまり、以前にデータ更新なしでユーザーがクローズしていた、そのスタディ内のすべての問合せが再オープンされます。

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

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

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

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

目的のスタディに移動し、サイトを選択します(複数のサイトにアクセスできる場合)。
表で、編集するビジット・カードを見つけてクリックします。
左側で、ルールを作成するフォームをクリックします。

注意:
ルールは、フォームを含む試験内のすべての訪問に対して実行されます。

ヒント:
特定のビジットに対してのみルールを適用して実行する必要がある場合は、 getCurrentVisitPropertyValue (Control)ヘルパー関数を使用できます。
ルールを含む質問を選択し、該当する場合は問合せの実行先を選択します。
右側で、「ルール」ペインを展開し、「ルールの追加」をクリックします。
ルール・エディタで、次のフィールドに入力します。

ルール名

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

説明

4000文字を超えないルールの概略を入力します。このフィールドは必須ではありません。ただし、説明を追加すると、各ルールと試験の目的を区別するのに役立ちます。これは、ルールを再利用する場合に便利です。

フォームのブロック解除

ルールの実行中にブロックされずにサイト・ユーザーがフォームを編集および保存できるようにする場合は、このトグルをオンにします。複雑なルールの実行にはさらに時間がかかります。ルールの実行中でも、サイト・ユーザーは値を入力してフォームを保存できます。ただし、複雑なルールによって生成されたフォームの更新は遅延する可能性があり、ページ・リフレッシュ後にのみ表示される場合があります。
「次」をクリックします。
「変数」フィールドで、ルール変数の定義を行います。
「式」フィールドに、値に評価されるJavaScript式を入力します。
例:
```
if (diastolic>systolic){
    return false;        //query is raised when return false condition is met
} 
else{    
    return true;
}
```
ヒント:
- アクション・アイテムが動的である場合、ルール式には、クエリーがトリガーされる前にアイテムが表示されるようにするロジックを含める必要があります。
- デフォルトでは、ルールはすべての試験バージョンに対して実行されます。ルールが実行される試験バージョンを制限するには、組込みのJavaScript関数isStudyVersion()を使用します。
「アクション」ドロップダウンから、目的の問合せタイプを選択します。
- 「問合せの作成」を選択すると、ルール式によって返される値がFalseになるたびに問合せが自動的に生成されます。ユーザーに表示する問合せメッセージを入力する必要があります。
  
  たとえば、サブジェクトの血圧の値がルールで指定された範囲外である場合はいつでも問合せを生成できます。問合せメッセージを使用すると、ユーザーは入力を検証してエラーを修正する必要があることを把握できます。このクエリーは、システム内のクエリーを表示する権限を持つすべてのユーザーに表示されます。
- 特定の試験ロールに問合せを割り当てるには、「割当済問合せの作成」を選択します。このオプションでは、表示されるフィールドをクリックし、「ロール」ドロップダウン・リストから1つ以上の試験ロールを選択する必要があります。問合せは選択したロールにのみ割り当てられます。また、ユーザーに表示するメッセージを指定する必要があります。
  
  注意:
  「ロール」ドロップダウン・リストには、試験で作成された試験ロールのみが表示されます。テンプレート・スタディ・ロールは含まれていません。
「保存」をクリックします。

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

ルールを本番で使用可能にするため。ルールをテスト、承認および公開する必要があります。ルールは試験バージョンに依存せず、「公開済」状態になるとすべてのモードで適用されます。詳細は次を参照してください。

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

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

親トピック: カスタム・ルールの作成および管理