Integrate HBR Spark with Oracle Learning

Complete this one-time setup to configure integration, enable secure data exchange, and start importing, tracking, and managing Harvard Business Impact – Harvard Business Review Spark (HBR Spark) learning in Oracle Learning. You can enable either Harvard Business Impact – Harvard Business Publishing (HBP) or HBR Spark, but not both at the same time.

1. Make sure that you have an active account with HBR Spark that allows integrations.
2. Configure Single Sign On between Oracle Learning and HBR Spark to ensure the correct exchange of user information for learner progression tracking. You can use any identity provider.
3. Enable self-paced learning.
4. In Oracle Cloud Infrastructure Identity and Access Management, generate a unique set of Oracle client ID, client secret, token URL or OAuth server URL for each POD where you're enabling integration. The set lets you authenticate incoming requests from HBR Spark to track learning completions.
   1. Sign in to Oracle Cloud console.
   2. On the navigation menu, select Identity & Security > Domains.

      Complete steps c through l as many times as you have PODs. For example, to enable integration in a development POD and a production POD, complete the steps twice.

   3. On the Integrated applications tab, add a confidential application for HBR Spark.
   4. Enter a unique name that includes HBR Spark for easy identification, such as HBR Spark dev or HBR Spark prod, and a description.
   5. Submit the application.
   6. In the Configure OAuth step, configure the app as a client now.
   7. For authorization, select Client credentials.
   8. In the Token issuance policy section, add specific authorized resources that are accessible to the users.
   9. Add either the Oracle Applications Cloud (Fusion) or the Fusion Applications Cloud Service scope, whichever is available.

      The description shows the scope in the format <resource audience><resource scope>, for example, urn:opc:resource:fa:instsanceid=630113349urn:opc:resource:consumer::all. Copy this scope, which is different for each of your environments, because you'll need to share this information with HBR Spark.

   10. Submit the configuration.
   11. Review the configuration and activate the app.
   12. From the OAuth configuration page of your activated app, copy the client ID and client secret values because you'll need to share this information with HBR Spark.
5. Share this information with HBR Spark so that they can authenticate xAPIs to send content and tracking information:
   • Oracle Client ID
   • Oracle Client secret
   • Token URL or OAuth server URL

     It's in the form https://<your_idcs_domain>/oauth2/v1/token. You get the domain value from the domain overview page, Domain information tab.

   • Scope
6. In Oracle, create a job role that includes only the Learning Content Provider duty role--don't include any other duty role. The role lets this account use the necessary Oracle APIs to receive content and completions from HBR Spark.
   1. Go to Tools > Security Console.
   2. On the Roles tab, create your job role.
   Caution: If you have any IP restrictions or have enabled location-based access control (LBAC), make sure to enable the job role for access from all IP addresses. Otherwise HBR Spark will get API authentication failures when sending content to Oracle Learning.
7. Configure the Oracle client ID from step 4 as a user account that you'll use in step 8.
   1. On the security console Users tab, add a user account.
   2. Set Associated Person Type to None. Make sure the user isn't associated with a person or worker account.
   3. Enter the appropriate user details so you can identify the account. Make sure that the user name is the same as the Oracle client ID value. Any discrepancy might lead to an unsuccessful configuration.
   4. Add the job role that you created in step 6.
8. Enable HBR Spark.
   1. Go to My Client Groups > Learning and Development > Configure External Providers.
   2. Configure Harvard Business Impact – HBR Spark and enter the user account created in step 7.
   3. Select a learning catalog profile to apply to all imported HBR Spark learning. The profile identifies who can see and manage the learning.
   4. To prepare imported learning for discovery and automatically classify it, configure skills and qualifications, audience, and catalog settings. The settings apply to new content imported after you validate your changes. Changes aren't automatically applied to content imported before you validate these changes.

      Changes to the skills library or provider skills aren't reconciled to learning that's already been processed. Skills also aren't re-evaluated when you run Load and Sync External Course Data with Force All External Course Data to Reload set to Yes.

   5. To better support learning discovery in Oracle Learning, review the attribute mappings and update them as appropriate.
   6. Validate the configuration.
9. If they're not already scheduled because another provider is already enabled or you've been creating and managing your own self-paced learning, schedule these background processes.
   • ESS job to run Bulk ingest to OSCS
   • Process Learning Experience Statements
   • Process Learning Catalog Item Deactivations and Deletions

   Reference: Scheduled background processes for Oracle Learning

   1. Go to Tools > Scheduled Processes.
10. If you set the provider content visibility to private, schedule the Reconcile User Groups process to run daily if it's not already scheduled.