This section describes how to edit page attributes in Component View. Common page attributes you may want to edit include the page name or title, header and footer text, and the selected authorization scheme.
To edit page attributes:
View the page in Component View. See "Viewing Page Attributes in Component View."
Under Page, click the Edit icon.
The Page Attributes page appears. Required values are marked with a red asterisk (*).
Edit the appropriate attributes.
The Page Attribute page is divided into sections.
You can access these sections by scrolling down the page, or by clicking navigation buttons at the top of the page. When you select a button at the top of the page, the selected section appears and all other sections are temporarily hidden. To view all sections of the page, click Show All.
To save your changes, click Apply Changes.
This section describes the regions on the Page Attributes page.
Table 9-4 describes general attributes for the current page such as a page name, an optional alphanumeric alias, and associated page groups.
Table 9-4 Page Attributes: Name
| Attributes | Description |
|---|---|
|
Identifies the name of the current page for application developers. This name is used in numerous pages and reports, along with the page number and page title. |
|
|
Enter an alphanumeric alias for this page. This alias must be unique within the current application. For example, if you were working on page 1 of application 100, you could create an alias called f?p=100:home |
|
|
Identify the page group you would like to associate with this page. Page groups do not affect functionality, but help developers manage the pages within an application. To remove a page from a group, select No Group Assigned and click Apply Changes. See Also: "Creating Page Groups" |
Table 9-5 describes general display attributes for the current page such as the selected page template, standard tab set, title, and cursor focus.
Table 9-5 Page Attributes: Display Attributes
| Attributes | Descriptions |
|---|---|
|
Enter a title to display in the title bar of the browser window. The Application Express engine uses the title you specify here in place of the #TITLE# substitution string used in the page template. This title is inserted between the HTML tags <TITLE> and </TITLE>. |
|
|
Select a page mode. Options include:
See Also: "Creating Dialog Pages" |
|
|
Template options enable you to select a number of CSS customization settings to be applied to the current page template. Template options and their corresponding CSS classes are defined at the page template-level. To learn more about an attribute, see field-level Help. See Also: "Editing Themes" |
|
|
Enter additional CSS classes as space a delimited list which are substituted if the page template contains the substitution string #PAGE_CSS_CLASSES#. See Also: "Editing Themes" |
|
|
Specify the cursor focus. Available options include: |
|
|
Enter the Internet Media Type. An Internet Media Type is two-part identifier for file formats on the Internet. A Media Type is composed of at least two parts: a type, a subtype, and one or more optional parameters. This Media Type is used in the Content-Type HTTP header when rendering the page. The page-level Media type overrides the application-level media type. The default value for this attribute is |
Table 9-6 describes attributes that enable you to include JavaScript on the current page.
Table 9-6 JavaScript Attributes
| Attribute | Description |
|---|---|
|
Enter JavaScript file URLs for code to be loaded on this page. Each URL has to be written into a new line. If you provide a minified version of your file you can use the substitution string To view examples, see field-level Help. |
|
|
Enter JavaScript code (for example, functions or global variable declarations) for code to be used on this page. If the code is used on multiple pages, consider putting it into an external JavaScript file to avoid duplication. Code you enter here replaces the Note: Do not to include opening or closing script tags. Just include the JavaScript code. To reference a shortcut, use: "SHORTCUTNAME" |
|
|
Enter JavaScript code to execute when the page loads. The code is executed after the JavaScript code generated by Oracle Application Express. Code you enter here replaces the Note: Do not to add any opening or closing script tags, just the JavaScript code. |
Table 9-7 describes attributes that enable you to include Cascading Style Sheet (CSS) files on the current page.
| Attribute | Description |
|---|---|
|
Enter Cascading Style Sheet file URLs to be loaded on this page. Each URL has to be written into a new line. If you provide a minified version of your file you can use the substitution string File URLs you enter here replace the Note: You do not need to include opening or closing link tags. Just include the file URL To view examples, see field-level Help. |
|
|
Enter Cascading Style Sheet code to be used on this page. If the code is used on multiple pages, consider putting it into an external file to avoid duplication and to leverage browser caching of static files. Code you enter here replaces the Note: Do not include opening or closing style tags. Just include the cascading style sheet code. To view examples, see field-level Help. |
Table 9-8 describes attributes for defining a page which displays as a dialog. These attributes only apply when the Page Mode is set to Modal Dialog or Non-Modal Dialog.
Tip:
These attributes overwrite similar settings defined at the page template-level. See "Dialog".Table 9-8 Page Attributes: Dialog
| Attribute | Description |
|---|---|
|
Enter the width of the dialog, in pixels or a percentage. This setting overwrites the default dialog width specified at page template-level. For a page using a Desktop user interface, the value should be set in pixels, for example, 500. For a page using the jQuery Mobile Smartphone user interface, the value should be set in percent, for example, 80%. The substitution string |
|
|
Enter the height of the dialog in pixels, for example, 500. The substitution string |
|
|
Enter the maximum width of the dialog, in pixels. This setting will overwrite the default dialog maximum width specified at page template-level. For a page using the jQuery Mobile Smartphone user interface, the maximum width is 500.The substitution string |
|
|
Dialog support in Oracle Application Express varies depending on the page user interface: Desktop user interfaces use a jQuery UI dialog and Mobile user interface uses the jQuery Mobile dialog widget. Oracle Application Express supports the following subset of dialog attributes: height, width, and maximum width. The substitution string To learn more, see field-level Help. |
|
|
Enter additional CSS classes you wish to be applied to the dialog, as a space delimited list. For example: ui-dialog--wizard Any occurrence of the substitution string |
|
|
Select Yes if this dialog is opened by another dialog, and should reuse the same dialog window. For example, if this dialog is part of a multiple page dialog wizard, and you wish to reuse the dialog window for each step of the wizard. Select No if this dialog is opened by another dialog, and should be opened in a new dialog window. For example, when this dialog is modal, and you wish to open it within a parent modal dialog window. |
Table 9-9 describes attributes for defining the page header and page HTML body text.
Table 9-9 HTML Header Attributes
| Attribute | Description |
|---|---|
|
Enter text to replace the Note: JavaScript code or Cascading Style Sheets should be added to the dedicated JavaScript and CSS attributes. |
|
|
Enter text to be substituted in for your page template's |
Table 9-10 describes attributes for defining the header and footer text.
Select a condition type from the list that must be met in order for this page to render page items as a read-only. Not selecting a condition causes the page items to render normally. The read only condition is evaluated after executing the processes with a processing point of Before Header.
Tip:
If you want some page items (for example a search field) or all page items of a specific region to always render as enterable page items independent of how this condition evaluates, then set the Read Only condition of those regions or page items to Never.Table 9-11 describes attributes for defining authorization scheme and authentication requirements for the current page.
Table 9-11 Page Attributes: Security
| Attribute | Description |
|---|---|
|
Select an authorization scheme to be applied to the page. Authorization schemes are defined at the application-level and can be applied to many elements within the application. An authorization scheme is evaluated either once for each application session (at session creation), or once for each page view. If the selected authorization scheme evaluates to true, then the page displays and is subject to other defined conditions. If it evaluates to false, then the page does display and an error message displays. |
|
|
Specifies whether this page has been defined as public or requires authentication. If a page is identified as public, the page can be viewed before authentication. This attribute only applies to applications requiring authentication. The application's page sentry function can access this page attribute to identify pages that do not require prior authentication to view. The implementation of the authentication scheme's page sentry function determines if this attribute has any effect. See Also: "Establishing User Identity Through Authentication" |
|
|
Use this attribute to enable or prevent deep linking to an application page. Options include:
See Also: "Authentication" |
|
|
Page Access Protection |
Note: This attribute only displays if Session State Protection has been enabled for the application. See "Understanding Session State Protection." Select a Page Access Protection level for the current page:
|
|
Setting this attribute to On has no effect on the page. Setting this value to Off generates the following HTML in the FORM tag: autocomplete="off" |
|
|
Note: This feature requires a modern browser that support the HTTP header response variable Options include:
From a security perspective and as a best practice, Oracle recommends the browser cache should be disabled. This prevents the browser from storing sensitive data and ensures the browser always request pages if the URL changes. Otherwise, it may even be possible to go back in the browser history after a logout and see cached content of the former session. |
|
|
The Rejoin Sessions attribute controls if Application Express should support application URLs that do not contain session IDs. When rejoin sessions is enabled, Application Express attempts to use the session cookie to join an existing session, when a URL does not contain a session ID. A more restrictive instance-level setting overrides this page level value. Warning: Enabling rejoin sessions may expose your application to possible security breaches, as it can enable attackers to take over existing end user sessions. To learn more, see "About Rejoin Sessions." From Rejoin Sessions, select an option:
See Also: "Browser Security," "About Rejoin Sessions," and "Configuring Rejoin Sessions" in Oracle Application Express Administration Guide |
Use the Allow duplicate page submissions list to specify whether users may process a page multiple times in a row. Set this attribute to No to prevent duplicate page submissions from being processed multiple times.
Examples of duplicate page submissions include:
A user clicks the Submit button multiple times.
You create a branch of type Branch to Page, and the user clicks the browser reload button.
In On duplicate page submissions go to this URL, enter a URL. Use this field if you set Allow duplicate page submissions to No. If you select No and a user attempts to submit the same page twice, Oracle Application Express displays an error message and a link to the URL you specify.]
Table 9-12 describes attributes to enable caching for the current page.
Table 9-12 Page Attributes: Server Cache
| Attribute | Description |
|---|---|
|
Specify whether or not to enable page caching. Page caching can improve performance because the page displays from cache instead of displaying dynamically. Options include:
|
|
|
Displays if you select you select Enabled or Cached by User. Specify the amount of time for which a cached page remains valid. |
|
|
Specify a condition. If the condition returns true, the page is displayed from cache. If the condition returns false, the page is rendered dynamically and is not retrieved from cache. |
|
|
Displays conditionally based on the selected Cache Page Condition. Enter values in this attribute based on the specific condition type selected. |
|
|
Displays conditionally based on the selected Cache Page Condition. Enter values in this attribute based on the specific condition type selected. |
See Also:
"Managing Cached Regions and Pages" in Oracle Application Express Administration Guide and "Utilizing Region Caching in Component View"Select a build option for this page. You can use build options to enable or disable functionality. Most application attributes have a build option attribute. Do not specify a build option for the current page unless you plan to exclude the page in certain configurations.
Build options have two possible values: INCLUDE and EXCLUDE. If you specify an attribute as being included, then the Application Express engine considers it part of the application definition at runtime. Conversely, if you specify an attribute as being excluded, then the Application Express engine treats it as if it did not exist.
Table 9-13 describes attributes used to control or modify how an application logs errors.
In-line Error Notification Text, enter the error text that displays in the #NOTIFICATION_MESSAGE# template substitution string in the event an error occurs on the page.
Table 9-13 Page Attributes: Error Handling
| Attribute | Description |
|---|---|
|
Enter the error text that displays in the |
|
|
Enter the name of a PL/SQL error function to modify the existing error message and display location or log the error if one occurs. This function can reference a package function or standalone function in the database. For example: log_apex_error When referencing a database PL/SQL package or standalone function, use the #OWNER#.log_apex_error You must implement error handling functions using the syntax described in the
function <name of function> (
p_error in apex_error.t_error )
return apex_error.t_error_result
See Also: Note: Error handling specified at the page-level overwrites any error handling function specified at the application-level. See "Editing the Application Attributes." |
See Also:
"Page Templates"Use this attribute to enter Help text for the current page. Help text is displayed using a help system that you must develop.
You can include JavaScript into your application by adding it to the JavaScript attribute of the page. This is a good approach for functions that are very specific to a page and a convenient way to test a function before you include it in the .js file.
In the following example, adding the code would make the test function accessible from anywhere on the current page.
To add JavaScript code to the JavaScript attribute:
View the page in Component View. See "Viewing a Page in Component View."
Under Page, click the Edit All icon.
Under JavaScript, enter code into the following attributes:
Tip:
To learn more about an attribute, see field-level Help. See "Viewing Field-Level Help."File URLs - Enter JavaScript file URLs for code to be loaded on this page. Each URL has to be written into a new line. If you provide a minified version of your file you can use the substitution string #MIN# to include .min or #MIN_DIRECTORY# to include minified/ in your file URL for a regular page view and an empty string if the page is viewed in debug mode. You also have access to the substitution string #APP_VERSION# if you want to include the application's version in the file URL.
Function and Global Variable Declaration - Enter JavaScript code (for example, functions or global variable declarations) for code to be used on this page. If the code is used on multiple pages, consider putting it into an external JavaScript file to avoid duplication.
Execute When Page Loads - Enter JavaScript code to execute when the page loads. The code is executed after the JavaScript code generated by Oracle Application Express.
For example, adding the following would test a function accessible from anywhere on the current page.
function test(){
alert('This is a test.');
}
Click Apply Changes.
The Rejoin Sessions attribute controls support for joining existing sessions (similar to deep linking). Technically, this attribute determines whether URLs to this application contain session IDs.
Warning:
Enabling rejoin sessions may expose your application to possible security breaches, as it can enable attackers to take over existing end user sessions. To learn more, see "About Rejoin Sessions."To use Rejoin Sessions, administrators must enable Rejoin Sessions at the instance-level. A more restrictive value of Rejoin Sessions at the instance-level overrides application and page settings.
To configure Rejoin Sessions in Component View:
View the page in Component View. See "Viewing a Page in Component View."
Under Page, click the Edit All icon.
Scroll down to Security.
From Rejoin Sessions, select an option:
Disabled - All URLs must contain session IDs.
Enabled for Public Sessions - URLs to public pages do not have to contain session IDs if the user has not logged in yet.
Enabled for All Sessions - URLs do not have to contain session IDs if they are checksum protected or if they do not contain payload (a request parameter, clear cache or item data). This setting also requires that the application's Embed In Frames attribute is set to Allow from same origin or to Deny.
Click Apply Changes.
Tip:
Creating a dialog page is a multiple step process. To learn more, see "Creating Dialog Pages."To configure Dialog attributes in Component View:
View the page in Component View. See "Viewing a Page in Component View."
Under Page, click the Edit All icon.
Under Display Attributes, verify the Page Mode is set to either Modal or Non-Modal. See field-level Help for more information.
Scroll down to Dialog.
Under Dialog. and configure the attributes described in Table 9-14.
Table 9-14 Page Attributes: Dialog
| Attribute | Description |
|---|---|
|
Enter the width of the dialog, in pixels or a percentage. This setting overwrites the default dialog width specified at page template-level. For a page using a Desktop user interface, the value should be set in pixels, for example, 500. For a page using the jQuery Mobile Smartphone user interface, the value should be set in percent, for example, 80%. The substitution string |
|
|
Enter the height of the dialog in pixels, for example, 500. The substitution string |
|
|
Enter the maximum width of the dialog, in pixels. This setting will overwrite the default dialog maximum width specified at page template-level. For a page using the jQuery Mobile Smartphone user interface, the maximum width is 500.The substitution string |
|
|
Dialog support in Oracle Application Express varies depending on the page user interface: Desktop user interfaces use a jQuery UI dialog and Mobile user interface uses the jQuery Mobile dialog widget. Oracle Application Express supports the following subset of dialog attributes: height, width, and maximum width. The substitution string To learn more about an attribute, see field-level Help. |
|
|
CSS Classes |
Enter additional CSS classes you wish to be applied to the dialog, as a space delimited list. For example: ui-dialog--wizard Any occurrence of the substitution string |
|
Select Yes if this dialog is opened by another dialog, and should reuse the same dialog window. For example, if this dialog is part of a multiple page dialog wizard, and you wish to reuse the dialog window for each step of the wizard. Select No if this dialog is opened by another dialog, and should be opened in a new dialog window. For example, when this dialog is modal, and you wish to open it within a parent modal dialog window. |
Click Apply Changes.
See Also:
"Creating Dialog Pages"