ルール変数の定義

カスタム・ルールの作成時に、ルール式内で使用する収集データを参照する変数を定義します。

カスタム・ルールは、ルール・エディタから作成されます。ルール・インタフェースへのアクセスを参照してください。

ルールを作成するときは、ルール変数と式、処理を定義する前に、ルール名と摘要を入力する必要があります。

  1. ルール・エディタの上部で、「変数」セクション・タイトルの横にあるプラス記号アイコン(変数の追加)をクリックします。
    編集可能なフィールドを含む行が表示されます。
  2. 最初のフィールドで、変数の名前を入力します。
  3. 各ドロップダウンからビジット、フォームおよび質問を選択します。例:
    次に例を示します。
    Var BP_Sys = Screening visit, Vital Signs form, Blood Pressure Systolic question.

    表2-1様々なユースケースに設定される変数

    ユースケース 設定 動作
    現在のビジットからのデータの取得

    「訪問」フィールドで「- すべての訪問- 」を選択します。

    このシナリオでは、ルールが実行されている現在のビジットのフォームから変数値が取得されます。このオプションでは、ルールがターゲット・フォームと同じビジット内のフォームを参照することのみが許可されます。

    特定のビジットからのデータの取得

    「訪問」フィールドで特定のビジットを選択します。たとえば、スクリーニング・ビジットです。

    特定のビジットを選択すると、ルールが実行されるすべてのビジットについて、指定したビジット(この場合はスクリーニング・ビジット)のフォームから変数データが取得されます。

    現在のビジットにないフォームからデータを取得します

    「訪問」フィールドで「- 任意の訪問- 」を選択します。

    このシナリオでは、変数値は、ルールが作成されている同じビジットに存在しないフォームから取得されます。このタイプの変数は、getValues( )ヘルパー関数と組み合せてのみ使用できます。

    ビジット日データを変数として取得します

    フォーム質問の両方として「訪問日」を選択します。

    ビジットの日付は個別のフォームとみなされ、すべてのビジットに含まれます。このため、訪問日フィールドをターゲットとして構成したルールは、ルール・ロジックによって異なる指示が行われないかぎり、すべての症例訪問に対して実行されます。

    注意:

    ビジット日は、必要に応じて、ルールの変数またはルールのターゲットとしてのみ使用する必要があります。
    これは、ビジット日が独自のフォーム(試験デザイナでは作成されない)のシステム・アイテムであり、変数またはターゲットとして使用すると、ルールの実行に通常より時間がかかる可能性があるためです。
    • 訪問日を別のフォーム質問と比較するカスタム・ルールを作成する必要がある場合、フォーム質問は訪問日ではなくターゲットである必要があります。

      たとえば、通知同意日が訪問日以前であることを確認するカスタム・ルールを作成する必要がある場合があります。ここで、通知同意日という質問がターゲットになります。

    • ビジット日は、他のフォーム質問をトリガーとして使用できない場合に、計算ルールをトリガーする変数としてのみ使用する必要があります。
作成する変数ごとに、必要に応じて前述のステップを繰り返します。