14.3 ADD_ERRORプロシージャのシグネチャ1

このプロシージャは、エラー・ページ上でエラーを表示したり、通知にインラインでエラーを表示するために使用されるエラー・スタックにエラー・メッセージを追加します。検証または処理時にコールして、1つ以上のエラーをエラー・スタックに追加することができます。

注意:

このプロシージャは、Application Expressアプリケーションが最後の検証または処理を行う前にコールする必要があります。そのようにしないと、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 );

パラメータ

表14-1 ADD_ERRORプロシージャのシグネチャ1のパラメータ

パラメータ 説明

p_message

表示されるエラー・メッセージ

p_additional_info

エラーがエラー・ページに表示される場合に必要なその他のエラー情報。

p_display_location

エラー・メッセージの表示位置を指定します。定数apex_error.c_inline_in_notificationまたはapex_error.c_on_error_pageを使用します。結果の型に使用される定数および属性を参照してください。

この例では、エラー・スタックにカスタム・エラー・メッセージを追加する方法を示しています。エラー・メッセージは通知にインラインで表示されます。この例は、検証または処理の際に使用できます。

apex_error.add_error (
    p_message          => 'This custom account is not active!',
    p_display_location => apex_error.c_inline_in_notification );