getItemValueString (NotesXspDocument - JavaScript)

アイテムの値をストリングとして取得します。

構文

getItemValueString(name:string) : string

パラメータ	説明
`name`	アイテムの名前。

戻り値	説明
`string`	アイテムの値。

複数のアイテムの名前が同じ場合、このメソッドは最初のアイテムの値を返します。

アイテムが複数の値を保持している場合、このメソッドは最初の値を返します。

アイテムが存在しない場合は、空のストリングを返します。

アイテムの値が数字または日付の場合は、空のストリングを返します。

このメソッドは、プレーンテキストにレンダリングされたリッチテキストアイテムを返します。書式や埋め込みオブジェクトは失われます。

以下の計算結果フィールドのデータバインディングは、現在の XPage に関連する文書の Subject アイテムの値を返します。

var s = document1.getItemValueString("Subject");
if(s == "") {
	return "Subject is empty or doesn't exist."
} else {
	return s;
}