カスタム・ルールのクイック・スタート

新規ルールの作成

1前提条件

ルールの使用を開始する前に、まず次の要素を含むスタディ・バージョンをテスト・コンテナに用意する必要があります。

FORMS
訪問(フォームを含む)
主語
テスト・コンテナに配置されたスタディ・バージョンに関連付けられたサイト

2ルール・エディタへのアクセス

ホーム・ページで、作業するスタディの「テスト・モード」ボタンをクリックします。
上部で、症例が選択されていることを確認します。
試験について複数の施設にアクセスできる場合は、右上隅の施設ドロップダウンから施設を選択します。
表で、編集する訪問カードを見つけてクリックします。
訪問ウィンドウの左側で、ルールを作成するフォームをクリックします。
ルールを含める質問を選択します。右側で、「ルール」ペインを展開し、「ルールの追加」をクリックします。

3ルールの追加

ルール・エディタで、次のフィールドに入力して、「次」をクリックします。

ルール名:ルールの名前を入力します。それぞれの名前はスタディ内で一意である必要があります。
摘要: ルールの簡単な摘要を入力します。このフィールドは必須ではありませんが、学習の各ルールとその目的を区別するのに役立ちます。これは、ルールを再利用する場合に役立ちます。
ユーザーをブロックしない:ルールの実行中にサイト・ユーザーがフォームをブロックせずに編集および保存できるようにする場合は、このトグルをオンにします。

ルールの変数を定義します。

「変数」の横にあるプラス記号(+)をクリックして、変数を追加します。
最初のフィールドに、変数の名前を入力します。
各ドロップダウンから訪問、フォームおよびアイテムを選択します。
ヒント: ルールは、フォームを含むスタディのすべての訪問に対して実行されます。「訪問」フィールドで「- すべての訪問- 」を終了すると、ルールが実行されている現在の訪問のフォームから変数データが取得されます。特定の訪問を選択すると、ルールが実行されるすべての訪問について、指定した訪問のフォームから変数データが取得されます。
作成する新しい変数ごとに、ステップa、bおよびcを繰り返します。

「式」フィールドに、値に評価されるJavaScript式を入力します。
プログラム可能なルールの概要は、ルール開発者ガイドを参照してください。
「アクション」ドロップダウンから、ルールで生成するレスポンスのタイプを選択します。

「問合せの作成」を選択すると、ルール式によって返される値が「偽」になるたびに問合せが自動的に生成されます。さらに、ユーザーに表示する問合せメッセージを入力します。
特定のスタディ・ロールに問合せを割り当てるには、「割当済問合せの作成」を選択します。テキストボックスをクリックして1つ以上のスタディ・ロールを選択し、右側に問合せメッセージを入力します。
注:「ロール」( Roles)ドロップダウンリストには、スタディで作成されたスタディロールのみが表示されます。テンプレート・スタディ・ロールは含まれていません。
自動問合せのルールの作成の手順を参照してください。
値を自動的に計算して読取り専用アイテムに結果を入力する場合は、「値の計算」を選択します。計算値の「ターゲット・タイプ」(テキストまたは数値)および「書式」も選択する必要があります。
ステップ・バイ・ステップの手順を読み、計算値のルールを作成します。
特定のユーザーに電子メール通知を送信するには、「通知の送信」を選択します。件名、電子メール・アドレスをセミコロンで区切って入力し、送信するメッセージを入力します。
電子メール通知を送信するルールを作成するの手順を参照してください。

「保存」をクリックします。
ノート: ルール式に構文エラーが含まれている場合、ルール・エディタによって修正のマークが付きます。UATおよび承認済に昇格するには、ルールに有効な式および少なくとも1つのアクションが含まれている必要があります。

4ルールのデバッグ

ルール・エディタでルールを作成するときに、必要に応じてログ文を追加します。
ヒント: 既存のルールを編集するには、メニュー・アイコンをクリックして「編集」を選択します。
ログ・ヘルパー関数を正しく使用する方法の詳細は、logMsg()ヘルパー関数を参照してください。
「デバッグ」をクリックすると、JavaScript式への変更が自動的に保存されます。
右側に表示されるログ・ウィンドウを確認します。
JavaScript式が期待どおりに動作するまで、必要な変更を加えます。
「保存」をクリックします。
ステップ・バイ・ステップの手順および詳細を読み、ルールをデバッグします。

ルールの例

2つの値の比較

この例では、主題からバイタル・サイン情報を収集するためにバイタル・サイン形式が使用されています。ルールを使用して、糖尿病および収縮測定値を比較して被験者の血圧を計算し、糖尿病測定値が収縮圧力より大きい場合は問合せを生成します。

糖尿病血圧が変数名を使用してその収縮血圧より大きいかどうかを評価し、Falseを返して問合せを発行します。次に、アクションとして「問合せの作成」を選択し、問合せメッセージを入力します:


                    if(bpdia > bpsys)
    return false;

return true;

BMIの計算

この例では、主題からバイタル・サイン情報を収集するためにバイタル・サイン形式が使用されています。ルールは、フォームから重みと高さを読み取ってBMIを読取り専用の値として表示するために使用されます。

フォームから変数を追加してBMIを計算し、BMI式を読み取り専用アイテムとして返してから、計算値をフォームに表示するアクションとして「値の計算」を選択します。


                    if((weight === 0) || (height === 0)){
    return 0;
} else {
    return weight / (height * height);
}

通知同意の日付は日付範囲内である必要があります

この例では、スクリーニング・フォームを使用して、情報に基づく同意の日付を収集します。このルールは、日付が範囲内にあるかどうかを計算し、日付が定義済パラメータの範囲外である場合に問合せ通知を作成するために使用されます。

"isDateInRange()"ヘルパー関数を使用して、情報に基づいた承諾の日付がパラメータ内にあるかどうかを評価します。「False」を返して問合せを発行し、アクションとして「問合せの作成」を選択し、問合せメッセージを入力します。


                    var dateFrom = new Date("March 1, 2020");
var dateEnd = new Date("March 30, 2020");

return isDateInRange(dateInformedConsent, dateFrom, 
dateEnd, "both");

ノート: ルール開発者ガイドのその他のルールの例を参照してください。

テストとパブリッシュ

1ルールのテストと承認

本番にパブリッシュする前に、ルールをテストして承認する必要があります。

ホーム・ページで、作業するスタディの「テスト・モード」ボタンをクリックします。上部で、症例が選択されていることを確認します。
試験について複数の施設にアクセスできる場合は、右上隅の施設ドロップダウンから施設を選択します。
表で、編集する訪問カードを見つけてクリックします。
訪問ウィンドウの左側で、ルールをテストおよび承認するフォームをクリックします。
ルールを含む質問の値を入力します。
「保存」をクリックします。
ステップ6と7を繰り返して、考えられるすべてのシナリオをテストします。ルールですべてのシナリオに対して予想される結果が生成される場合:
1. 「ルール」ペインで、ルールの名前の横にあるルールのステータス・アイコンをクリックして、ステータス・スライダを表示します。
2. スライダをUATから「承認済」に移動します。
  ノート:ルールの詳細を読取り専用モードで表示するには、メニュー・アイコン(「メニュー」アイコン)をクリックして「表示」を選択します。

2 1つ以上のルールの公開

ルールを公開するには、一度に1つのルールを公開する方法と、複数のルールを一度に公開する方法があります。

ホーム・ページで、作業するスタディの「テスト・モード」ボタンをクリックします。
上部で、症例が選択されていることを確認します。
試験について複数の施設にアクセスできる場合は、右上隅の施設ドロップダウンから施設を選択します。
表で、編集する訪問カードを見つけてクリックします。
訪問ウィンドウの左側で、公開するルールを含むフォームをクリックします。
「ルール」ペインの上部で、「フォーム内のすべてのルール」トグルをクリックします。
「ルール」ペインで、「フォーム内のすべてのルールの表示」トグル・ボタンをクリックします。
「Publish All Approved Rules」をクリックします。
注意:ステップ6および7に従って本番でルールを公開できるのは、スタディがすでに「承認済」コンテナ内にある場合のみです。そうでない場合は、「テスト」から「承認済」にスタディを移動して、本番のすべてのルールを公開する必要があります。

3公開済ルールの変更および再公開

公開済ルールを変更し、必要に応じて再公開できます。公開済ルールをテスト・モードで変更した場合、そのルールのステータスを「公開済」に更新するまで、変更は本番モードで表示されません。

ホーム・ページで、作業するスタディの「テスト・モード」ボタンをクリックします。
上部で、症例が選択されていることを確認します。
試験について複数の施設にアクセスできる場合は、右上隅の施設ドロップダウンから施設を選択します。
表で、編集する訪問カードを見つけてクリックします。
訪問ウィンドウの左側で、公開済ルールを変更するフォームをクリックします。
「Rules」ペインの上部で、「All Rules in the Form」トグルをクリックします。
そのルールを含む質問を選択します。
右側で、「ルール」ペインを展開し、メニュー・アイコンをクリックします。
「編集」を選択します。
ルール・エディタで、変更を行います。「保存」をクリックします。
注意:ルールのステータスが「下書き」に更新されます。現在本番に公開されているルールは、この変更の影響を受けません。最初からやり直す場合は、「ドラフト」ステータスのルールをいつでも削除できます。

Oracle Life Sciences Clinical One Platformの詳細をご覧ください。

詳細情報の取得

その他のリソース

Oracleヘルプ・センターで、これらおよびこれらの短いトレーニング・ビデオを視聴してください。