15.4 ADD_ERRORプロシージャのシグネチャ2

このプロシージャは、通知にインラインでページ・アイテムのエラーを表示するために使用されるエラー・スタックにエラー・メッセージを追加します。検証または処理時にコールして、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,
    p_page_item_name   IN VARCHAR2);

パラメータ

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

パラメータ	説明
p_message	表示されるエラー・メッセージ
p_additional_info	エラーがエラー・ページに表示される場合に必要なその他のエラー情報。
p_display_location	エラー・メッセージの表示位置を指定します。定数apex_error.c_inline_with field またはapex_error.c_inline_with_field_and_notifを使用します。結果の型に使用される定数および属性を参照してください。
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_message          => 'Invalid Customer ID!',
    p_display_location =>  apex_error.c_inline_with_field_and_notif,
    p_page_item_name   => 'P5_CUSTOMER_ID');