23.4 ADD_ERROR Procedure Signature 2
This procedure adds an error message to the error stack that is used to display an error for a page item inline in a notification. It can be called in a validation or process to add one or more errors to the error stack.
Note:
This procedure must be called before the APEX application has performed the last validation or process. Otherwise, the error is ignored if it does not have a display location ofapex_error.c_on_error_page
.
Syntax
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);
Parameters
Table 23-2 ADD_ERROR Parameters
Parameters | Description |
---|---|
p_message |
Displayed error message. |
p_additional_info |
Additional error information needed if the error is displayed on the error page. |
p_display_location |
Specifies where the error message is displayed. Use the constant apex_error.c_inline_with field or apex_error.c_inline_with_field_and_notif . See Constants and Attributes Used for Result Types.
|
p_page_item_name |
Name of the page item on the current page that is highlighted if apex_error.c_inline_with_field or apex_error.c_inline_with_field_and_notif are used as the display location.
|
Example
This example illustrates how to add a custom error message to the error stack. The P5_CUSTOMER_ID item is highlighted on the page. The error message is displayed inline in a notification. This example can be used in a validation or process.
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');
Parent topic: APEX_ERROR