11.2.4 Switching Themes

Migrate an application to a new theme by running the Switch Theme Wizard.

• About Switching the Active Theme
  Switching to another theme, assigns all components with assigned templates to corresponding templates in the new theme.
• Switching an Active Theme
  Run the Switch Theme Wizard to migrate an application to a new theme.

11.2.4.1 About Switching the Active Theme

Switching to another theme, assigns all components with assigned templates to corresponding templates in the new theme.

App Builder accomplishes template mapping through the assignment of template class identifiers.

When switching an active theme, remember:

• You can only switch to a theme if the theme exists. For example, before you can switch to a theme available in the repository, you must first create it. See Accessing New Themes.
• If the wizard locates multiple matches (that is, when several templates share the same template type and templates class), the wizard defaults to a template matching type, class, and name. If no match is found, you must select another template with the same type and class.
• If no matching template is found (that is, no template with the same type and class exists) then you are prompted to select a template with the same type but with a different class. Then, a warning displays explaining this issue might lead to problems with page functionality, or issues with the page display. When no template of the same template type exists, then the theme cannot be switched. You are blocked from switching themes.

11.2.4.2 Switching an Active Theme

Run the Switch Theme Wizard to migrate an application to a new theme.

To complete this procedure, you must have at least two themes installed. If you do not have at least two themes installed, on the Themes page click Create Theme. You can create a theme from scratch or simply select an existing theme from the repository. See Accessing New Themes.

Tip:

Before starting this procedure, Oracle recommends creating back up your application by either exporting the application or creating a copy.

To switch an active theme:

1. Navigate to the Themes page:
   1. On the Workspace home page, click the App Builder icon.
   2. Select an application.
   3. Click Shared Components.
   4. Under User Interface, select Themes.
   The Themes page appears. A check mark in the Is Current column indicates which theme is selected.
2. Click Switch Theme.
   The Switch Theme page appears.
3. For Identify Theme:
   1. Currently Active Theme - Select the current theme for the application. A theme identifies a collection of templates which define the look and feel of the application.
   2. Switch to Theme - Select the new theme for the application.
   3. Click Next.
   The Verify Compatibility page appears.
4. Review the Status column to identify problematic mappings:
   • A check indicates the mapping was successful.
   • A warning indicates there are more than one template in the theme you are switching to with the identified class. The warning provides a select list from which to choose the appropriate template.
   • An error indicates that App Builder was unable to map the class among the themes. Ensure that a class is identified for the templates in both themes.

   Note:

   Failure to resolve warnings may result in a loss of functionality and applications that do not display well.

5. Click Next to continue.
6. Click Switch Theme.

See Also:

• Refreshing the Universal Theme

• Exporting an Application
• Copying an Application