2 Getting Started

OGL Account Setup

As a customer, you can contact your Oracle Account Manager to request an OGL account. Once your order is processed, Oracle will provision your OGL account, and a Welcome to Oracle Guided Learning email will be sent to the admin/buyer in the order with instructions on how to sign in to OGL and register for a webinar to help your get started with using OGL. You can contact Oracle Support if there is any issue with the account or if you do not receive the provisioning email.

Confirmation Email

Once your OGL account is created, you will receive an invitation email that contains the link to access the OGL console along with instructions on how to sign in using an Oracle Account or your company's Federated Single Sign-On (SSO). Follow the instructions provided in the email to access the OGL console.

Below is an example of the confirmation email:

Confirmation email

Sign In to OGL

Important Note

Beginning in OGL 24A Release, OGL console users must sign in using a Single Sign-On (SSO) provider to authenticate. This means that you must either sign in using an Oracle Account or your company's Federated Single Sign-On (SSO)*.

If you do not have an Oracle Account, you can easily create one. This is the same account that you use to access to other Oracle services, such as Cloud Customer Connect, My Oracle Support, and My Learn. With your Oracle Account, you can conveniently access OGL along with other Oracle services using a single username and password. When creating your Oracle Account, be sure to use the same email address that is associated with your OGL account.

*Federated Single Sign-On (SSO): If you wish to sign in to OGL using your company's Single Sign-On (SSO) provider, you may need to request a one-time configuration to be performed by the OGL Product Team to integrate your company's SSO with OGL. Once configured, you will be able to sign in to OGL using your company's SSO. To request SSO integration with OGL, please contact your Oracle Account Manager or log an OGL support ticket.

Once you have successfully setup your Oracle Account or enabled your company's SSO with OGL, you can access OGL by selecting the START COLLABORATING link located at the bottom of the confirmaltion email.

You will be directed to the OGL Sign-In screen as shown below. (We recommend that you bookmark this URL for future use.)

Sign in using one of the following options:

Option 1:

Select Sign in with Oracle Accountto be directed to the Oracle Account sign-in page and enter your login credentials.

OR

Option 2:

To sign in using your company's SSO (if configured), enter your company name and select Sign in with your SSO provider to be directed to your company's SSO page.

Sign in to Oracle Account

Once you have successfully signed in, yu will be redirected to the OGL Console.

separator

Accessing OGL for the First Time

The OGL Console is a web application used to manage your content library. When you access the OGL Console for the first time, you are prompted to install the Chrome extension required to develop content.

Google Chrome is required for content creation in the OGL Console. Before proceeding, verify your organization's OGL tenancy by referring to the OGL Welcome email received during provisioning or logging a request on My Oracle Support.

Installing the OGL editor extension for Google Chrome

Prerequisites:
  • Google Chrome browser
Instructions:
  1. Go to the Chrome Web Store. The page below opens; select Add to Chrome.


    success

  2. Select Add extension.


    add extension

  3. A confirmation message is displayed once the setup has been completed. You can now visit the OGL Console to start collaborating.


    success

Accessing the OGL Console on Google Chrome

To access the OGL Console:
  1. Go to the OGL console via the unique tenancy designated to you.
  2. On the Sign-in screen, type the username and password.

    sign in

  3. Select Sign In.

    After a successful login, you will be redirected to the OGL console's Homepage.


    dashoboard

Important:

  • CAPTCHA verification will be required after two (2) failed attempts.
  • The account will be locked after three (3) failed attempts.
To log out of OGL Console:

  1. On the OGL console, in the right corner of the header, select the Ellipsis icon (ellip) right after the user email ID. Then select Sign Out.


    page

You are now logged out of the OGL Console.

Oracle Guided Learning SSO Integration

Oracle Guided Learning offers the flexibility of using your organization's SSO to authenticate your OGL Console session. Users still have the option to sign in manually with their OGL Console username and password. If you are interested in SSO, ask your Oracle Guided Learning contact for more information or log a request on My Oracle Support.

SSO

With OGL 23C release, you may need to transition your OGL sign-in process to Single Sign On (SSO) if you have not already done so. Making this transition is easy and will help ensure the highest level of security and privacy of your data. Please read the following information to understand your part in this security enhancement.

Why the change?

To better ensure the security of your data, in alignment with the latest security standards and practices, Oracle Guided Learning is moving to an SSO-only sign-in experience. For OGL users, this means a more simplified and secure sign-in process to access the OGL console.

What is your part in the change?

With 23C release, there are three options to sign in to OGL:

SSO2

  1. Sign in with your OGL account username and password

    This is the current sign-in process, but will be removed in a future release. We strongly recommend that users switch to using Option 2 or 3 below to sign-in to OGL.

  2. Sign in with an Oracle Account

    This is a new option in Release 23C. If you already have an Oracle Account that you are using to access Oracle services such as Customer Connect Forums, Events, and online training via MyLearn, you will now be able to use that same account to sign-in to OGL with no additional setup required. If you don’t currently have an Oracle Account, you can easily create one. An Oracle account is easy to set up and is governed by Oracle’s advanced data security policies.

  3. Sign in using your organization’s Federated Single Sign On (SSO)

    If you are interested in integrating your organization’s SSO with OGL, please contact your network administrator and raise an OGL support ticket to request “SSO integration”. One of our experts will work with your organization’s network administrator to guide the implementation process.

What is the benefit of adopting SSO?

By shifting to an SSO process, your access to Oracle applications and support functions will be simplified and consolidated into one login and password. There will be no impact to your current user management roles and/or entitlement process for new developers, editors and owners.

For more information:

Further information is available in this document. If you have additional questions, please engage with your OGL point-of-contact.

separator

Deploying Oracle Guided Learning for Oracle Cloud Fusion

Overview of the Oracle Guided Learning Integration

Oracle Guided Learning (“OGL”) works as an overlay to your Oracle Cloud Fusion (“Fusion”) environments that understands user behavior in the application and presents the content relevant to their page location and user role.

In this chapter, we will cover the steps required to deploy guided learning, including:

  • Setting up your Oracle Guided Learning (OGL) account so that it gets connected with your Oracle Cloud Fusion environment(s) and then,
  • Configure your Oracle Cloud Fusion environment(s) to display the desired content from your OGL account.

Pre-requisites for Deployment

Before you start configuring the OGL Domain Settings, you must meet the following pre-requisites:

  • OGL Console Permission: Owner > Manage Cloud Configuration
  • Fusion Environment Access: Application Administrator/Implementer
  • Fusion Administrator Profile Value: Guided Learning Enabled

Additional details and procedures for each of these pre-requisites are provided below.

OGL Console Permission: Owner > Manage Cloud Configuration

To access the OGL Cloud Configuration, you must have the owner permission "Manage Cloud Configuration" to edit and manage Cloud Configurations in OGL.

To enable "Manage Cloud Configuration" owner permission:
  1. On the OGL console, go to Settings>User Management.
  2. Among the list of users, find your name and email ID.
  3. Select the Details dropdown menu under the Owner's column on the line that displays your name or email ID.
  4. Select "Manage Cloud Configuration" from the dropdown options.

    user_mgt

    The "Manage Cloud Configuration" owner permission is now enabled for your account.

Note:

If you see the below message when accessing the OGL Settings>Application>Domains tab, ask your OGL administrator to update your user permissions to enable Manage Cloud Configuration.
domain

Fusion Environment Access: Application Administrator/Implementer

To enable OGL on Oracle Fusion Application(s) and to set the OGL Fusion profile value, you should log in to the Oracle Fusion application as a user with the Oracle Fusion Application Administrator/Implementor role. Specifically, you are required to:

  • Create and publish an Oracle Fusion Sandbox; and,
  • Access and update the Configure Guided Learning task page within Setup and Maintenance.

Note:

If you do not have access to perform these actions, please contact your Oracle Fusion Administrator.

Creating and Publishing a Sandbox for OGL Configuration

Once the Profile Value is set, you can create a Sandbox for OGL configuration.

To create a Sandbox and publish:

  1. Select the Navigator icon (nav_icon) > Configuration > Sandboxes.

    screen1
  2. Select Guided Learning under the available tools.

    Guided

    Note:

    If Guided Learning is not available, complete the steps above in Prerequisite: Fusion Administrator Profile Value: Guided Learning Enabled
  3. Select the Create Sandbox button. The Create Sandbox screen is displayed.
  4. On the Create Sandbox screen, enter the Sandbox Name and an optional description.sandbox1

    Note:

    In the absence of an internal naming convention, the following naming convention is recommended, OGL-YYYY-MM-DD-V# (i.e., OGL-2020-10-09-V1)).
  5. Set the Publishable option to Yes.
  6. Select the Create and Enter button.

    image2The Sandbox is now created and published.

Fusion Administrator Profile Value: Guided Learning Enabled

For OGL to be applied to an Oracle Fusion Domain, the best practice is to check the Oracle Fusion Applications Administrator profile value for Guided Learning Enabled (FND_GUIDED_LEARNING_ENABLED) is set to Yes at the site level.

yes

To enable the OGL profile value:
  1. Sign in to your Fusion instance.

    login
  2. Select the Settings and Actions icon (SI_icon) at the top-right corner of your Fusion homepage, then select Setup and Maintenance from the options in the dropdown list.

    settings
  3. Select the Tasks icon (task_icon) on the Setup and Maintenance screen to view the slide menu. Then select Search from the options in the slide menu.

    slide
  4. In the search field, enter "Manage Administrator Profile Values", then select the Search icon (search).
  5. From the search result, select Manage Administrator Profile Values.

    admin

    A new window opens now, where you can manage Administrator Profile Values.
  6. In the Profile Option Code field, enter "FND_GUIDED_LEARNING_ENABLED", then select the Search button.
  7. Under FND_GUIDED_LEARNING_ENABLED: Profile Values, set the Profile Value to Yes.

    Yes
  8. Select the Save and Close button on the top-right corner of the screen.

    The OGL profile value is now enabled.

    Additional information is available via the following links:

    My Learn video: Enabling the OGL Profile Value

Set Up Your OGL Account to Connect to Your Fusion Domains

To set up your OGL Account:
  1. On the OGL console, go to Settings>Application.

    nav

  2. Set the Application Type to Fusion if you are enabling OGL on an Oracle Fusion application.

    application
  3. Select Domains.

    domain
  4. While enabling OGL on an Oracle Fusion Application, the OGL AppId and OGL Server values are required to complete the OGL configuration in the Oracle Fusion application. Use the copybutton to copy AppId and OGL Server valuesto the clipboard and paste it to a text file to use later.

    app id
  5. Select +New Domain.
  6. Enter the desired Domain Name.For example, enter "Fusion Test" if you are adding the Domain for the Oracle Fusion Environment to develop OGL content.

    Fusion
  7. Enter the URL for the Oracle Fusion environment domain.

    Note:

    The URL must be limited to the top-level domain (.com) with no other proceeding characters.

    For example:

    √ https://oracle-fusion-test-saastest.oraclecloud.com

    χ https://oracle-fusion-test-saastest.oraclecloud.com/oa/server/eq.cgi?query%

    add url
  8. Anonymous plus Disabled Specific Domain(s)

    If you want any domain to use the OGL Domains setting EXCEPT for a given domain, you should create an anonymous domain that is enabled and keep the other domain that is disabled. In this situation, the Domains tab would look like this:

    show all guides

    The Environment option refers to the OGL content you want to display in the application:

    • Development (Show All Guides): Displays all Draft, Unpublished Revisions, and Published content. Use this setting for Fusion testing and development environments.
    • Production (Show Only Published Guides): Displays only Published content. Use this setting for Fusion Production environments.

      Note: In this example, we selected Development (Show All Guides).

  9. Review the Settings available, then select Save Domain.

    Save Domain

    The Domain has now been added to your list of Domains. To add additional Domains, repeat the process.
  10. Select Save to save the changes and exit the modal window.

    Save

    Once the Domain is added to the OGL Console, the next step is to navigate to the Oracle Fusion Application

    Keep the AppID and OGL Server values handy, which is required in the upcoming process.

Complete the Configure Guided Learning Task in Fusion

To enable OGL on Oracle Fusion Application(s), login to the Oracle Fusion application as a user with the Oracle Fusion Application Administrator/Implementor role and create a sandbox that includes the Guided Learning tool set.

Note:

In this example, we have already created a Sandbox with the required user login. Click here for details on how to create an Oracle Fusion Application Sandbox.
To configure Oracle Guided Learning
  1. Select the Settings and Actions icon (SI_icon) at the top-right corner of your Fusion homepage, then select Setup and Maintenance from the options in the dropdown list.
  2. Select the Tasks icon (Task) on the Setup and Maintenance screento view the slide menu. Then select Search from the options in the slide menu.
  3. In the search field, enter Configure Guided Learning, then select Search.search
  4. From the search result, select Configure Guided Learning.

    config Guided

    The Configure Guided Learning page is displayed.
  5. Enter the Application ID and the OGL Server URL.

    Note:

    Enter only the OGL Server name as per your console (i.e., do not include "https://" or other characters).
    config page
  6. Select Save and Close.
  7. Select the Sandbox dropdown menu.

    Menu
  8. Select Publish andthen select Yes to publish the OGL settings for the Oracle Fusion application.

    publish

    OGL is now enabled on your Oracle Fusion Application. You can repeat the process for all Oracle Fusion applications that require OGL integration.

Note:

Once these actions are completed, the OGL widget should display on your Home Screen.

The OGL widget looks like this:

widget

If the OGL Widget does not display, please review your organization’s Content Security Policy per the Additional Considerations below, as an additional profile value may be required.

Additional Considerations

The Widget Does Not Display Due to Content Security Policy (CSP)

If the OGL widget is not displayed after you have completed all of the above steps, you may be required to update the Oracle Fusion application Content Security Policy (CSP). You can check for the CSP error using the browser's inspect tool. If the CSP update is required, you will see the below error under the console tab:

CSP

separator

Enabling OGL by Embedding JavaScript

You can use JavaScript to embed OGL in a Fusion application or other web applications.

To embed the JavaScript in a non-Fusion web application, you add the provided JavaScript to all pages in your application where you want to use OGL. Because there are as many different ways to do this as there are web applications, we cannot address specific steps for non-Fusion applications. In general, add the OGL JavaScript to a common part of your application, such as the header or footer area.

Embed OGL JavaScript in Fusion

Creating and Publishing a Sandbox for OGL Configuration

Note:

  • The JavaScript embed profile value should be set to No.
  • Make sure there is no active sandbox.

To create a Sandbox and publish:

  1. Select the Navigator icon (nav_icon), > Configuration > Sandboxes.

    home
  2. Select Page Composer and Page Template Composer under the available tools.

    composer
  3. Select the Create Sandbox button.

    The Create Sandbox screen is displayed.
  4. On the Create Sandbox screen, enter the Sandbox Name and an optional description.

    sandbox

    Note:

    In the absence of an internal naming convention, the following naming convention is recommended, OGL-YYYY-MM-DD-V# (i.e., OGL-2020-10-09-V1)).
  5. Set the Publishable option to Yes.
  6. Select the Create and Enter button.

    sandbox2

    The Sandbox has been created and entered.

Embedding the Script

  1. While still in the sandbox, select the Settings and Actions icon (SI_icon) at the top-right corner of your Fusion homepage. Then Select the Edit Global Page Template from the options in the dropdown list.

    settings_action
  2. Select the Global Page Template label area (highlighted in blue).

    gpt

  3. Select the Add icon(add_icon) in the footer area; you may need to drag the toolbar up expand to bring it into view.

    Now, the Add Content modal window appears.

  4. Select Open, next to Components, and then select Add, next to HTML Markup.

    html_markup

    Select Open, next to Components, and then select Add, next to HTML Markup.

    The HTML Markup settings is now visible.

  5. Select View, then select Design.

    design

    Note:

    If you are unable to select Design, try enabling the Administrator Profile Value in Setup and Maintenace > Manage Administrator Profile Values >FND_PAGE_COMPOSER_SOURCE_VIEW > Set to “Yes”.
  6. Select the Edit icon (edit_icon) of the newly added HTML Markup component.

    html_markup

    The HTML Markup editor is now visible.

  7. Select the Value dropdown, then select Expression Builder.
  8. Replace the contents of the Type a value or expression field with the OGL JavaScript, then select OK.

    exp_editor
  9. Select OK again and select Close.

    The JavaScript embed process is now complete.

  10. Verify that the OGL Widget (widget) is visible. If the widget is not visible, perform the following steps:
    1. Go to the OGL Console, then select Help Panel in the Settings tab.

      menu
    2. Ensure that the Show Launch Widget even if there are no guides to display in Help Panel option is enabled.

      help_panel
    3. Ensure that the Show Launch Widget even if there are no guides to display in Help Panel option is enabled.
    4. Wait 30-60 seconds then refresh your Fusion instance. If the OGL widget is still not displayed reach out to your OGL contact or create a support ticket on My Oracle Support.
  11. When you are ready, publish the sandbox to make your content available to users. To publish the sandbox, follow these steps:
    1. Click the Sandbox Name, then select Publish.
    2. An information dialog box is displayed, select Yes to confirm.
    3. Select Publish.
    4. A warning dialog box is displayed, select Yes to confirm the action.

separator

The OGL Console

The Oracle Guided Learning provides a simple, user-friendly interface that lets you easily navigate the features. The user interface is organized into pages and features that help you accomplish your tasks. Additionally, we have incorporated OGL onto your OGL console (OGL-On-OGL) to help orient you to the user interface and to provide guidance on navigating the console.

The Redwood Theme

Redwood is the name of the approach to our next-generation product and communication design, user experience platform, and brand design system. While it’s not the only manifestation of the changes we’re making, it’s perhaps the most visible. Redwood is at the core of our express goal: getting customers to fall in love with Oracle one interaction at a time. This is just the beginning. Redwood is a living thing, and all of us are going to help it evolve and improve in the coming months and years.

Redwood is the recommended theme for all Oracle Applications. OGL content is best presented in the Redwood theme and is optimized for Oracle Fusion applications that also apply the Redwood theme.

Homepage UI Elements

Let us get familiarized with some of the homepage UI elements.

The OGL Homepage looks like this.

console

No Element Sub Menu/Element Function
1 Account and Apps   Displays the Account Name and the Application Name.
2 User Menu My Profile, Help, Support, Forum, About and Sign Out Displays the Profile Information and Profile Settings. Provides the hyperlink to the OU Support Help, User Guides, and Forums. It also contains the OGL info and options to Sign Out of OGL.
3 OGL Homepage Button   It returns you to the OGL Homepage from the current page you are on.
4 Main Navigation Menu My Content, Library, Analytics & Reports and Learn My Content lists all the existing guides, and Archive shows all archived guides. The Library section consists of Use cases and Base Guides. Analytics & Reports provides an interactive Dashboard and OGL user analysis reports. Finally, the Learn option takes you to the learning center.
5 Homepage Title   The Homepage Title is exclusive to the homepage and indicates that you are on the homepage.
6 Browse Use Cases   Provides quick access to Use Cases from the Use Case Library.
7 Create Beacon, Hotspot, Launcher, Messages, Process, Smart Tip, Survey, Task List and Training This menu lets you create different OGL guides, including Beacon, Hotspot, Launcher, Messages, Process, Smart Tip, Survey, Task List, and Training.
8 Recent   Displays the recently used guides.
9 Explore Guided Learning and Business Process This library provides access to training resources on Guided Learning and Business Processes.
10 Options   Options let you filter the contents you see on the homepage.
11 Help Widget Getting Started, OGL Digital Learning, Documentation and Support The Help Widget in the OGL Console offers a variety of tours, help and support resources, and access to training on how to use the OGL Console effectively.
12 Scroll Button   Scroll right and left between content tiles with the Scroll Buttons.
13 Premium Badging   Premium badges are exclusive to premium accounts. This insignia indicates that your OGL account is a premium account with access to premium features and unlimited guides.

separator

Guide List and Views

The OGL homepage displays the various content categories. By default, it shows the Use Cases, Recent contents, Learning contents, and Learn resources.

Use Cases

Use Cases are curated collections of pre-built guide packages that were designed by Oracle experts and are based on real business scenarios. Use Cases provide guide templates that employ Oracle best practices for various Oracle Fusion applications. Each Use Case may contain one or more guides of various categories, including Message guides, Process guides, Smart Tips, etc.

use case

To see the complete list of Use Cases:

  1. Select View Use Cases.

    View Use Case

The Use Cases screen is displayed.

To switch between the views:

By default, all the Use Cases are displayed in tile view.

Title_view

Use the List View icon (list) and the Tile View icon (tile) to switch between your preferred views.

List

Recent Guides

The section displays guides that you have recently created or edited for quick reference.

recent

Explore

This section contains links to learning resources, including microlearning videos on common OGL tasks as well as Business Process training on Oracle Fusion products that can be viewed or deployed to users.

Explore

OGL Microlearning Guides

To support new console users and developers, OGL now provides a gallery of just-in-time “micro-learning” videos and guides to learn more about basic OGL functionality. These training guides are available in the Learn section in the left navigation pane.

Click the Play button (play) on any of the available training guides to view the training content in a modal.

learn

Business Process Training Guides

OGL has introduced a library of Business Process Training guides to the OGL console that provides access to valuable Fusion product-related training content to enhance Fusion knowledge and adoption. The content for these training guides was curated from the Oracle Could Business Process Student Learning Subscription available on mylearn.oracle.com. Administrators and developers can select from this library of training guides and add to their content

To access these courses, go to the Learn section in the left navigation pane and select the Business Process tab.

bussiness

separator

Searching and Filtering the Guide List

You can reduce the number of guides that you see by searching for a guide or filtering by content item in the left panel.

  1. Searching guides: Enter a search term in the search box to find the guide-by-guide title.
  2. Filtering by content items: Select a content item in the left panel to show only those guides.

To search for a particular guide:

Use the Search Box to search for a particular guide.

Search

To filter the guides:

  1. Select the Filters button.Filter

    The Filters slider menu appears. Use the checkboxes to filter the guides according to your preference.

    filter bar

    To clear the filter, select the Reset button.

    reset

separator

User Management

Once your OGL account is created, you can add new users with different permission levels. The new users can create, publish, delete guides, edit content, view analytics, etc. We recommend you follow the Least Privilege principle when granting permissions to new OGL users, especially the permission to publish guides.

You can set up multiple types of users depending on the level of access you want each user to have. Each user is identified by their name, email address, and the permissions assigned to them.

Introduction to OGL Roles

Before you set up users in OGL, you should understand the roles and permissions that you can assign to a user.

Note:

The roles discussed below only apply to the OGL Console and are not related to the application roles.

Roles & Permissions

Viewer: Executive sponsors are the common target audience for this role which only requires the ability to see what guides exist and view the Analytics Dashboard.

Permission Detail
Preview a guide
  • Preview Guides
View Analytics
  • View Analytics

Editor: The Editor role addresses users who only need to work with the copy/text in the guides and messages to end-users. This allows writers to be able to get into the system and provide content without exposing them to publishing and other mission-critical capabilities.

Permission Detail
Access Content Editor
  • Edit OGL item text via Content Editor
Manage Messages
  • Create, Update, Clone, and Delete Messages

Developer: This role enables admins who should be working with the detailed features within individual guides, while not opening up system-wide settings that would affect all Editors and Developers.

Permission Detail
Edit Guides
  • Update OGL item name(s)
  • View Guide in Full Editor
  • Edit Guide, Video, Links, Tasks Lists via Full Editor
  • Edit Settings for Guide, Video, Links, Tasks Lists in Dashboard
  • Edit Activation Settings for Guide, Video, Links, Tasks Lists in Dashboard
Create Guides
  • Create/clone OGL item(s)
Delete Guides
  • Delete/recover OGL item(s)
Publish Guides
  • Activate/inactivate OGL item(s)
  • Publish/unpublish OGL item(s)
  • Publish unpublished revisions of OGL item(s)
Edit Managed Guides
  • Edit OGL items classified as managed by Oracle University

Owner: Within each organization, there should only be 2-3 people with this level of access. The permissions included in this role enable the admin to make changes to the system that will affect every user and guide therein.

Permission Detail
Manage Users
  • Add/delete users from the appID
  • Assign/revoke user permissions
Manage Help Widget Settings
  • Update the help widget sort order
  • Update the OGL Widget settings for development and production
Manage Display Groups
  • Create, update, and delete display group(s)
Manage Roles
  • Create, update, and delete simplified role(s)
Manage Pages
  • Create, update, and delete OGL pages for use in conditioning content in the library
Manage Products & Modules
  • Create, update, and delete OGL Products and Modules which are used in OGL analytics and as content filters
Manage Training Types
  • Create, update, and delete training type(s)
Manage Themes
  • Can update the theme to any of the available themes in the OGL Console.
  • Can download the available Design Kit(s) in the appID
  • Can update the theme via the appID's Design Kit
  • Can upload modified Design Kit(s) to the appID
Change application settings
  • Enable feedback
  • Manage feedback settings for development and production
  • Update the application(sub-account) name
Create Managed Guides
  • Set a guide as a managed guide
Manage Comments
  • Manage comments in the full editor
Reset end-user usage data
  • Reset user analytics data
Manage Cloud Configuration
  • Manage Cloud Configuration in the OGL Console
Manage Oracle Content
  • Manage Oracle Content in the OGL Console.
Batch Update Guides
  • This feature enables you to update guides in batches.

Assigning Roles and Permissions

You can assign all of the permissions within a role to a user, or assign specific permissions. Depending on your approach, the role icons will change so you can quickly see which roles and permissions a user has:

image of green checkmark= ALL of the permissions within the OGL role are assigned to the user.

image of yellow -= SOME of the permissions within the OGL role are assigned to the user.

image of red x= NONE of the permissions within the OGL role are assigned to the user.

  • To revoke all user permissions for a particular OGL role simply click on image of yellow - or image of green checkmark to make it image of red x
  • To assign all user permissions for a particular OGL role simply click on image of red x to make it image of green checkmark
  • To assign some user permissions for a particular OGL role simply click on details menu, then proceed to assign/revoke the required permissions

Adding Users

Note:

Only the identified client-side OGL Admins have the access to add additional users to the account.

Use the user's email address to add them to the OGL.

To add users:

  1. On your OGL console's navigation menu, select Settings > User Management.

    nav_menu

    The User Management modal window appears.

  2. Select the Add Users button.

    add_users
  3. one Enter the new user's email address in the Email field,two assign the user permissions, then three select Save..

    user_mn

    Note:

    See theabove "Assigning Roles and Permissions" section to learn more.
  4. Select Close (X) to exit the User Management modal window.

Removing Users

To remove Users:

  1. Navigate to the User Management modal window.
  2. Check in the checkbox at the beginning of the line that lists the user you want to remove. Once checked in, the Delete button appears.

    usr_mn
  3. Select the Delete button.

    The user is now removed from OGL.

Exporting the OGL User Matrix

You can export the OGL user matrix in ".xlsx" format with a single click/selection.

  1. Navigate to the User Management modal window.
  2. Select the Export button (export) to download the user matrix.

    usr_mgmt

    The browser now downloads the .xlsx file.

separator

Your OGL App ID

Your OGL account is always associated with at least one Application ID (App ID).

An App ID is a logical grouping of guides (contents). Each App ID has its own dashboard and set of guides. If you have multiple App IDs, switch between your App IDs in the setup script of your Fusion application to view all the corresponding guides linked to that App ID.

If you want to integrate OGL into multiple applications, you should procure individual App IDs for each application. Contact your Oracle Account Manager for additional App IDs.

Know Your OGL App ID

Your OGL console consists of onean account and two one or more app(s), as shown below:

app id

Each app has a 22-character unique Application ID (or App ID) that enables the mapping of the Help Widget to your app. You will need to know this App ID to enable OGL.

Find your App ID

You can find your App ID in three ways.

Method 1:

  1. On the OGL Console homepage, select the User Menu at the top-right corner.

    User Menu
  2. On the User Menu, select About.

    About

    The About information pops up. You can find the App ID as well as the version number here.

    Your App ID looks like this: "yNmgDxxxxxxxxxxxx0cC_w".

    App Id

    Select the Close icon ( x ) on the top right corner to close the pop-up window.

Method 2:

  1. On your OGL console's navigation menu, select Settings > Application.

    The Application modal window is displayed.

  2. On the Application modal window, scroll down to the Details section.

    You can find the Application ID here.

    Application

    Select the Cancel button at the bottom left corner to close the modal window.

Method 3:

  1. On your OGL console's navigation menu, select Settings > Application > Domains.

    The Domains modal window is displayed.

  2. Find your OGL App ID here.

    appid 1

    Tip:

    Use the Copy button to copy the App ID to your clipboard, whenever you want to record it.
  3. Select Cancel to close the Domains modal window.

separator