比較ルール (V2)
25R1 以降
Vault EDC の比較ルール機能により、スタディデザイナーは、ルールエディタを使用することなく、日付と日時を比較するシステム管理されたクエリルールを簡単に作成することができます。比較ルールは、ユーザが式を書いたり、検証したり、ユーザ定義ルールのトラブルシューティングをすることなく、必要な識別子と演算子を選択するだけで、スタディの構築時間を大幅に短縮します。
すべての比較ルールはクエリアクションを使用します。デフォルトでは、システムは比較ルールで使用された識別子と演算子に基づいて標準のクエリメッセージを作成します。詳しくは、利用可能なオペレーターの表をご覧ください。
前提条件
比較ルールコンフィギュレータ V2 は、25R1 (2025 年 4 月) リリース以降に作成されたスタディで自動的に利用可能です。この機能は、比較ルール V1 を使用していない既存のスタディに対して有効化することができます。詳細は Veeva のサービス担当者までお問い合わせください。
CDMS 試験デザイナー標準ロールを持つユーザは、デフォルトで下記のアクションを実行することができます。組織がカスタム試験ロールを使用する場合、お客様のロールに以下の権限が付与されている必要があります:
タイプ | 権限ラベル | 制御 |
---|---|---|
標準タブ | Studio タブ | Studio タブへのアクセス権限 |
機能権限 | スタディのデザイン | Studio からスタディデザイン定義とスタディスケジュールを作成する権限 |
スタディに制限付きデータが含まれている場合、それを閲覧するには制限ありデータアクセス権限が必要です。
スタディロールについて詳しくご確認ください。
比較ルールの作成
比較ルールを作成するには:
- 識別子 1と識別子 2を選択します。
- 識別子のタイプを選択します。項目、イベント日付、ケースブック変数を選択できます。
- 識別子の構成要素を選択します。 各タイプについては、必須フィールドが黄色で強調表示されます。
- オプション: 項目タイプ識別子では、イベントと事象グループを空白のままにして、選択したフォームに対して、またはスケジュール全体に対してルールを相互に評価することができます。これはユーザ定義ルールの @Form 浮動識別子と同様の機能です。
-
繰り返しフォームの場合: 選択したフォームが繰り返しフォームの場合、繰り返しフォームのインスタンスでは、最新インスタンス、すべてのインスタンスを選択するか、特定のインスタンスを選択し、ルールを評価するシーケンス番号を入力します。
- 不明を許可する識別子項目: 不明を処理では、日付または日時の不明な部分を最小値または最大値に置き換えるかどうかを選択します。
-
ドロップダウンメニューから、識別子を選択します。比較ルール V2 の演算子は、比較ルール V1 とは異なる機能を持っています。利用可能な識別子について (#available-operators) 詳しくご確認ください。
- 任意の作業: ルール範囲については、現在の事象グループチェックボックスを選択します。複数回収集される入力については、この設定により、スタディ全体ではなく、ルールが評価される現在の事象グループ内の事象 またはフォームのみを追加するよう Vault に指示します。
- オプション: ルールの実行の場合、[保存後ルール] チェックボックスを選択すると、ユーザがフォームを送信した後までルールの実行を遅らせることができます。フォームの送信が長引くのを避けるために、多くの順列を持つルールに対してこれを行うことが推奨されます。
- 任意の作業: クエリメッセージに独自のテキストを使用する場合、クエリメッセージの上書きを入力してください。そうしない場合は、デフォルトクエリメッセージを使用するため、空白のままにしておきます。
- ルールを作成したら、保存して閉じるをクリックします。
比較ルールのコピー
Vault を使用すると、現在のスタディとアクセス可能な他のスタディの両方から比較ルールをコピーすることができます。比較ルールは、比較ルール V2 を使用する他のスタディからのみコピーできます。
現在の試験から
スタディ内で比較ルールを複製すると、調査内の他のルールと類似したルールをすばやく作成できます。現在のスタディ内の比較ルールを複製するには:
- Studio > 比較ルールに移動します。
- 比較ルールにカーソルを合わせると、アクションメニューが表示されます。
- 必要な変更を行い、保存して閉じるをクリックします。
他の試験から
別のスタディ から比較ルールをコピーすることもできます。注: 一致する識別子が (ターゲット) 試験に存在しない場合、Vault はルールを「無効」としてコピーされるため、使用するには識別子を更新してルールを再度有効にする必要があります。他のスタディ から比較ルールをコピーするには:
- Studio > 比較ルールに移動します。
- 試験からコピーをクリックします。
- コピーを作成または既存のものを使用して重複を処理を選択します。
- Vault を選択します。
- コピー元を選択します (スタディからまたはライブラリから。)
- コピー元となるスタディを選択します。
- コピー元の環境を選択します。
- コピーしたい比較ルールを選択します。
- 任意の作業: すべてを選択チェックボックスを選択すると、すべての比較ルールをコピー元として選択できます。
- # 比較ルールをコピーをクリックします。Vault は比較ルールをスタディにコピーするジョブを開始します。完了すると、Vault からログ ファイルをダウンロードするためのリンクが記載された電子メール通知が送信されます。
- 閉じるをクリックします。
比較ルールアクション
比較ルールアクションメニューから以下のアクションを実行できます:
- 名前の変更
- 重複
- 無効化/有効化
- アーカイブ
- ルールバインディングの表示
比較ルールのアーカイブ (削除)
アーカイブされた比較ルールは機能的に削除されます。これらのルールは、Studio > 比較ルールで比較ルールのリストには表示されず、検索することもできません。
比較ルールをアーカイブするには:
- Studio > 比較ルールに移動します。
- アーカイブをクリックします。比較ルールはアーカイブ (削除) され、検索することはできません。
利用可能なオペレーター
使用できるオペレーターは下表の通りです。各オペレーターは、標準的なクエリメッセージを持っています。
比較ルール V2 演算子の変更: 比較ルール V2 のルールロジックと演算子のラベルは、比較ルール V1 のものとは異なります。ユーザ定義ルールと同様に、V2 比較ルールの式は true または false として評価されます。式が true と評価されると、ルールアクションが実行され、クエリメッセージが追加されます。
演算子 | クエリメッセージ |
---|---|
は次の後 (>) | 識別子 1 を識別子 2 の後に置くことはできません。 |
は次以降 (≥) | 識別子 1 を識別子 2 の後、または等しくすることはできません。 |
は次の前 (<) | 識別子 1 を識別子 2 の前に置くことはできません。 |
は次以前 (≤) | 識別子 1 を識別子 2 より前、または等しくすることはできません。 |
は次に等しい (=) | 識別子 1 を識別子 2 と等しくすることはできません。 |
次に等しくない (≠) | 識別子 1 は識別子 2 と等しくしなければなりません。 |