Build options enable you to conditionally display specific functionality within an application.
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.
Topics:
See Also:
GET_BUILD_OPTION_STATUS
and SET_BUILD_OPTION_STATUS
procedures in "APEX_UTIL" in Oracle Application Express API Reference
You create a build option for an application on the Build Options page.
To create a build option:
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.
To include or exclude a build option:
Once you create a build option, you can select it for a page, a component (report, chart, or form), a specific page control (button, item, list of value), and another shared component (breadcrumb, list, or tab). You apply build options to a page, component, page control, or shared component by navigating to the appropriate attributes page. Most attributes pages contain a Configuration section where you can select defined build options.
You can export build options or build option status on the Component Export page. Exporting build option status is an effective way to toggle build options on or off within another environment. For example, you can use this feature to deploy a production application with a hidden feature by associating the components of the hidden feature with a build option having the status of EXCLUDE
. After deployment, you can enable the hidden feature by changing the status of the build option to INCLUDE
and then exporting the Build Option Status.
Once you apply the Build Options Status to the production instance, the new feature appears.
To export build options or build option status:
Once you create a build option, a Utilization tab appears on the Build Options page. This report details build option utilization in the current application.
Note:
The Utilization tab only appears on the Build Options page after you create a build option.
To view the Build Option Utilization report: