プライマリ・コンテンツに移動

Oracle® Application Express APIリファレンス リリース5.1 E85937-02 |
| 目次 | 索引

前 | 次 |

# 10.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 );

パラメータ

表10-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' );