ルール変数の定義

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

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

ルールを作成する際、ルール変数、式およびアクションを定義する前に、ルール名と説明を入力する必要があります。

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

    表2-1様々なユースケースに対する変数の設定

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

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

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

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

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

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

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

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

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

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

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

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

    注意:

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

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

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