SAP Knowledge Base Article - Public

2419830 - LMS OCN Open Content Network Knowledge Support and Tips

Symptom

 

SFTipsNTricks.JPGLMS.png
Click to go back to the main page

 



LMS OCN - OPEN CONTENT NETWORK KNOWLEDGE SESSION FOR CUSTOMERS, PARTNERS AND SAP PRODUCT SUPPORT

These KBA it is to learn about LMS OCN Open Content Network in LMS to your advantage. This guide highlights the mains structure and settings of OCN within LMS.

1. Open Content Network

1.1. Where Open Content Network Courses Reside?

1.2. How MOOC Learning Items Differ from Internal Learning Items

1.3. How SAP SuccessFactors Learning sees MOOC Content

1.4. Standard Open Content Network Providers

1.5. Courses Available through Online Content Network

2. Implementing Open Content Network for Standard Providers

2.1. Enabling a Standard Open Content Network Provider

2.2. Synchronizing Standard Open Content Network Provider Course Listings

 

3. Implementing Open Content Network for Non-Standard Providers

3.1. Adding Open Content Network Provider Names

3.2. Enabling a Non-Standard Open Content Network Provider

3.3. Importing OCN Content References to SAP SuccessFactors Learning

3.4. Sending Completion Status from an OCN Provider to SAP SuccessFactors Learning

 

4. Configuring SAML for OCN

4.1. SAML IPD for SAP SuccessFactors Learning

 

5. Setting a Pricing Model for Open Content Network

 

6. Open Content Network Administration

6.1. Importing Open Content

6.2. Searching for Open Content Learning Items

6.3. Viewing Open Content Network Sessions

6.4. Activating and Deactivating Open Content Network Learning Items

6.5 Open Content Network User View

 

7. References for OCN Web Services

7.1. SAP SuccessFactors Learning Currencies

7.2. Content Object Launch Methods

7.3. Locale Codes for SAP SuccessFactors Learning

 

8. Background Knowledge for SAP SuccessFactors Learning Web Services

 

9. KBA’s related to OCN troubleshooting

 

10. Notes to be considered at Customer Support

10.1. Additional Configuration

11. Q2 2017 - Enhancements

 

ToTop.png

1. Open Content Network

Open Content Network (OCN) is a group of Massive Online Open Course (MOOC) partners who can provide content to SAP SuccessFactors Learning.

SAP SuccessFactors Learning created Open Content Network (OCN) to partner with Massive Online Open Course (MOOC) providers so that your employees can easily access their content from within your system. Employees can still take a MOOC with one of our providers outside the Learning Management System (LMS), but when you bring their courses into the LMS, you make it available for assignment, add it to catalogs, bundle it into a curriculum or program, or make it a part of your company's social learning through recommendations.

1.1. Where Open Content Network Courses Reside?

Open Content Network (OCN) content always exists on the provider's site.

Learning items that use content from a Massive Online Open Course (MOOC) reference the content that is served from on the MOOC provider's website. Importantly, SAP SuccessFactors Learning does not import the content. In fact, we treat MOOC content like any other training content: the Learning Management System (LMS) doesnot serve the content. Content is served from another server like iContent or the MOOC provider. The LMS of SAP SuccessFactors Learning tracks users' completion of the content but does not serve the content.

 

1.2. How MOOC Learning Items Differ from Internal Learning Items

Massive Open Online Course (MOOC) learning items differ slightly from internal learning items.

After administrators import courses through Open Content Network (OCN) into learning items in SAP SuccessFactors Learning, the learning items behave like other learning items: you can organize them into catalogs, assign them to programs, include them in assignment profiles, and so on. They do, however, differ from internal learning items in the following ways.

To Users, OCN Items Have Special Filters and Markers in Catalogs

OCN Courses appear mixed in with standard courses in users' catalogs. The catalogs do include some special ways to identify and filter OCN courses:
  • Users see an icon in the course description that tells them the source of the content.
  • Users can filter web courses by provider using the standard filter mechanism in Source.
  • Users can click  Category -> External  to see only OCN courses.

1.png

 

To Administrators, OCN Courses Have a Special Classification

The system assigns the learning item the system classification EXTERNAL-COURSE. This classification separates the content network courses from internal courses.

2.png

 

1.3. How SAP SuccessFactors Learning sees MOOC Content

SAP SuccessFactors Learning defines Massive Online Open Courses (MOOC) as an entirely online course that seeks massive participation but that might or might not be free of charge.

In SAP SuccessFactors Learning, we define MOOC content as any very large, open course that takes place entirely online. It can be free or it might not be free of charge. As a customer, you might pay for access to some courses from a provider like Open Sesame and those course might be MOOC content. Or, you might integrate a free Kahn Academy course to a program or send it as a recommended link.

The only important distinction in MOOC content are the providers that are members of Open Content Network (OCN). To import MOOC content through OCN, your partner must be an approved provider. With an approved provider, we can import the MOOC content predictably and the provider can enable a SAML integration to pass users from SAP SuccessFactors Learning to the MOOC provider through single sign on.

 

1.4. Standard Open Content Network Providers

Standard Open Content Network (OCN) providers have an existing connection to SAP SuccessFactors Learning, so implementation is easier.

  • Coursera
  • Lynda.com
  • Open Sesame
  • OpenHPI
  • Udacity
  • Harvard Manage Mentor

 

1.5. Courses Available through Online Content Network

If you connect your Massive Online Open Content (MOOC) provider through Online Content Network (OCN), their entire catalog is available to you.

When you connect a supported MOOC provider through OCN, you have access to its entire content catalog. Courses are increasingly being developed for corporate training in subjects like big data, energy, entrepreneurship, finance, risk management, cybersecurity, constitutional law, and leadership. The courses for corporate training are in addition to traditional MOOC subject areas in computer science, math, statistics, programming, public health, and other traditional higher education subjects.

Note :By using a feature like learning programs or recommended links, you can make any MOOC content that is public on the web available to your users. But by using OCN, you can track user participation as a standard learning item and users can launch password-protected MOOC content directly from their assignments list and search for it in the catalog as if it were any other learning item.

 

ToTop.png

2. Implementing Open Content Network for Standard Providers

Implement standard Open Content Network (OCN) providers if you sign an agreement from one of the list of standard providers that we support.

Context

A standard OCN provider has an existing connection to SAP SuccessFactors Learning, existing labels and logos, and existing properties in the OCN properties file. You only need to sign an agreement with the provider and enable them in SAP SuccessFactors Learning.

A non-standard OCN provider, by contrast does not have an existing connection to SAP SuccessFactors Learning, so you must work with the provider to build one before you can enable it.

Procedure

  1. Sign an agreement, usually a subscription, with one of the standard OCN providers.

    Each provider has its own agreement process, so contact the sales representative for your provider for guidance.

  2. Talk with your provider about enabling SAML for single sign on and building a client to the completion status API to automatically report back users' completion of the content.
  3. Go to SAP SuccessFactors Learning administration and then go to  System Admin ->  Configuration -> System Configuration .
  4. Open the OPEN CONTENT NETWORK configuration properties file and find the standard provider.
  5. Set your Open Content Network Synchronization process so that SAP SuccessFactors Learning can receive the latest list of your providers' content.

Next Steps

After you implement an OCN provider, you administer the courses from the provider. Your main task during administration is import: you import the course listings from the OCN provider to learning items in SAP SuccessFactors Learning.

  1. Enabling a Standard Open Content Network Provider
    Enable a standard Open Content Network (OCN) provider in the system properties files when you sign an agreement with a standard OCN provider and you want to enable links to their courses from SAP SuccessFactors Learning.
  2. Synchronizing Standard Open Content Network Provider Course Listings
    Synchronize the course listings of standard Open Content Network (OCN) providers with the Learning Management System (LMS).

 

2.1. Enabling a Standard Open Content Network Provider

Enable a standard Open Content Network (OCN) provider in the system properties files when you sign an agreement with a standard OCN provider and you want to enable links to their courses from SAP SuccessFactors Learning.

Prerequisites

Before you can enable a standard OCN provider, you must sign an agreement with them.

Procedure

  1. Go to SAP SuccessFactors Learning administration and then go to  System Admin -> Configuration -> System Configuration .
  2. Open the OPEN CONTENT NETWORK configuration properties file and find the standard provider.

    3.png
       For example, if you sign an agreement with Lynda.com, you see the provider [LYNDA]. You configure those properties.
  1. Complete the values with the provider name identified.
  2. Click Apply Changes.

2.1.2. Open Content Network System Property File

After you sign agreements with content providers, you configure the Open Content Network to connect SAP SuccessFactors Learning to the provider.

Enabling the System and the Providers

This property...

...Is Used As Follows

enableWebCoursesTabInCatalogSearch

**This is no longer needed as of 1802**

Set to true to enable the Web Courses tab in the end users' learning catalog pages. All MOOC courses appear on this tab. Set to false to disable the tab. When you disable the tab, you disable all user access to the MOOC courses: if they cannot see the tab, they cannot see the courses.

providers[<specific provider name>].*

Do not change any value for a property that starts with providers unless you are directed to so so by a SAP SuccessFactors Learning representative. There are two exceptions to this rule, and they are described in the rows below.

providers[<specific provider name>].enabled

By default, all providers are disabled (this property is set to false. Set to true to enable the provider after you sign an agreement.

providers[LYNDA].orgID

The provider Lynda.com provides its customers with an organization ID, as a way to organize its customers. You find the organization ID in your agreement. Paste the organization ID as the value of providers[LYNDA].orgID.

providers[<specific provider name>].fetchDeltaOnly

When set to true, the system fetches changes to the provider's catalog instead of the entire catalog. Administrators see the catalog in  Learning  Content Network .

You can set this property to false to do a first import. After the Automatic Process Manager (APM)  System Admin  Automatic Processes  Open Content Network Content Synchronization  runs the first time, you can set it to true to import only the changes. Remember that this property is per provider, so run a full fetch (set it to falsefor the first run of the APM) each time you add a provider.

providers[<specific provider name>].pricingModel
providers[<specific provider name>].pricingModel determines the pricing model of the provider. Valid values are:
  • A value of null means that the provider falls back on whatever pricing you have configured in Commerce or falls back on free courses. If you want to use OCN with SAP SuccessFactors Learning commerce, then type null. If you plan to offer all courses for free, type null.

  • If you want to publish the price of an OCN course on users' catalogs and allow them to pay for it a la carte from the OCN provider, type RETAIL. The provider must have an a la carte option. Companies can use this, for example, if they tell users to charge the course to a credit card and submit it in an expense report. The transaction takes place outside SAP SuccessFactors Learning, but we do show the pricing information so that users can make informed decisions. You cannot use Commerce if you select a retail model.

  • If you signed up under a provider's subscription model, type SUBSCRIPTION. Subscription models vary, but users under a valid subscription are allowed to take the course. Billing takes place under your provider's subscription agreement. You cannot use Commerce if you choose a subscription model.

providers[OPENSESAME].config.appKey

OpenSesame requires a tenant ID, an app key, and a secret key. With an OpenSesame account, you can retrieve the information at https://www.opensesame.com/OCNInformation published on non-SAP site

providers[OPENSESAME].config.secretKey

OpenSesame requires a tenant ID, an app key, and a secret key. With an OpenSesame account, you can retrieve the information at https://www.opensesame.com/OCNInformation published on non-SAP site

providers[OPENSESAME].config.tenantID

OpenSesame requires a tenant ID, an app key, and a secret key. With an OpenSesame account, you can retrieve the information at https://www.opensesame.com/OCNInformation published on non-SAP site

 

Setting Default Import Values

When you import content from a provider to SAP SuccessFactors Learning, each course becomes a learning item in your system. The following properties define the default values when the system creates the learning item. The default values are the recommended values for most customers (the most common configuration case). The provider ID is a part of the provider's configuration such as providers[OPENSESAME].enabled=false.

This Property...

...Is Used as Follows
defaultValues.domainID[default]

This value is the default security domain of learning items created from importing MOOC content. The bracket default is what the system falls back to if you do not include the provider name, for example, OPENSESAME. To do so, simply copy the property and replace 'default' with your provider, for example, OPENSESAME.

defaultValues.crossDomainEnabled[default]

This value determines whether cross domain support (CDS) is enabled on the content. CDS is supported for Lynda only, and to use it, you must set up CDS. To set up CDS, read the Integration - Learning and Cross-Domain Content Servers document for your release. The bracket default is what the system falls back to if you do not include the provider name, for example, OPENSESAME. To do so, simply copy the property and replace 'default' with your provider, for example, OPENSESAME.

defaultValues.enableMobileAccess[default]

This value is the default value for the flag that enables mobile learning access for the learning items. If you want users to access the MOOC content only through a browser on laptops, set to false. The bracket default is what the system falls back to if you do not include the provider name, for example, OPENSESAME. To do so, simply copy the property and replace 'default' with your provider, for example, OPENSESAME.

defaultValues.isOnline[default]

This is the default setting for the flag that allows users to access the learning item. If you want to import MOOC content but you want to hide it until you have a chance to review each learning item, set the value to false. To reduce your review workload, set to true. The bracket default is what the system falls back to if you do not include the provider name, for example, OPENSESAME. To do so, simply copy the property and replace 'default' with your provider, for example, OPENSESAME.

defaultValues.isApprovalRequired[default]

This is the default setting for the flag that either requires or does not require approval to take a course. The idea of MOOC courses is that are highly available to your users, so in most cases, you should set to false. You can always set individual learning items to require approval later. Set to true to require, by default, approval to launch MOOC courses. The bracket default is what the system falls back to if you do not include the provider name, for example, OPENSESAME. To do so, simply copy the property and replace 'default' with your provider, for example, OPENSESAME.

defaultValues.processDefinitionID[default]

If you require an approval process by default in isApprovalRequired, then you create a default approval process and paste the ID as the value of this property. The bracket default is what the system falls back to if you do not include the provider name, for example, OPENSESAME. To do so, simply copy the property and replace 'default' with your provider, for example, OPENSESAME.

defaultValues.isSupervisorCanRecordLearningEvents[default]

This is the default setting for the flag that allows supervisors to record learning events on the learning item. The idea of MOOC courses is that they are highly available to your users, so we recommend setting this to true. You can always override the default value for individual learning items. The bracket default is what the system falls back to if you do not include the provider name, for example, OPENSESAME. To do so, simply copy the property and replace 'default' with your provider, for example, OPENSESAME.

defaultValues.isUserCanRecordLearningEvents[default]

This is the default setting for the flag that allows end users to record learning events on the learning item. The idea of MOOC courses is that they are highly available to your users, so we recommend setting this to true. You can always override the default value for individual learning items.The bracket default is what the system falls back to if you do not include the provider name, for example, OPENSESAME. To do so, simply copy the property and replace 'default' with your provider, for example, OPENSESAME.

defaultValues.currencyCode[default]

If you set up commerce for MOOC content and if you do not want to use the default currency code, then provide an alternative currency code here. The currency code is the ID from  References  Commerce  Currencies . The bracket default is what the system falls back to if you do not include the provider name, for example, OPENSESAME. To do so, simply copy the property and replace 'default' with your provider, for example, OPENSESAME.

defaultValues.itemType[default]

This is the default learning item type value for learning items created from importing MOOC content. Item type is sometimes confused with item classification. Item types are enumerated in  References  Learning  Item Types . The bracket default is what the system falls back to if you do not include the provider name, for example, OPENSESAME. To do so, simply copy the property and replace 'default' with your provider, for example, OPENSESAME.

defaultValues.itemCompletionStatus[default]

This is the default value for completion status of the learning items created from importing MOOC content. This value is useful in two circumstances: when the value ofmarkCompleteOnLaunch is set to true or when crossDomainEnabled is set to true. The bracket default is what the system falls back to if you do not include the provider name, for example, OPENSESAME. To do so, simply copy the property and replace 'default' with your provider, for example, OPENSESAME.

defaultValues.itemFailureStatus[default]

This is the default value for failure status of learning items created from importing MOOC content. The bracket default is what the system falls back to if you do not include the provider name, for example, OPENSESAME. To do so, simply copy the property and replace 'default' with your provider, for example, OPENSESAME.

defaultValues.reviewable[default]

This is the default value for the flag that enables a learning item to be reviewable. The bracket default is what the system falls back to if you do not include the provider name, for example, OPENSESAME. To do so, simply copy the property and replace 'default' with your provider, for example, OPENSESAME.

defaultValues.markCompleteOnLaunch[default]

This is the default value for the mark complete on launch flag for learning items created form MOOC content. If you are tracking completion status, we recommend you set totrue in this release. The bracket default is what the system falls back to if you do not include the provider name, for example, OPENSESAME. To do so, simply copy the property and replace 'default' with your provider, for example, OPENSESAME.

2.1.2. Open Content Network Provider Codes

Open Content Network (OCN) provider codes are the unique IDs that SAP SuccessFactors Learning uses to identify supported providers.

If you do not see a provider code listed here, you can check your configuration by logging in to SAP SuccessFactors Learning administration and then going to  System Admin  Configuration  System Configuration  OPEN CONTENT NETWORK . The provider codes are bracketed in your configuration file. For example, LYNDA is a provider code because you see it in brackets in the configuration file: providers[LYNDA].enabled.

OCN Provider Codes

Code

Provider

COURSERA

Coursera

OPENHPI

openHPI

OPENSESAME

OpenSesame

LYNDA

Lynda.com

UDACITY

Udacity

HARVARDMM

Harvard Manage Mentor

 

2.1.3. Open Content Network Admin Set Up example

Admin will configure OCN properties to enable each provider they want to import courses from, as well as default item configurations that will be applied on import.

4.png

 

2.2. Synchronizing Standard Open Content Network Provider Course Listings

Synchronize the course listings of standard Open Content Network (OCN) providers with the Learning Management System (LMS).

Prerequisites

Before you can set up synchronization, you must sign up with a standard OCN provider and you must enable them in system properties.

Context

You synchronize with standard OCN providers because you need to keep your list of available OCN courses in synch with changes that the standard OCN providers make. For example, the provider might add courses. You want SAP SuccessFactors Learning to pull the new course listings so that you can see them and import them to learning items.

Note: Synchronization works for standard OCN providers only. If you signed up with a non-standard provider, then the provider manages the synchronization with a push. Non-standard OCN providers push their course listings to SAP SuccessFactors Learning with a web service..

The process runs for all standard OCN providers you enabled in  System Admin  Configuration  System Configuration  OPEN CONTENT NETWORK .

Procedure

5.png

  1. Go to SAP SuccessFactors Learning administration and then go to  System Admin ->  Automatic Processes -> Open Content Network Content Synchronization .
  2. Set the standard scheduling fields to decide how often you want your process to run.
    Tip Note: Most companies can set their synchronization process to run weekly except for the first time it runs. If you are scheduling it for the first time, run it daily five minutes in the future in your time zone.
    This forces a synchronization so that you can proceed to import courses. After you import courses, return to the automatic process schedule it to run weekly.
  3. Click Apply Changes.

Next Steps

After the synchronization process runs, you can see the providers' courses in  Learning -> Content Network .

 

2.2.1. Setting Up your Automatic Processes Fields (APM's)

View this section if you want to know about setting up your automatic processes fields.

This Field…

…Is used as follows

Schedule this Process

This check box, when selected, triggers this process to run on a schedule.

Hourly

When you choose this option you will type the hourly rate at which you wish to schedule the job in the Every ____ Hours field. For example, if you wish to run the job every 100 hours, you would enter Every 100 Hours.

Every/Hours

If you run the process on a daily basis you must schedule the number of hours between the process runs.

Daily

Select this radio button to run the process on a daily basis.

Weekly

Select this radio button to run the process on a weekly basis.

Day

If you have weekly process runs, you need to enter the day of the week you wish to run the process.

Monthly

Select this radio button to run the process on a monthly basis.

Date

If you set up a monthly process to run, you need to specify the date in the month that you want the process to run.

Time of Day

The time of day at which the automatic process is run.

Time Zone

The time zone in which the process is being run.

Last Execution

The date and time the automatic process was last run.

Schedule End Date Threshold

The number of days you enter into the Schedule End Date Threshold field dictates how long the system keeps running the automatic process for the VLS scheduled offering.

Next Execution

The next date and time at which the automatic process runs.

Email Recipients

If you select either the User or Supervisor check boxes, then the system includes those users when it sends a notification.

Email Address

This is generally the email address of the learning administrator who is setting up the automatic process and wants to be notified about the success or failure of the automatic process. This email address is in addition to the normal recipients of notifications. This additional automatic process notification recipient receives a copy of the notice, and in certain processes comprehensive list of all users or offerings that are affected.

Include free-floating Item

The Include free-floating Item check box is available only for the Curriculum Clean-up and allows you to include or exclude free-floating items from that automatic process.

 

 

ToTop.png





3. Implementing Open Content Network for Non-Standard Providers

Implement Open Content Network (OCN) for non-standard providers if you want to assign an agreement with a vendor and the vendor is not in the list of standard providers.

 

Context

A non-standard OCN provider does not have an existing connection to SAP SuccessFactors Learning, so you must work with the provider to build one before you can enable it.

A standard OCN provider, by contrast, has an existing connection to SAP SuccessFactors Learning, existing labels and logos, and existing properties in the OCN properties file. You only need to sign an agreement with the provider and enable them in SAP SuccessFactors Learning.

Procedure

  1. Sign an agreement, usually a subscription, with an OCN provider.

    Each provider has its own agreement process, so contact the sales representative for your provider for guidance.

  2. Create a label that is the name of the provider so that users can see the name in their catalogs.
  3. Configure the non-standard provider in  System Admin -> Configuration -> System Configuration -> OPEN CONTENT NETWORK .
  4. Talk to your provider about push the content listings to SAP SuccessFactors Learning through a web service, and pushing it on a defined schedule.

    Note : Unlike standard providers, the OCN synchronization process does not work for non-standard providers.

  5. Talk to your provider about sending completion status from the provider to SAP SuccessFactors Learning.

    By sending the completion status, your users get learning history in SAP SuccessFactors Learning for content that they completed at the provider's site.

  6. Talk with your provider about enabling SAML for single sign on and building a client to the completion status API to automatically report back users' completion of the content.

 

ToTop.png

11. Q2 2017 - Enhancements

We have added a new Open Content Network (OCN) provider, edX, to call LMS API's.
 - SAP Learning Hub configurations are now exposed as we lay down the integration framework.
 - Customers can easily integrate with the new OCN providers to access their catalog of courses.

Enhancement  - LRN-16927, LRN-16928

1. edX Configurations

 - New Configurations are added to the OPEN CONTENT NETWORK System Configuration

Naviagate to System Admin > Configuration > System Configuration > OPEN CONTENT NETWORK

You can find the new configuraitons added. Please configure the required settings here.

# edX Provider
# Please contact business@edx.org to sign your organization up for edX course access
providers[EDX].enabled=false
providers[EDX].name=edX
providers[EDX].pricingModel=
providers[EDX].label=label.ProviderEdx
providers[EDX].orgID=

Note: You will need to contact edX first. Once identified by edX they will push the courses in your instances.


2. Learning Hub Configurations

- New Configurations are added to the OPEN CONTENT NETWORK System Configuration

Naviagate to System Admin > Configuration > System Configuration > OPEN CONTENT NETWORK

You can find the new configuraitons added. Please configure the required settings here.

# Learning Hub Provider
providers[LEARNINGHUB].enabled=false
providers[LEARNINGHUB].name=Learning Hub
providers[LEARNINGHUB].label=label.ProviderLearningHub
providers[LEARNINGHUB].syncCourses=true
providers[LEARNINGHUB].apiUrl=
providers[LEARNINGHUB].handlerClass=com.plateausystems.elms.bo.ocn.impl.LearningHubCourseImportHandlerImpl
providers[LEARNINGHUB].pricingModel=
providers[LEARNINGHUB].fetchDeltaOnly=false
providers[LEARNINGHUB].inactivateCoursesMissingInFullFeed=false
# This User ID's Catalog Content will be fetched
providers[LEARNINGHUB].config.userID=
providers[LEARNINGHUB].config.adminID=
providers[LEARNINGHUB].config.secretKey=
providers[LEARNINGHUB].config.companyID=
providers[LEARNINGHUB].config.clientID=
#Org ID for LearningHub is the BizX SP entity ID.
providers[LEARNINGHUB].orgID=

You will need to make the configuration changes here. Once done, you should be able to import the LEARNING HUB Courses in the system.
You should have a valid Learning Hub license to get the configuration details. Please contact your sales rep regarding license purchase

Environment

  • SAP SuccessFactors Learning Management System (LMS)

Keywords

  • OCN Open Content Network
  • Open Content Network
  • Coursera
  • Lynda
  • Harvard
, KBA , LOD-SF-LMS-CNT , Content , LOD-SF-LMS , SuccessFactors Learning , How To

Product

SAP SuccessFactors Learning all versions