16.6 Managing Component Settings

Use Component Settings to set application level values for built-in Application Express components and installed plug-ins.

Tip:

The Component Settings in your environment will vary based on the currently selected application.

• Configuring Component Settings
  Developers can configure Component Settings to set application level values for built-in Application Express components and installed plug-ins.
• Integrating with Google Calendar
  Developers can enable calendars within an application to integrate with Google calendar data by configuring the Component Settings, Calendar.
• Configuring Check Box
  Configure application-level component settings defined in Shared Components, Component Settings, Checkbox.
• Configuring Date Picker
  Configure application-level component settings defined in Shared Components, Component Settings, Date Picker.
• Configuring Color Picker Display
  Configure application-level component settings defined in Shared Components, Component Settings, Color Picker.
• Configuring Interactive Report Action Menu Structure
  Configure application-level component settings defined in Shared Components, Component Settings Interactive Report to use the new Action Menu or keep the legacy structure from earlier releases.
• Dynamically Adding Sliders to Regions
  Configure application-level component settings defined in Shared Components, Component Settings, Region Display Selector to dynamically add a slider to the region if the displayed region name exceeds the width of the region.
• Configuring Rich Text Editor Responsiveness
  Determine whether the Rich Text Editor automatically adjusts to the width of the container region by configuring application-level component settings defined in Shared Components, Component Settings, Rich Text Editor.
• Configuring Star Rating
  Configure application-level component settings defined in Shared Components, Component Settings, Star Rating.
• Configuring Switch Defaults
  Configure application-level component settings defined in Shared Components, Component Settings, Switch to determine the default display style for the Switch item type.
• Viewing the Component Settings History Report
  You can view a report of modifications made to Oracle Application Express components and installed plug-ins on the Component Settings History page.

16.6.1 Configuring Component Settings

Developers can configure Component Settings to set application level values for built-in Application Express components and installed plug-ins.

To configure Component Settings:

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 Other Components, click Component Settings.
5. Click the component name.
6. In the Component Settings configure the appropriate settings and click Apply Changes.

   Tip:

   To learn more about a specific setting, see item Help.

16.6.2 Integrating with Google Calendar

Developers can enable calendars within an application to integrate with Google calendar data by configuring the Component Settings, Calendar.

Note:

The Google Calendar API Key [Deprecated] attribute described in this topic only applies to calendars based on the FullCalendar v3 library. Calendars based on FullCalendar v3 have been deprecated and will be desupported in a future release. New calendars created in App Builder are based on the FullCalendar v5 library.

To configure the Component Settings, Calendar:

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 Other Components, click Component Settings.
5. Click the component name, Calendar.
6. In the Component Settings dialog:

   1. Google Calendar API Key [Deprecated] - Enter the Google Calendar API key to enable calendars within this application to integrate with Google calendar data.

   2. Click Apply Changes.

16.6.3 Configuring Check Box

Configure application-level component settings defined in Shared Components, Component Settings, Checkbox.

To configure Check Box application-level component settings:

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 Other Components, click Component Settings and then CheckBox.
5. In the Component Settings dialog:

   1. Checked Value - Enter the value stored in the page item if the end user checks the checkbox. The value can be up to 255 characters long.

   2. Unchecked Value - Enter the value stored in the page item if the user unchecks the checkbox. This attribute can also be left blank if you want to store NULL when checked. The value can be up to 255 characters long.

   3. Click Apply Changes.

16.6.4 Configuring Date Picker

Configure application-level component settings defined in Shared Components, Component Settings, Date Picker.

To configure Date Picker application-level component settings:

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 Other Components, click Component Settings and then Date Picker.
5. In the Component Settings dialog:

   1. Appearance - Control the appearance of the calendar used to select dates. Options include Show Week, Month Picker, and Year Picker.

      This option is only used when Display As is set either Popup or Inline.

   2. Days Outside Month - Dictates the behavior of days outside the current viewing month. Options include Hidden, Selectable, and Visible.

      This option is only used when Display As is set either Popup or Inline.

   3. Time Increment - Time increment in minutes used by the time selection control. This attribute is used for selecting the time of increments that can still be manually entered and saved.

      This option is only used when Display As is set to either Popup or Inline.

   4. Click Apply Changes.

16.6.5 Configuring Color Picker Display

Configure application-level component settings defined in Shared Components, Component Settings, Color Picker.

To configure Color Picker application-level component settings:

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 Other Components, click Component Settings.
5. Click the component name, Color Picker.
6. In the Component Settings dialog:

   1. Display As - Select how the color picker displays. Options include Popup, Inline, Color-only Popup, and Native Color Picker.

   2. Mode - Select the amount of information shown in the color picker. Options include Simple or Full.

   3. Click Apply Changes.

16.6.6 Configuring Interactive Report Action Menu Structure

Configure application-level component settings defined in Shared Components, Component Settings Interactive Report to use the new Action Menu or keep the legacy structure from earlier releases.

The structure of the interactive report Actions menu has changed to be consistent with interactive grids.

To configure Interactive Report application-level component settings:

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 Other Components, click Component Settings and then Interactive Report.
5. Click the component name, Interactive Report.
6. In the Component Settings dialog:

   1. Actions Menu Structure - Specify how the Actions menu displays in interactive reports. Options include:

      • Interactive Grid - Select Interactive Grid to have the interactive report Actions menu match interactive grid.

      • Legacy - Select Legacy to have the interactive report Actions menu use the legacy structure.

   2. Click Apply Changes.

16.6.7 Dynamically Adding Sliders to Regions

Configure application-level component settings defined in Shared Components, Component Settings, Region Display Selector to dynamically add a slider to the region if the displayed region name exceeds the width of the region.

To configure Region Display Selector application-level component settings:

1. Navigate to the Shared Components 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.
2. Under Other Components, click Component Settings and then Region Display Selector.
3. In the Component Settings dialog:

   1. Include Slider - Select Yes to dynamically add a slider to the region if the displayed region name exceeds the width of the region.

   2. Click Apply Changes.

16.6.8 Configuring Rich Text Editor Responsiveness

Determine whether the Rich Text Editor automatically adjusts to the width of the container region by configuring application-level component settings defined in Shared Components, Component Settings, Rich Text Editor.

For new apps, this setting is enabled by default. For older apps (pre-18.1), this is disabled by default.

This setting requires a responsive application theme (such as Universal Theme).

To configure Rich Text Editor application-level component settings:

1. Navigate to the Shared Components 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.

2. Under Other Components, click Component Settings and then Rich Text Editor.
3. In the Component Settings dialog:
   1. Responsive [Deprecated] - Specify whether the Rich Text editor should automatically adjust to the container region size. This requires the Application to use Universal Theme or another responsive theme.

   2. Click Apply Changes.

16.6.9 Configuring Star Rating

Configure application-level component settings defined in Shared Components, Component Settings, Star Rating.

To configure Star Rating application-level component settings:

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 Other Components, click Component Settings and then Star Rating.
5. In the Component Settings dialog:
   1. Default Icon - Choose the default icon to use (such as fa-star, fa,-thumbs-up, or fa-database).
   2. Active Color - Default color for active stars.
   3. Inactive Color - Default color for inactive stars.
   4. Tooltip - The template for the tooltip when end users hover the mouse over the item. This rating value replaces the #VALUE# substitution (for example, the movie rating is #VALUE#).

   5. Click Apply Changes.

16.6.10 Configuring Switch Defaults

Configure application-level component settings defined in Shared Components, Component Settings, Switch to determine the default display style for the Switch item type.

Display options include On/Off switch toggle, pill button, or select list.

To configure Switch application-level component settings:

1. Navigate to the Shared Components 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.

2. Under Other Components, click Component Settings and then Switch.
3. Configure the following Component Settings:
   1. Display Style - Options include:

      • Switch

      • Pill Button

      • Select List

   2. On Value - Enter the value stored in the page item if the end user picks the On option. The value can be up to 255 characters long.
   3. On Label - Enter the text displayed for the On option. If no text is entered, the system default label is used.
   4. Off Value - Enter the value stored in the page item if the user picks the Off option. The value can be up to 255 characters long. This value is used if the page item is populated with a value which does not match either the On Value or Off Value.
   5. Off Label - Enter the text displayed for the Off option. If no text is entered, the system default label is used.
4. Click Apply Changes.

16.6.11 Viewing the Component Settings History Report

You can view a report of modifications made to Oracle Application Express components and installed plug-ins on the Component Settings History page.

To view the Component Settings History report:

1. Navigate to the Shared Components 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.

2. Under Other Components, click Component Settings.
3. Click the History tab.

   The History page displays as an interactive report. To customize the report, use the Search bar at the top of the page.