はじめに

Viedoc Designerで、JavaScriptを使用して以下の項目を設定することにより、試験構築の柔軟性が大幅に向上します。

• 表示条件の設定 (項目、項目グループ、アクティビティ、イベント)
• 項目設定のバリデーションにデータチェックを記述
• 項目の自動計算や初期値を設定
• アラートの条件を記述

重要! 使用されるシンタックス(構文)はECMAScript 5.1スタンダードに記載されているJavaScriptの構文です。そのため、ECMAScript 5.1の仕様や範囲以外の値に対して機能を検証することが重要です。

注意! 誤ったフォーマットで記述されたJavaScriptコードが試験のデザインに設定された場合、Clinicで実行されたJavaScriptコードの結果は、表示条件、データチェック、アラートにおいて「falseの結果」として処理されます。 項目の関数で使用された場合、その項目は入力されず、フォーム監査証跡に試験デザインの問題についてのメモが表示されます。

注意! 例えばCOMMON_AE.AESPIDのようにアラート対象項目への完全なパスが使用され、参照内でイベントが指定され、それがCommonイベントやUnscheduledイベントのように繰り返し発生する可能性がある場合、返される値は、イベントの日付に基づく最新のフォームインスタンスからのものになります。

使用される変数は、デザインの項目で、以下、Viedocの項目を指定するのセクションで説明されています。

使用されるJava Script演算子については演算子のセクションをご覧ください。

Viedocの項目を指定する

別フォームからの項目（以下「クロスフォーム項目」とする）は、Viedocで次の形式で指定されます：Event.Form.Item.

このように、 "." で区切られた3つの識別子で構成されます。

• イベントの識別子 - イベントの指定をご覧ください。
• フォームの識別子 - フォームの指定をご覧ください。
• 項目の識別子 - 項目の指定をご覧ください。

注意!

• イベントとは、試験デザインの試験ワークフローで定義されたイベントのことです。
• JavaScriptの言語定義では、キーワード間のスペースは許可されていますが、変数内のスペースは許可されていません。これは、変数に特定の値を代入する際に、Viedocは前後の文脈関係を含む構文全体の表現を1つのまとまりとして解析しようと試みるからです。（詳細は以下をご覧ください。）

イベントの指定

イベントは、次のいずれかの方法で指定できます。

• EventID - イベント設定で指定されたイベントID。
• EventID[StudyEventRepeatKey] - もしイベントが繰り返されるもので、特定の事象のみを指定したい場合は、
  [ ] 内にStudyEventRepeatKey値を書き込むことで行います。
• インデクサーを使用する。例として、EventID$FIRSTn - を使用すると、指定されたフォームが複数のイベントに現れる場合、 n 番目に開始されたイベントが指定されます。インデクサーについては、以下相対パスセクションを参照してください。

フォームの指定

フォームの指定は、次のいずれかの方法で可能です。

• FormID - Viedoc Designerのフォーム設定でフォームIDを指定できます。
• FormID[FormRepeatKey] - フォームが繰り返しフォームで、特定のインスタンスを指定したい場合は、そのFormRepeatKeyの値を[ ]内に記述します。
• FormID$ActivityID - オプションとして、同じイベント内の複数のアクティビティにそれぞれのフォームが出現する場合、そのアクティビティを指定することができます。
  例として、 DM$MORNING.WEIGHT - MORNINGアクティビティ内のDMフォームの項目WEIGHTを参照します。
• FormID$ActivityID[FormRepeatKey] - アクティビティと繰り返しフォームの特定のインスタンスの両方を指定したい場合は、この形式で指定します。

項目の指定

同一フォームの項目にアクセスするには、項目IDだけで十分であり、イベントやフォームを指定する必要はありません。この場合、Viedoc Clinicでインプットを変更すると、アウトプットも同時に更新されます。（インプットされた値次第）

同一フォーム内の項目に Event.Form.Itemを使用している場合、Viedoc Clinicでインプットを変更すると、フォームを保存して再度開いた後にのみアウトプットの値が更新されます。

別のフォームの項目（いわゆるクロスフォームアイテム）にアクセスするには、イベントとフォームを指定する必要があります。
EventID.FormID.ItemID

相対パス

相対パスを使用してクロスフォーム変数にアクセスすることもできます。 この場合、いくつかの特殊なキーワードを使用します。 StudyEventDefIdに追加できるキーワード。 これらのキーワードは、StudyEventDefIdがなくても、任意のイベントを選択するために使用することができます。

任意のインデクサの使用例

次に、任意のインデクサ（上の表の n を参照）の使用例を紹介します。

フォーム「Add patient 」には、別のフォーム「PROFILE」上に存在する「NAME」と呼ばれる別テキスト項目の最新の空白ではない値を持つテキスト項目が存在するとします。これは、すべての規定イベント（STARTと呼ばれる最初のもの）と予定外イベントにあります。

以下の式は、フォーム「Add patient 」の項目で使用できます。

if($LAST.PROFILE.NAME != null) return $LAST.PROFILE.NAME;
if($LAST2.PROFILE.NAME != null) return $LAST2.PROFILE.NAME;
if($LAST3.PROFILE.NAME != null) return $LAST3.PROFILE.NAME;
if($LAST4.PROFILE.NAME != null) return $LAST4.PROFILE.NAME;
if($LAST5.PROFILE.NAME != null) return $LAST5.PROFILE.NAME;
if(START.PROFILE.NAME != null) return START.PROFILE.NAME;
return 'NOT SET';

これにより、最後の4つのイベントで項目が空白で保存される、または開始イベントの項目の値を再度保持することが可能になります。

クロスイベント日付

別のイベントの日付にアクセスするには、他のクロスフォーム変数と同じ原理を使用し、固定フォームID $EVENTと項目ID EventDateを使用します。

例として、AESTDT > BL.$EVENT.EventDate は、AE開始日はBLビジット日以降でなければならない、ということを意味します。

演算子

以下のJavaScript演算子を使用しています。

• Arithmetic Operators（算術演算子）
  • + (addition)
  • - (subtraction)
  • * (multiplication)
  • / (division)
• Comparison (比較演算子）
  • == (equal to)
  • != (not equal to)
  • < (less than)
  • > (greater than)
  • <= (less than or equal)
  • >= (greater than or equal)
• Boolean logic (ブーリアン型）
  • && (AND)
  • || (OR)
  • ! (NOT)

データ型

次の表は、Viedoc の項目とその JavaScript データタイプとデフォルト値の一覧です。

*チェックボックス、ラジオボタン、またはドロップダウンの項目タイプは、選択コードのいずれかが数値でない限り、通常は数値です。

値による代入または参照による代入

JavaScripにおけるデータ代入方法は値、または参照の2つの方法により行うことができます。

値による代入

特定の値が代入されるJavaScriptのデータ型は以下の通りです。

• boolean
• null
• undefined
• string
• number

これは、上記のタイプのうちの2つの変数を比較した際、それらの値がそのまま比較されます。 たとえば次のコードの場合、

var a = 3;
var b = 'def';
var x = a;
var y = b;

aの値は3、bの値は'def'、xの値は3、yの値は'def'となります。変数 a と x は同じ値 3 を持ち、b と y は同じ値 'def' を持ちます。しかしこれら4つの変数はすべて独立したものです。なのでここで、a の値を 5 に変更した場合、3 の値を持っている 変数 x には何の影響もありません。

参照による代入

参照することにより値が代入される JavaScriptのデータ型は以下になります。

• array
• function
• object

これは、これらの型の変数は、値そのものではなく、参照先に存在する特定の値を取得することを意味します。

セクションデータ型にどのViedoc項目がオブジェクトなのか記載がありますのでご覧ください。

JavaScriptでは日付は必ずオブジェクトになります。例えば以下のようなものがあるとします。

var d=new Date();
var c=d;
d.setDate(10);

変数dは日付オブジェクトとして作成され、変数cはdの値を参照しています。この場合、dを変更するたびに、cも同時に変更されます。つまり、dを現在の月の10日に設定すると、cも自動的に同じ値を取得します。

システム変数

ある式が特定のフォームの文脈内で記載されるとき、次の変数を利用することができます。

フォームの通し番号

以下は、試験計画で使用できる統計変数の表です。

変数について、値はすべて評価発現時の現在値です。つまり、その値（例えば総数など）は、特定のイベントと結びついています。

変数は以下のフォーマットで利用できます。<イベント識別子> .$STATS.<下の表にあるような変数> $THIS.$STATS.QueryRaisedCount

注意 ! これらの統計変数は、どのようなサマリーフォーマットでもサポートされていません。これらの変数に含まれる式は、カントが更新または変更されても再評価されません。

フォームシーケンス番号

The following form sequence numbers are used to make it easier to track different form instances at subject level, which are useful especially for the form instances initiated by copying the data from previous event.

• FormRepeatKey - Counter that identifies the specific instance of a repeating form within a specific activity. This is available in the export output for Viedoc output version 4.39 and onwards.
• SubjectFormSeqNo – Counter that uniquely identifies the instance of a specific form on a subject level, that is, it starts with 1 and it is incremented each time a new instance of the form is created for that subject. This is available in the export output for Viedoc output version 4.51 and onwards.
• OriginSubjectFormSeqNo – For a copied form instance, it identifies the form instance from which data was copied for the first time. For the first instance of the form (that is, not copied) it gets the value of the SubjectFormSeqNo. This is available in the export output for Viedoc output version 4.51 and onwards.
• SourceSubjectFormSeqNo – For a copied form instance, a counter that identifies the source of a copied form instance (the form instance the data was copied from). It gets the value of the SubjectFormSeqNo from which the form instance was copied. For the first instance of the form (that is, not copied) it is empty, that is, null. This is available in the export output for Viedoc output version 4.51 and onwards.

The example below illustrates how the values for these sequence numbers are assigned. The demo form used is set as repeatable and copyable and is included in Visit 1, Visit 2 and Visit 3.

We perform the following actions in Viedoc Clinic:

1	Initiate Visit 1 and fill-in three instances of the Demo form, these instances will get the sequence numbers as illustrated below:
2	Initiate Visit 2. Demo form will be available to be initiated by copying data from one of the previously filled-in form instances within Visit 1, so all the three instances will be shown as ghost forms:
3	Create an instance of Demo form within Visit 2 by copying the data from the third instance of the form filled in within Visit 1. This will result in the new form instance getting the sequence numbers as illustrated below:
4	Initiate Visit 3. Demo form will be available to be initiated by copying data from one of the previously filled-in form instances within Visit 1 and Visit 2, as below:
5	Create an instance of Demo form within Visit 3 by copying the data from the form filled in within Visit 2. This will result in the new form instance getting the sequence numbers as illustrated below:

These sequence numbers are available to be used within expressions only to get the value of the sequence number for a specific form instance, that is, by using {SubjectFormSeqNo}, {OriginFormSeqNo}, {SourceFormSeqNo}.

In the above example, the form Summary format was configured by using these sequence numbers as below:

Form Repeat Key {FormRepeatKey}, SubjectFormSeqNo {SubjectFormSeqNo}, OriginFormSeqNo {OriginFormSeqNo}, SourceFormSeqNo {SourceFormSeqNo}

Notes!

• Only the FormRepeatKey is used to identify a specific instance of the form in data mapping for data import,as well as in the item identifier used in JavaScript (for example EventID.FormID$ActivityID[FormRepeatKey].ItemID).
• When resetting a form, the sequence numbers are still allocated to it, and the next available ones are used for the new instances.

In the excel export output, these form sequence numbers allows to track, for the form instances that were initiated by copying data from previous events, where the data originates from, as below:

Analyzing the values of the form sequence numbers, only the form instances that were initiated by copying the data from previous visits have values populated in the Source Subject form sequence number column, that is, the last two rows in the example. The data was copied from the form instance having the same Subject form sequence number value, highlighted in green in the above image. The form instance that the data was copied for the first time is identified by the value of the Origin Subject form sequence number, that is, "3" in our example.

関数

Viedocで記載された式は、JavaScript の function と同様に機能します。（ECMAScript 5.1標準に沿う）

例

return 2;

var a=2;
var b=3;
return a+b;

式は単一の文として書くことが可能で、Viedocはそれらを関数に変換します。

式は、戻り値（式）に変換されます。例：

2
は以下のように変換
return (2);

または、

VSDT <= now()
は以下のように変換
return ( VSDT <= now());

重要! 　ループ(for, for/in, while, do/while)を使用する場合は、以下を考慮してください。

• 動作を確認せずにコードをインターネットからコピーをしないでください。
• 無限ループになっていないか確認してください。
• JavaScript関数を使用する場合は、ブラウザの互換性を考慮してください。
• クライアント側とサーバー側の両方でシステムのメモリ問題を引き起こす可能性があるので、インライン/再帰関数は避けてください。

JavaScript式エディタ

JavaScript式エディタは、JavaScriptを書く際のヘルプツールです。主な機能は以下の通りです。

• オートコンプリートとルックアップ
• エラーのハイライト表示
• Viedocが提供するアイテムや機能について詳しく説明しているeラーニングのセクションへのリンク

JavaScript式エディタは、Viedocのフォーム設定、アラート設定、チェック式の編集、患者ステータス設定など、高度な条件をJavaScript式で入力する箇所すべてでご利用になれます。

JavaScript式エディタを開くには、JavaScriptテキストエディターのフィールドにあるJSボタンをクリックします。

エディターが開きます。

エディターウィンドウは画面上好きな場所に移動することができ、右下の矢印でサイズを変更することができます。

オートコンプリートとルックアップ

JavaScript式エディタは、オートコンプリートとルックアップに対応しています。

• クロスフォーム変数へのアクセス
• コンテキストフォーム変数へのアクセス
• Viedocが提供するヘルパー機能（例：age、date、today）

JavaScript式エディタ・ウィンドウで入力を開始すると、ヘルプ・パネルにオートコンプリートの候補が表示されます。候補のリストにある項目の詳細を確認するには、その項目の上にマウスを置いて、ペインの右上にある > シンボルをクリックするか、Ctrl+スペースを入力します。

そして、ヘルプペインには、項目の構文やパラメータ、戻り値などの情報が表示されます。

ラジオボタン、チェックボックス、ドロップダウンメニューなどのアイテムでは、ヘルプペインにコードリストの値に関する情報が表示されます。

ヒント! 利用可能なすべてのアイテムのリストを表示するには、Ctrl+スペースを入力するか、入力を開始してください。

エラーのハイライト表示

コードにエラーがある場合は赤い下線が表示されます。その上にカーソルを置くと、エラーの詳細を確認することが出来ます。

青文字のPeekProblemをクリックするか、Alt+F8を入力すると、エラー情報がエディタ・ウィンドウにインラインで表示されます。エラー修正の提案を見たい場合はQuickFixをクリックします。

注意！ JavaScriptの式エディタでは、ごくまれに式に誤ったフラグが立てられてしまう場合があります。しかし、変更内容を保存する際に実行される検証では、式が正しく検証されます。詳細については、下記サポートされていない式の種類を参照してください。

e ラーニングへのリンク

Viedocが提供するアイテムや機能については、ヘルプペインに、特定のアイテムや機能についての詳細な情報が掲載されているeラーニングのセクションへのリンクが表示されます。

サポートされていない式の種類

以下のタイプの式は、JavaScript式エディタではサポートされていませんが、これらの式は有効であり、変更を保存すると試験デザインが正しく検証されます。

• アクティビティ名を使用したクロスフォーム変数の参照　例　[$ActivityDefId]
• インデクサーによるクロスフォーム変数の参照　例　$FIRST[index]

ブール演算式

ブール演算は true または false を返す式で、表示制御やバリデーションで使用されます。

• true -以下の様な実際の値を持つ場合はtrueになります。
  • 100
  • "Hello"
  • "false"
  • 7 + 1 + 3.14
  • 5 < 6
• false - 以下の様な値を持たない場合は全てfalseになります。
  • 0
  • Undefined
  • null
  • ""

例えば、体重が男性('M')で>65、女性で>45であることを確認するためのバリデーション表現。性別(ItemID=GENDER)はスクリーニングイベント(EventID=SCR)の患者情報フォーム(FormID=PI)に収集され、体重(ItemID=WEIGHT)はビジット毎にDemographicsフォームに収集されます。以下はWEIGHTの項目に書かれたエディットチェックです。

if (SCR.PI.GENDER == 'M')
return WEIGHT > 65;
else
return WEIGHT > 45;

日付の比較

JavaScriptでの日付はオブジェクトであり、利用可能な比較演算子は以下の通りです。

• >
• >=
• <
• <=

「==」または「！=」を使用する必要がある場合は、NULLをチェックする場合を除いて、下の画像の例のように、文字列に変換して比較します。 NULLをチェックするときは、NULLから別の値への変換中に、その値が変更されてしまう恐れがあるため、変換はしないでください。

2つの日付が同じかどうかの確認

Viedocで2つの日付が同じかどうかを確認するには、以下の関数を使用できます。

function sameDay(d1, d2) {

return d1.getFullYear() === d2.getFullYear() &&

d1.getMonth() === d2.getMonth() &&

d1.getDate() === d2.getDate();

}

return sameDay(Date1, Date2);

ここで、Date1とDate2は、比較対象の日付項目のためにViedocで使用される項目IDです。

最早/最新の日付を見つける

例えば3つの異なる日付のうち、最新の日付を取得するには

if(DATE1 != null && DATE2 != null && DATE3 != null)
{
var latestDate = Math.max(DATE1.valueOf(), DATE2.valueOf(), DATE3.valueOf());
return new Date(latestDate);
}
return null;

同様に最も早い日付を取得するには、Math.max式をMath.minに置き換える必要があります。

if(DATE1 != null && DATE2 != null && DATE3 != null)
{
var earliestDate = Math.min(DATE1.valueOf(), DATE2.valueOf(), DATE3.valueOf());
return new Date(earliestDate );
}
return null;

注意！.valueOf()関数は、プリミティブなデータ型では動作しません。javascriptエディタはこの関数をサポートしていますが、プリミティブなデータ型には使用しないでください。

ファイルのプロパティ

画像に示すように、ファイルデータタイプのメタデータ値には式でアクセスできます。

デフォルト値

デフォルトの値式が実行され、フォームが初期化されたときだけ結果の値が設定されます。

注意! 式やデフォルト値を持つ項目に表示条件が設定されている場合、項目が非表示になるたびにその値がデフォルト値にリセットされます。

Viedocが提供する式

Array.contains 関数

チェックボックス項目（一般的には入れるタイプ）を処理する場合、表示条件およびエディットチェックの評価に特別なJavaScript関数、[].contains(x) が使用されます。

[].contains( x ) は、配列タイプが値を含むかどうかをチェックし、trueまたはfalseとして評価します。

例:

1. チェックボックス項目のオプションの1つが選択されているかテストするには、以下のようの式を記述できます。

ItemID.contains(CodeListValue)

ここで、ItemIDはチェックボックスのIDで、CodeListValueはそのチェックボックスのコードリストオプションのうちの1つのオプションのIDです。

2. 複数選択を許可することが意味をなさない「上記のいずれでもない」オプションがあるかもしれません。その場合は、以下のようなチェックを追加することが考えられます。

if(ItemID.contains(3))
return !ItemID.contains(1) && !ItemID.contains(2)；
else return true;

上記の例では、3が上記の選択肢のどれにも該当しないコードリストで、1と2がリストの他の選択肢のコードリストです。また、感嘆符が使われていますが、これは「NOT」を意味し、「配列にこのコードリストの値が含まれてはならない」という意味です。

3. 特定のイベントやアクティビティにのみ表示したいものがあるかもしれません。イベントやアクティビティのリストを配列として定義し、その配列を評価に使用することができます：

var skipActivities = ['V1A1', 'V2A1', 'V3A1']；

skipActivities.contains(ActivityDefId)；

上記をグループの高度な可視化条件として使用した場合、グループはそのアクティビティ内に存在する場合のみ表示されます。

範囲項目固有の関数とプロパティ

範囲項目は、範囲オブジェクトの文字列表現です。 それぞれの文字列を範囲オブジェクトに、またはその逆に変換するために使用できる関数を以下に説明します。

範囲オブジェクトで利用可能なプロパティは以下の通りです。

*RangeObjectは、後述する最初の2つの関数のアウトプットとして取得することができます。

範囲項目と組み合わせて使用できる関数を以下の表に示します。

Math ライブラリ

ECMAScriptには、計算に使用できるmath objectsが含まれています。

項目設定での関数

Viedocの項目に対して、他の項目や条件に応じて結果を返す関数を書くか、以下の画像のように初期値を割り当てることで、特定の値を代入するための関数を書くことができます。

注意!

• フォーム項目に値を返す関数は、データ型のセクションで指定されたデータ型と一致している必要があります。
• データ型の一致の必要性について述べましたが、一致しない関数を書くことを妨げるものは何もありません。小数点以下の数値や日付オブジェクトをテキストフィールドに返す場合、小数点以下の区切り文字や日付のフォーマットは、それぞれの関数がサーバー側で実行された場合、サーバー側で設定されたフォーマットになることに注意してください。例えば、
  • 改訂版を適用するとき
  • 「自動更新」フォーム
• 関数はViedoc Meのフォームでは利用できません

式のデバッグ

デバッグするには、式の中で以下のいずれかを使用することができます。

• debugger; statement.
• console.log('something');

上記の記述は、Viedoc Clinicでそれぞれのフォームにデータを入力しているときにブラウザの開発者ツールを開いた場合にのみ有効です。

注意!

• デバッグ時には、単一行ステートメントを使用できません。
• ビジット/アクティビティの表示制御式はサーバー上で実行されるため、デバッグはできません。

バリデーション

Viedoc Designerでの変更の保存およびバリデーション中に、式はコンパイラを使用して検証され、ほとんどのエラーが検出されます。 ただし、JavaScriptは動的言語であるため、すべてをバリデーションできるわけではありません。
たとえば、AGE.foo ()はエラーをthrow(スロー)しません。これは、AGEはフォーム内の変数であり、コンパイラはその型を知らないためです。

例/使用例

JavaScriptの使用例については、以下のレッスンを参照してください。

• 患者の年齢を計算する
• 規定イベントに自動カウンターを設定する
• 高度な表示条件を使用する
• 二つの時間変数の差を計算する
• 日付/時刻変数のフォーマットの制御
• 特定のイベントやアクティビティに適用するチェックを設定する
• 日付/時刻変数に日付のみが入力されているかどうかを確認する
• 数値項目の小数以下の桁数について

• Previous
• Next