getVisitWndw( )

1つ以上のビジットのビジット・ウィンドウおよびスケジュール詳細を取得します。オプションには、指定したビジット、次のビジット(症例の現在の動的および分岐計算に基づく)、現在のビジット、または試験で設計された以前のすべてのビジットが含まれます。

ノート:

未スケジュールのビジット、取下げ、試験完了、スクリーニング失敗、再スクリーニング・ビジットおよび有害事象は、本質的にスケジュール解除されているためサポートされていません。次ビジットまたは前ビジットが使用されている場合、未スケジュール・ビジットは無視され、指定した方向(次または前)に移動したときに最初に検出されたスケジュール済ビジットが返されます。現在またはビジット情報が使用されている場合、nullが返されます。

たとえば、このルール・ヘルパー関数を次のユースケースに使用できます。

• 症例が本日交付の期日で、次のビジット・ウィンドウが21日を超える場合は、次のビジットの前に規定外交付ビジットが必要であることを施設ユーザーに通知する必要があります。
• 予定外のビジットがある場合、交付するキット数を決定するために次の予定ビジットまでの日数を考慮する必要があるため、調査製品は無駄になりません。
• 構成済のビジット・ウィンドウ外でビジットが発生した場合に、特定のユーザーに送信されるEメール通知を構成できます。

ルールはデータ送信によってトリガーされます。システム・アクションを実行しても、実行するルールはトリガーされません。ここで説明するヘルパー関数によって返されるデータはすべて、ルールが実行される時点です。ルールの実行後に情報が変更された場合、ルールが再実行されることはありません。

構文

getVisitWndw(referenceVisit, eventInstanceNumber)

パラメータ

次のいずれかのパラメータを渡して、返されるビジット・ウィンドウのコンテキストを指定できます。

パラメータ	必須またはオプション	説明
referenceVisit	必須	ビジット・コンテキストを指定する文字列値または変数名。次のいずれかの値を指定できます。 current: ルール・ターゲットに基づいて現在のビジットのウィンドウを返します。 next: ルール・ターゲットに基づいて、次の予想ビジットのウィンドウを返します。ブランチの一部の場合、このビジットは動的に決定されます。次のビジット値は、ルール実行時の現在の分岐ロジックに基づきます。 前回すべて: 前回のビジットがスキップされた場合でも、前回のすべてのビジットのウィンドウを返します。 変数名: 変数セクションに定義されている変数の名前を入力して、特定のビジットのビジット・ウィンドウを返します。これは、指定された変数定義で選択されたビジットです。 これには、指定したビジットを指す「ビジット情報」グローバル変数を作成する必要があります。ルール変数の定義を参照してください。
eventInstanceNumber	オプション	循環ブランチ・ビジットを参照するreferenceVisitとして変数を渡した場合は必須です。 ビジット変数名が指定されている場合のサイクル・ビジットのインスタンス番号を表す整数値。それ以外の場合、ルールはターゲットのeventInstanceNumberを使用します。このパラメータは、null値を受け入れることもできます。

戻り値

ノート:

次の点を考慮します:

• 次または前回すべてを使用する場合、スケジュールされていないビジットは無視されます。かわりに、指定した方向(次または前)に最初のスケジュール済ビジットが返されます。current変数またはVisit Information変数が使用されている場合は、null値が返されます。
• 指定されたビジットがサイクル内にある場合、すべてのインスタンスがアレイとして返されます。
• すべての日付は、サイトによって入力された情報に基づいて計算されます。ただし、「デバッグ」ウィンドウでは、正確な時間ベースの計算および算術演算をサポートするために、日付がGMTタイムスタンプとともに表示されます。

指定されたパラメータに応じて、該当するビジットごとにオブジェクトの配列を返します。各オブジェクトには次の形式で次の情報が含まれます。

 {         
"visitName": "visitName",
"eventInstanceNumber":"eventInstanceNumber",   
"scheduledDate":"scheduledDate",         
"scheduledWndwStartDate":"scheduledWndwStartDate", 
"scheduledWndwEndDate":"scheduledWndwEndDate",  
"isSkipped":"T/F"     
}

各オブジェクトの情報は、次の属性として含まれます。

属性	説明
visitName	ビジットの名前。実際のビジット日を取得するには、他の変数を使用して別々に取得する必要があります。詳細は、ルール変数の定義を参照してください。
eventInstanceNumber	予定外ビジットまたはサイクル番号のインスタンス番号。
scheduledDate	実際のビジットが以前に行われた場合(予定日)でも、計算された予定ビジット日を示します。scheduledDateオブジェクトは、試験デザイナがビジット・スケジュールを定義するときに、「スケジュール開始」フィールドに指定されたアンカー・ビジット日に基づいて計算された日付を表します。
scheduledWndwStartDate	「ビジット・ウィンドウ」の「事前日数」として、試験デザイナによって指定された日数に基づいて、ビジット・ウィンドウの開始(「開始日」)
scheduledWndwEndDate	「ビジット・ウィンドウ」の「日数後」として、試験デザイナによって指定された日数に基づいて、ビジット・ウィンドウの終了日(「日付: 至」)。
isSkipped	ビジットがスキップされた場合はTrue、それ以外の場合はFalseを示します。

例3-93症例ビジットのビジット・ウィンドウ情報の取得

var vWnd = getVisitWndw('vVar', null);
if(vWnd) 
{
   logMsg(vWnd[0].scheduledWndwStartDate);
   var today = new Date();
   logMsg("diff vWnd: " + dateDiffInDays(today, vWnd[0].scheduledWndwStartDate));
}