25.6 Using Build Options to Control Configuration

Use build options to conditionally include or exclude application components and functionality.

• About Build Options
  Build options enable developers to enable or disable application components and functionality when the application installs or at runtime using the APEX_UTIL.GET_BUILD_OPTION_STATUS and APEX_UTIL.SET_BUILD_OPTION_STATUS APIs.
• Creating and Editing Build Options
  Create or edit existing build options on the Build Options, Create / Edit page.
• Including or Excluding Build Options
  Specify Include to enable a component and include it with the application. Specify Exclude to disable a component and exclude it from the application.
• Copying or Subscribing to Build Options
  Copy build options from the current application or from another application. When copying a build option from another app, you can also subscribe to it.
• Subscribing to Build Options
  Subscribe to build options on the Build Options, Create / Edit page.
• Selecting a Build Option
  Apply build options to a page, component, page control, or shared component in Page Designer.
• Deleting Build Options and Associated Components
  Delete a build option by first removing the associated components and then deleting the build option.
• Viewing Build Option Reports
  Access the Utilization report where build options are utilized in the current application. View the History report to see what modifications have been made to build options in the current application.
• Exporting Build Options or Build Option Status
  Export build option status to toggle build options on or off within another environment.

25.6.1 Copying or Subscribing to Build Options

Copy build options from the current application or from another application. When copying a build option from another app, you can also subscribe to it.

Tip:

Subscriptions enable developers to reuse shared components across several applications in a workspace. To learn more about subscriptions, see Using Shared Component Subscriptions.

To copy or subscribe to build options:

1. Navigate to the Build Options page.
   1. Navigate to the Workspace home page.
   2. Click the App Builder icon.
   3. Select an application.
   4. On the Application home page, click Shared Components.
   5. Under Application Logic, click Build Options.

      The Build Options page appears. Note that the report includes the following columns: Subscribed From, Subscription Status, and Subscribers.

2. To copy a build option within the current application:
   1. Search for the build option and click Copy in the Copy column.

      The Copy Build Option Wizard appears.

   2. New Build Option Name - Enter the name of the build option. This name must be unique within the application.
   3. Click Copy Build Option.
3. To copy a build option from another application:
   1. From the Tasks region, click Copy from another app.
      The Copy Build Option Wizard appears.
   2. Application - Select the application from which you want to copy.
   3. Copy Build Option - Select the build option to copy.
   4. Subscribe - Set this flag to On to subscribe to the build option.
   5. Click Copy Build Option.

25.6.2 Subscribing to Build Options

Subscribe to build options on the Build Options, Create / Edit page.

Subscriptions enable developers to reuse shared components across several applications in a workspace. To learn more about shared component subscriptions, see Using Shared Component Subscriptions.

Tip:

You can also subscribe to a search configuration by copying it and then subscribing. See Copying or Subscribing to Build Options.

To subscribe to a c:

1. Navigate to the Build Options page:
   1. On the Workspace home page, click App Builder.
   2. Select an application.
   3. On the Application home page, click Shared Components.

      The Shared Components page appears.

   4. Under Application Logic, click Build Options.

      The Build Options page appears. Note that the report includes the following columns: Subscribed From, Subscription Status, and Subscribers.

2. Select a build option.
   The Build Options, Create / Edit page appears.
3. To subscribe to an build option:
   1. Find the Subscription region.
   2. Subscription, Subscribe From - Select a master build option to subscribe to and click Apply Changes.

      The subscribed component is automatically refreshed from the selected master.

4. To refresh a subscribed a build option:
   1. Find the Subscription region.
   2. Subscription, Refresh Build Option - If the build option is already subscribed, click Refresh Build Option.
5. To unsubscribe from a subscribed build option:
   1. Find the Subscription region.
   2. Subscription, Unsubscribe - Click Unsubscribe.