25.3 ADD_ERRORプロシージャのシグネチャ1
このプロシージャは、エラー・ページ上でエラーを表示したり、通知にインラインでエラーを表示するために使用されるエラー・スタックにエラー・メッセージを追加します。検証または処理時にコールして、1つ以上のエラーをエラー・スタックに追加することができます。
ノート:
このプロシージャは、Oracle APEXアプリケーションが最後の検証または処理を実行する前にコールする必要があります。そのようにしないと、apex_error.c_on_error_page
の表示位置が指定されている場合を除いて、エラーは無視されます。
構文
APEX_ERROR.ADD_ERROR (
p_message IN VARCHAR2,
p_additional_info IN VARCHAR2 DEFAULT NULL,
p_display_location IN VARCHAR2,
p_ignore_ora_error IN BOOLEAN DEFAULT FALSE );
パラメータ
パラメータ | 説明 |
---|---|
p_message |
表示されるエラー・メッセージ |
p_additional_info |
エラーがエラー・ページに表示される場合に必要なその他のエラー情報。 |
p_display_location |
エラー・メッセージの表示位置を指定します。定数apex_error.c_inline_in_notification またはapex_error.c_on_error_page を使用します。「結果の型に使用される定数および属性」を参照してください。
|
p_ignore_ora_error |
FALSE (デフォルト)の場合、元のエラーをエラー・スタックに保持します。TRUE の場合に、add_error が例外ハンドラからコールされると、例外の原因となった元のエラーをエラー・スタックから削除します。
|
例
この例では、エラー・スタックにカスタム・エラー・メッセージを追加します。エラー・メッセージは通知にインラインで表示されます。この例は、検証または処理の際に使用できます。
apex_error.add_error (
p_message => 'This custom account is not active!',
p_display_location => apex_error.c_inline_in_notification );
親トピック: APEX_ERROR