sysLib.setErrorForComponentID() システム関数は、JSF ハンドラー内のフィールドとメッセージを関連付けます。
この関連付けは、Web ページのコンポーネントの ID に基づいて行われます。 JSF ハンドラーがこの関数を呼び出す場合、メッセージは、JSP の message または messages タグの位置に配置されます。
関連する Web ページが表示されたときに、メッセージが表示されます。 この関数は検証ルーチンの一部として使用するか、通知メッセージ用に使用することができます。
検証機能が sysLib.setErrorForComponentID() を呼び出した場合、この機能の終了時に Web ページが自動的に再表示されます。
複数のメッセージを 1 つのコンポーネントに関連付けることができます。 JSF ハンドラーが forward ステートメントを実行すると、メッセージは失われます。
sysLib.setErrorForComponentID(
componentID STRING in,
msgKey STRING in
[, msgInserts STRING in])
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.setErrorForComponentID( "form1:CustName",
SysLib.getMessage( "badname", [ userName ] ) );
end
| プラットフォーム | 問題 |
|---|---|
| COBOL 生成 | setErrorForComponentID() 関数はサポートされません。 |
| JavaScript 生成 | setErrorForComponentID() 関数はサポートされません。 |