14.5 ADD_ERRORプロシージャのシグネチャ3

このプロシージャは、テキストを共有コンポーネントで定義したとおりに表示するために使用するエラー・スタックにエラー・メッセージを追加します。このエラー・メッセージはすべての表示位置に表示できます。検証または処理時にコールして、1つ以上のエラーをエラー・スタックに追加することができます。

注意:

このプロシージャは、Application Expressアプリケーションが最後の検証または処理を行う前にコールする必要があります。そのようにしないと、apex_error.c_on_error_pageの表示位置が指定されている場合を除いて、エラーは無視されます。

構文

APEX_ERROR.ADD_ERROR (
    p_error_code          in varchar2,
    p0                    in varchar2 default null,
    p1                    in varchar2 default null,
    p2                    in varchar2 default null,
    p3                    in varchar2 default null,
    p4                    in varchar2 default null,
    p5                    in varchar2 default null,
    p6                    in varchar2 default null,
    p7                    in varchar2 default null,
    p8                    in varchar2 default null,
    p9                    in varchar2 default null,
    p_escape_placeholders in boolean  default true,
    p_additional_info     in varchar2 default null,
    p_display_location    in varchar2,
    p_page_item_name      in varchar2 );

パラメータ

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

パラメータ	説明
p_error_code	共有コンポーネントのテキスト・メッセージの名前。
p_additional_info	エラーがエラー・ページに表示される場合に必要なその他のエラー情報。
p0からp9	テキスト・メッセージに定義された%0から%9までのプレースホルダの値。
p_escape_placeholders	TRUEに設定すると、p0からp9で指定された値はsys.htf.escape_scでエスケープされてから、テキスト・メッセージのプレースホルダを置換します。FALSEに設定すると、値はエスケープされません。
p_display_location	エラー・メッセージの表示位置を指定します。p_display_locationに定義された定数を使用します。結果の型に使用される定数および属性を参照してください。
p_page_item_name	apex_error.c_inline_with_fieldまたはapex_error.c_inline_with_field_and_notifが表示位置として使用されている場合に強調表示される、現在のページのページ・アイテム名。

例

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

apex_error.add_error (
    p_error_code       => 'INVALID_CUSTOMER_ID',
    p0                 => l_customer_id,
    p_display_location => apex_error.c_inline_with_field_and_notif,
    p_page_item_name   => 'P5_CUSTOMER_ID' );