sysLib.setError() システム関数は、以下の複数の候補となるコンテナーのいずれかとメッセージを関連付けます。
関連する Web ページが表示されたときに、メッセージが表示されます。
検証機能が sysLib.setError() を呼び出した場合、この機能の終了時に Web ページが自動的に再表示されます。
『構文』で示されている関数の 3 つのシグニチャーのうち最初のシグニチャーは、JSF ハンドラーと VGWebTransaction プログラムのいずれでも有効ですが、2 つ目と 3 つ目は JSF ハンドラーでのみ有効です。
複数のメッセージを 1 つのフィールドまたは JSF ハンドラーと関連付けることができます。 JSF ハンドラーが forward ステートメントを実行するか、VGWebTransaction プログラムが transfer ステートメントまたは show ステートメントを実行すると、メッセージは失われます。
JSF ハンドラー の onPostRenderFunction プロパティーで指定される関数では、sysLib.setError() を使用できますが、onPostRenderFunction プロパティーまたは onConstructionFunction プロパティーで指定される関数では使用できません。
sysLib.setError(
fieldInError anyPageVariable in,
msgKey STRING in
[, msgInsert STRING in])
sysLib.setError(
this enumerationThis in,
msgKey STRING in
{, msgInsert STRING in})
sysLib.setError(msgText STRING in)
sysLib.setError が VGWebTransaction プログラムから発行されている場合、fieldInError は、show ステートメントまたは converse ステートメントで指定されている VGUI レコード内か、プログラムの inputUIRecord 内のフィールドです。
Invalid file name {0}
次の例は、メッセージ・ファイル errorMessages_en_US.properties からの項目です。
badname = The name you entered, {0}, is not valid.
userName STRING = getUserName(); // 入力を要求します
rc = validateUserName(userName);
if (rc < 0)
SysLib.setError( SysLib.getMessage( "badname", userName ) );
end
| プラットフォーム | 問題 |
|---|---|
| JavaScript 生成 | 関数 sysLib.setError() はサポートされていません。 |
| JSF ハンドラー | msgTable 型の DataTable でのメッセージの挿入がサポートされています。最初の挿入は {0} です。 |
| Web トランザクション | msgTable 型の DataTable でのメッセージの挿入がサポートされています。最初の挿入は {1} です。 |