Considerations When Upgrading OGL from a Previous Release

In PeopleTools 8.62 and later, new definitions are used to implement and configure OGL. You must disable any prior configuration before using these new definitions.

Disabling a Prior Configuration of OGL

To disable a prior configuration of OGL:

  1. In Application Designer, run the PT_OGL_FL_AE Application Engine program to disable OGL on fluid pages. If output to log has been selected, review the log file for this message:

    Oracle Guided Learning has been successfully disabled. (0,0)

  2. In the browser, go to PeopleTools, Portal, Branding, Branding System Options.

  3. If the default branding theme is DEFAULT_THEME_FLUID_OGL, continue with step 3a. Otherwise if you have a custom branding theme and header, skip to step 4.

    1. Change the default theme to DEFAULT_THEME_FLUID.

    2. Check to see if you have any portal-specific overrides. Go to PeopleTools, Portal, Branding, Assign Branding Themes.

    3. If you are presented with a standard PeopleSoft search page, no portal-specific overrides are in effect. Skip to step 3h.

    4. Otherwise, modify each portal-specific override:

    5. Change the default theme from DEFAULT_THEME_FLUID_OGL to DEFAULT_THEME_FLUID.

    6. Review and update any user attribute-based theme assignments as appropriate.

    7. Save your changes.

    8. Sign out and sign back in for your changes to take effect. The prior configuration of OGL is now disabled for all classic pages in your system.

  4. Go to PeopleTools, Portal, Branding, Branding Headers and Footers.

    Note: Access to the Branding Headers and Footers component requires the Secure Branding Administrator role.

  5. Open your custom header definition.

  6. Modify the definition of the basic HTML element that you added to inject OGL JavaScript. For example, the name suggested in the PeopleSoft implementation guidelines is PT_OGL_CL_JS:

    1. Select the branding header element in the tree on the left—for example, select PT_OGL_CL_JS.

    2. Click the Additional Options link in the Element Properties pane on the right.

    3. Update the package name to PT_OGL_HOOK and the class ID to PT_OGL_HOOK.

      Note: The method name remains get_HTML.

      In this example of the Additional Options page, the application class has been updated to PT_OGL_HOOK.

       Additional Options page for OGL configuration

  7. Save the changes to your custom header definition.

  8. Sign out and sign back in for your changes to take effect. The prior configuration of OGL is now disabled for all classic pages in your system.

OGL PeopleCode for Fluid Components with Search

If you manually configured SearchInit events on fluid components with search, you will need to manually update those configurations to use the PT_OGL_HOOK_RC service ID. See Adding OGL PeopleCode for Fluid Components with Search.