問合せを生成するための事前定義済検証ルールの構成
フォーム設計で追加された事前定義済検証ルールを構成して、回答の検証、問合せの呼出し、またはその両方を実行できるようになりました。
この新機能について
試験デザイナは通常、フォーム設計に事前定義済ルールを追加して、回答を検証したり、特定の基準を満たしていることを確認したり、動的な質問やフォームを表示したり、通知を送信したりするなど、特定のアクションをトリガーします。その他のシナリオは、ルール・デザイナによってプログラムおよびテストされるカスタムJavaScriptルールを使用してカバーできます。
- 検証: エラーをスローし、エラーが解決されるまで、サイト・ユーザーが無作為化および試用供給管理(RTSM)アクションを実行できないようにします。
- 問合せとして生成される検証。これによって、RTSMアクションも防止されます。ただし、この場合は、まず検証エラーに対処する必要なく、関連する問合せをクローズして、影響を受けるRTSMアクションを続行できます。
- 簡易問合せ: データ・レビュー担当者に対して指定された基準を満たさないが、RTSMアクションに影響を与えない回答を識別します。これらの問合せは、通常の問合せワークフローに従います。
研究デザイナーの詳細
- フォーム設計で検証ルールを追加または更新すると、「検証」と「問合せの作成」の2つの構成トグルが使用可能になります。
- 検証ルールに対して少なくとも1つのトグルをアクティブ化するか、両方をアクティブ化する必要があります。ルール構成に応じて、結果は異なる場合があります。
構成 結果 検証 ルール基準を満たさない回答は無効になり、RTSM処理に影響を与える可能性があります。
無効な回答には、ルール構成で試験デザイナによって定義された赤いアウトラインおよびエラー・メッセージが含まれます。
クエリーの作成 問合せは、ルール基準を満たさないが、無効ではなく、RTSMアクションに影響しない回答に対して発生します。
問合せは、データを保存して送信した後にのみ表示されます。ただし、データ入力時に、赤いアウトラインがアンサーを囲み、(検証中と同様に)エラー・メッセージが表示され、失敗した基準をサイト・ユーザーに通知し、該当する場合は、保存する前にアンサーを修正できます。データが送信され、問合せが発生すると、失敗した検証インジケータは消えます。
[確認]および [クエリーの作成] ルール基準を満たさない回答は無効になり、問合せが呼び出されます。RTSMアクションも影響を受ける可能性があります。
入力したデータが検証基準を満たさない場合、データ入力時に赤いアウトラインとエラー・メッセージが表示されます。その後、問合せは呼び出されますが、データは一度だけ送信されます。回答が無効になるため、失敗した検証インジケータは残ります。
- 同じ質問に複数の検証ルールを追加できます。この検証ルールは、論理演算子ANDまたはORを使用して評価されます。異なる方法で構成されたルール(検証のみ、問合せのみまたはその両方)を1つの質問に結合できますが、論理演算子を組み合せることはできません。
この機能の詳細は、リリース・アセスメント環境(RAE)のアップグレード後の『Study Designerユーザー・ガイド』を参照してください。
サイトおよびその他のスポンサ・ユーザーの詳細
- これらのルールのいずれかがデータ収集中にトリガーされた場合、サイト・ユーザーは入力されたデータを修正して解決できます。呼び出された問合せの場合、サイト・ユーザーは、入力されたデータの更新に適用できない場合など、それに対する回答を提供することもできます。その後、スポンサ・ユーザーが問合せをクローズすると、検証が解決されます。
プログラムされたクエリーおよび手動クエリーを閉じる権限を持つユーザーは、これらのタイプのクエリーを閉じることもできます。
ノート:
質問に対する問合せが複数ある場合は、一部の問合せが検証であり、そうでない場合があります。 - 質問に複数の検証ルールを追加する場合、これらの条件の処理方法とエラー・メッセージの表示方法には違いがあります。
- OR条件に続く複数のルールでは、1つの検証が満たされるか、すべて評価されて失敗するまで、検証ルールがすべて評価されます。OR条件は、すべての検証が失敗した場合にのみ失敗するため、その場合は関連するすべてのエラー・メッセージまたは問合せが表示されます。次に、少なくとも1つのエラーまたは問合せが解決されると、OR条件が満たされ、すべてのエラーが消失してトリガーされた問合せがクローズされます。
- AND条件に続く複数の検証については、全てのルールが評価されます。いずれかの条件が失敗すると、条件全体が失敗し、失敗した検証ごとにエラー・メッセージまたは問合せが表示されます。すべてのエラーまたは問合せが解決されるまで、質問は失敗状態のままです。
- 問合せを手動でクローズした場合、ルールが更新され、変更が拡張試験バージョニング(ASV)で適用されてもデータが更新されないかぎり、問合せは再評価されません。事前定義の検証ルールは、データの更新時に常に再評価されます。
- 他の問合せと同様に、事前定義の検証ルールによって生成されたこれらの問合せは表示され、問合せサイド・ペイン、ビジット内、および試験レベルでの問合せ管理用の「問合せリスト」ページから管理できます。これらの問合せは問合せレポートにも含まれており、発行ユーザーとして「自動計算」を使用してどこにでも表示されます。
- 日時質問の将来の日付検証は、デザイナ検証ルールではありません。ただし、これらは問合せとしてもトリガーされるようになりました。詳細は、「将来の日付では許可されていない場合に問合せが呼び出されるようになりました」を参照してください。
レポートへの影響
事前定義済検証ルールがルール・レポートに含まれますが、カスタム・ルールとは別になります。これをサポートするために、ルール・レポートは、デザイナ検証ルールと呼ばれる個別のタブにすべての検証ルールが含まれるCSV形式ではなく、XLSX形式で使用できるようになりました。PDFおよびHTML形式の出力には、フォーム設計で追加されたすべての事前定義済検証ルールに同じ名前の新しいセクションがあります。詳細は、「ルール・レポートがXLSX形式で使用できるようになりました」を参照してください。
| レポート | 変更のタイプ | 説明 |
|---|---|---|
| 試験デザイン・レポート | 変更された列データ |
フォームの「検証ルール」列で、フォーム設計で追加された検証ルールの場合、タイプ(「検証」、「検証と問合せ」または「問合せ」)が既存の情報の前面に追加されます。 例: 「検証と問合せ: 正確に1」。 |
| 注釈付きCRFレポート | 変更された列データ |
「検証」列で、フォーム設計で追加された検証ルールの場合、タイプ(「検証」、「検証と問合せ」または「問合せ」)が既存の情報の前面に追加されます。 例: ルール1: 検証および問合せ: 正確には1。 |
| ルールレポート | 新しいセクションと列 |
事前定義済検証ルールは、新しい「デザイナ検証ルール」セクションまたはタブ(形式に応じて)にこのレポートに含まれます。 このセクションに追加する列の詳細は、ルール・レポートのドキュメントを参照してください。 |
| 問合せレポート | 新規列 |
新しい「タイプ」列が追加され、検証機能があるか(「検証と問合せ」)、カスタム・ルールによって生成されるか(「自動問合せ」)、または手動問合せであるか(「手動」)が示されます。 |
既にライブ勉強をしていますか?
この新機能がリリースされると、既存の機能を保持するために、既存の検証ルールは「検証」トグルのみアクティブで構成されます。このリリースが使用可能になるとすぐに、問合せを作成する新しい検証ルールを作成したり、いつでも更新して、既存のルールに問合せ機能を追加できます。
拡張試験バージョニング(ASV)を使用して、これらの更新または事前定義の検証ルールに適用できます。RAEのアップグレード後のアドバンスト試験のバージョニングについてで、ASVでこの新機能を使用した場合の影響の詳細を参照してください。
親トピック: 学習デザイン