タグの値をブラウザ のクライアントキャッシュから取得します。GetVal は返値としてタグの値を返します。タグ名を間違えない限り、返値は必ず有効な値が返ってくることが保障されます。

外部タグでPLC やサーバとの通信に異常がある場合、最後に正常に取得できた値が返ってきます。

通信状態の詳細を知りたい場合には、品質フラグ（GOOD/BAD/UNCERTAIN)を参照します。品質フラグは以下のメソッドを用いて取得できます。

例えば、通信状態により処理を切り替えたい場合などには品質フラグを用いてください。

外部タグの場合、まだ１度も通信が行われていない場合は"N/A"（UNCERTAINが）返ります。

AddTag 直後はまだ一度も通信が行われていないため、数秒間はUNCERTAIN 状態になります。AddTag 後、即座に通信を行わせるには、AddTag の直後にReadRefresh メソッドを呼び出します。

var vVal = this.GetVal("U01.F01.T01");

::IsQualityGood(vVal);        //通信がうまくいっている場合（GOOD)、TRUE
::IsQualityBad(vVal);          //通信が失敗している場合（BAD)、TRUE
::IsQualityUncertain(vVal); //通信が１度も行われていない場合（UNCERTAIN)、TRUE
::GetQuality(vVal);             //"GOOD" or "BAD" or "UNCERTAIN"

GetVal はAddTag でタグの登録を行ったオブジェクトで使用できます。

例１)登録したコントロールのスクリプトでGetVal を呼び出す場合

event OnInitialize()
{
 this.AddTag("$D0");
}

event OnMouseUp(button)
{
 this.Text = this.GetVal("$D0");
}

例２）フォームでタグを登録し、各コントロールからメソッドを呼び出す場合

// フォームのイベント（OnInitialize)
event OnInitialize()
{
 this.AddTag("$D0");
}

// 各コントロールのイベント
event OnMouseUp(button)
{
 this.Text = parent.GetVal("$D0");
}

また以下のように複数のタグ名を文字配列として指定することができます。

複数のタグを指定した場合、返ってくる値も配列になります。以下の例では、a[0]に"$D0"の値、a[1]に"$D1"の値が格納されます。

var a = this.GetVal( c("$D0","$D1","$D2","$D3","$D4") );

なお、サーバ では以下のようにタグを配列タグとして設定できます。例えば、PLC デバイスのD0000 からD9999 を、１つの配列タグとして定義することができます。

配列タグの値をGetVal で取得する場合は、「a = this.GetVal("TAG01");」のようにタグ名は１つのみを指定します。

その場合の返値は配列で返ります。例えば、a[0]にD0000 の値、a[1]にD0001、a[1000]にD1000 の値が格納されます。