- Prerequisites
- How does the connector work?
- Edflex Contents Synchronization
- User Activities Synchronization
- Setup & Activation
- Monitoring & Maintenance
- Stop Importing Edflex Content to the Oracle Learning Catalog
- Troubleshooting
Functional Overview
Learners can
- Browse and find Edflex resources on the Oracle Learning catalog using filters (title, publisher, author, type…)
- View content details before accessing the content itself (title, description, estimated effort, author, cover-art…)
- Access Edflex contents using SSO
- When learners complete an Edflex content, their enrollment in Oracle Learning will be updated to be completed on their profile.
Note that: Learner cannot find or enroll in a retired Edflex content.
Learning Specialist will be able to
- Search for Edflex content as Self-Paced Learning using applicable metadata such as title, learning item number, publisher, author, and learning type.
- View Edflex content metadata populated in self-paced learning items.
- See content updates synchronized from Edflex to Oracle.
- See retired content as Inactive in Oracle learning.
- Access to the user's Edflex enrollment and completion under Learning Assignments or download reports.
Prerequisites
On the client-Oracle's:
See Oracle-related documentation: Set Up Edflex Integration with Oracle Learning
- Have an active Oracle Learning Cloud LMS instance
- Have Admin privileges to your Oracle Learning Cloud LMS instance
- Obtain Oracle API credentials (Client ID and Client Secret)*
- Oracle scope and token URL*
- Share an Oracle user account (see Setup & Activation section)
*This must be unique for each Oracle tenant.
On Edflex:
- Have an activated Edflex portal
- Have a published catalog and “Synchronize with LMS” setting enabled
- A SSO must be set with Oracle or with the client to ensure user activity tracking (preferred option - SSO directly with Oracle)
- Setting up a SSO between the client's Active Directory and Edflex? Make sure the user ID from this setup and the one in the Oracle are the same.
Edflex will only push content that the customer has a license for. Customers must have a company license with Edflex.
How does the connector work?
This is a schema of the flow of the connector between Edflex and Oracle Learning.
The connector between Oracle Learning and Edflex offers a secure and efficient integration between an Oracle database and Edflex:
- Edflex will push content to the Oracle learning catalog by using Oracle’s API.
- Edflex will synchronize newly added content, metadata updates, retirements, and reactivations on a daily basis.
- Edflex will send learner start and completion information using xAPI statements live.
Edflex Contents Synchronization
Objective
Make new content and updates from Edflex catalog visible in Oracle Learning to be consumed by Learners. The synchronization occurs once a day, in the morning.
Edflex will push content to Oracle learning with all metadata such as:
- Content URL access,
- Title,
- Description,
- Language,
- Content branding image,
- Expected Effort to complete the content,
- Publisher,
- Provider Name,
- …
Learners will click on the URL and consume the contents.
Prerequisites
- Confirm and adjust (if necessary) the content mapping on Oracle
- A catalog of contents must be created on the Edflex portal
Details
Learning Type Mapping
| Edflex Learning Type | Oracle Learning Type |
|---|---|
| Article | Article |
| Assessment | Assessment* |
| Book | Book |
| Certificate | Assessment* |
| Course | Online Course |
| Interactive | Online Course |
| Lab | Assessment* |
| Podcast | Podcast |
| Program | Learning Path |
| Roleplay | Assessment* |
| Top voice | Learning Path* |
| Video | Video |
*Oracle allows clients to update some of the mapping. Recommendation to do it before the first synchronization to not have to do changes manually after.
Learning Level Mapping
| Edflex Learning Level | Oracle Learning Level |
|---|---|
| Introductive | Beginner |
| Intermediate | Moderate |
| Advanced | Advanced |
Business Driver
All contents are assigned to self-development.
Content Property Mapping
The connector will synchronize the below listed metadata.
| Oracle Learning Metadata | Edflex Metadata |
|---|---|
| Title | Content Title |
| Short Description | Content Description |
| Long Description | Content Description |
| Learning Item Number | Edflex Content ID |
| Expected Effort | Content Duration |
| Language | Locale (there will be one content item per language) |
| Author | Editor |
| Instructor | Author |
| Learning Level | Level |
| Publisher | Edflex for all contents |
| Retirement Date | Date of when the content is disable |
| Content published date | Publication Date |
| Content URL | Content URL |
| Image URL | Thumbnail URL |
User Activities Synchronization
Objective
Track learner engagement in real-time and log activities into the Oracle system.
Details
| Edflex Learning Type | xAPI – Start Event | xAPI - Complete Event | Supports explicit retake/re-enroll? | Support browsing content? |
|---|---|---|---|---|
| Course | initialized | completed | no | yes |
| Book | initialized | completed | no | yes |
| Video | initialized | completed | no | yes |
| Assessment | initialized | completed | no | yes |
| Podcast | initialized | completed | no | yes |
| Top Voice | Not available | Not available | N/A | N/A |
| Article | initialized | completed | no | yes |
| Certificate | Not available | Not available | N/A | N/A |
| Lab | initialized | completed | no | yes |
| Program | initialized | completed | no | yes |
| Interactive | initialized | completed | no | yes |
| Roleplay | initialized | completed | no | yes |
- Learners will see on their profile the content started and completed
-
Admin can access these information in the Oracle’s UI “Learning Assignments” or on their usual reports.
- No filter on Provider available on Oracle Learning Assignments page
- Filters can be made on the content title, completion status, completion date.
Setup & Activation
If you need a more detailed document, please contact your Edflex CSM.
What to do in a few steps?
- The first step involves creating an OAuth application in Oracle Cloud Infrastructure Identity & Security to enable secure API communication between Edflex and Oracle Learning.
- A custom security role must be created to grant the necessary permissions for the Edflex integration to access Oracle Learning APIs.
- On the Tools > Security Console page, Roles tab, create a new role.
- A service user account is needed to link the OAuth application with Oracle Fusion and assign the custom role.
- On the Tools > Security Console page, Users tab, add a user account.
- Set Associated Person Type to None.
- Enter the appropriate user details so you can identify the account. Give the account a meaningful user name, such as “Edflex”.
- Create a job role and include the “Learning Content Provider” duty role.
- Grant this role to the new user account. The role allows this account to use the necessary Oracle APIs to receive content and completions from Edflex.
- Enable the Edflex external provider using the Configure External Providers task on the My Client Groups > Learning & Development page.
- Then go under Setup > Configure External Providers, under Content
-
Configure the Edflex provider.
- Select the Enabled check box.
- Enter the user name of the account created in the previous step and validate.
- Optionally change the attribute mappings. These let you map certain Edflex attributes to attributes in Oracle Learning that you might have extended or modified.
- Contact your Edflex Customer Success Manager and give them the username and the credentials created in Oracle Learning.
- If they aren't already scheduled, schedule these background processes using the Navigator > Tools > Scheduled Processes task:
| Process | Recommended Frequency | Description |
|---|---|---|
|
ESS job to run Bulk ingest to OSCS Set the program name to OLC-REST and leave the other input fields empty. |
Once per day | Makes new content and updates from Edflex visible in Oracle Learning. |
| Process Learning Experience Statements | Processes any learner experience statements from Edflex that for some reason weren't processed immediately. | |
| Process Learning App Events | Deactivates content when the deactivation date set by Edflex arrives. |
Monitoring & Maintenance
For all integration, we have a set of tools and alerts such as:
- Daily cron jobs to synchronize and update contents and user activities
- Error logs pushed to our monitoring tools
- Alerts, when necessary, on our daily tools
If there is any issue, your Edflex CSM will send you an email to inform you about the issue and the solution in progress.
Stop Importing Edflex Content to the Oracle Learning Catalog
Inactivation doesn't remove previously imported content because you want to keep it for reference in learner transcripts.
Before you start
In the learning catalog, end date all the content for the external provider that you're inactivating using one of these methods:
- Manually, using the Content task on the My Client Groups > Learning page.
- Using the Learning Content Items REST API. For details, see the REST API for Oracle Fusion Cloud HCM guide in the Human Resources area of Oracle Help Center.
You should also consider end dating the associated courses and offerings so they don't appear in the learner catalog anymore. You can do this by manually updating the publish end date to the current date using the Courses and Offerings tasks on the My Client Groups > Learning page. Or you could update the courses and offerings using HCM Data Loader.
Here's what to do:
- On the My Client Groups > Learning page, click Configure External Providers.
- On the Configure External Providers page, in the applicable row, click Configure.
- In the Status field, select Inactive.
Troubleshooting
If you are having any problems with the setup of this integration, please feel free to contact us.
To help you faster, please provide your Edflex customer success manager with the following:
- API credentials mentioned above
- A small recap on what you try to achieve and the steps you have been through
Error: learningItemType is invalid
With 26A, ORA_WLF_ELEARNING_TYPE lookup has less values than it had in 25D. Most of the values are appearing as end dated/disabled.
According to Cloud Customer Connect , please run the following process (you should have to be granted with access to run Scheduled Processes to do so):
From Tools > Scheduled Processes > Learn Migration with datafix option Digital Learning Migration
Values will be enabled the next day in the lookup.