SAP Knowledge Base Article - Public

2323363 - JAM Integration in LMS Knowledge Support and Tips

Symptom

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

 

 JAM INTEGRATION IN LMS KNOWLEDGE SESSION FOR CUSTOMERS, PARTNERS AND SAP PRODUCT SUPPORT

 

1. SAP Jam Overview

2. SAP Jam request integrated installation with Bizx and LMS

2.1. Requesting SAP Jam Integration with SuccessFactors Platform

2.2. Required Information

2.3. The Process

2.4. The Environments

2.5. SAP Jam & Data Center Migration

2.6. SAP Jam Support & Documentation

3. Demo SAP Jam Integration with LMS Configuration Steps

4. LMS KBA for SAP JAM

 

1. SAP Jam Overview

http://go.sap.com/product/content-collaboration/enterprise-social-collaboration.html

jampic1.jpg

 

SAP Jam – Enterprise Social Collaboration Tool
Features available:

Features

Description

Feeds

status updates

Opensocial

OpenSocial gadgets are web apps that extend the capabilities of SAP Jam to interact with any software or service.

Groups

Helps creating groups as per users preferences

Themes

Prefined themes layout

Content(wiki,docs)

Sorts the complexity of document management

Agenda

Helps creating meeting

Task

Assigning Task to one or many

Timeline

Manage Timelines for projects etc

Notify

Sends email notification to notified user

Chat

enables chat funtionality for users

Search

Any JAM content smooth search

Gamification

Gamification for users

IMPORTANT NOTE:  Gamification is only possible in Jam enterprise edition

Please review https://www.sap.com/about/agreements/policies/service-specifications.html

 

 Picture2.png

 SAP Jam Overview : Features

Picture3.png

 

4 types of Jam installations
 
Picture4.png
 

ToTop.png

 2. SAP Jam request integrated installation with Bizx and LMS

2.1. Requesting SAP Jam Integration with SuccessFactors Platform


Create a new case via either the Customer Support Portal or the Service on Demand Agent Client with:
     Request Summary: SAP Jam Integration Request [Customer Organization Name]
     Product: Jam
     Category: Configuration Change Request

2.2. Required Information

Include the following information in the Request Details:
SuccessFactors Instance Information:

-ENVIRONMENT: From the list of available Environments (included below)
-COMPANY ID: Company Id, as it appears in Provisioning  Note:  ID is case-sensitive.
-COMPANY NAME: The Company Name as it appears in Provisioning

SAP Jam Editions – Basic (Included with BizX. Free), Paid Editions >  Advanced, Advanced Plus, Enterprise - **Please Note** If the client purchased SAP Jam, please check Cloud Reporting, or request the customer attach a copy of the Schedule A to the ticket.

Support can also reach out directly to the customer’s sales rep to confirm purchase / request if Cloud Reporting is not current.

  • PARTIAL Permissioning - Enabled By Default: This means users will need to be granted access via Admin Tools by the SF Admin before they can access SAP Jam.
  • ADMIN ACCOUNT NAME: First / Last name of the Admin account that will be used to sync the Employee data from BizX to SAP Jam. We recommend using a System Admin account, not an personal Admin account. This account must also have at minimum, Employee Export permissions. Note, if this user is deactivated in BizX, the sync will fail.
  • ADMIN ACCOUNT USERNAME: Please provide the Username for the Admin Account Name above. Used for the API calls between SAP Jam and BizX. Note: USERNAME is case sensitive: i.e. if John Doe logs in as JDoe then this must be exact and not jdoe.
  • TEST or PROD INSTANCE : Is this a Test or Production BizX instance.
  • DATA CENTER: See environmnet table for more information.

 

2.3. The Process

1.   SAP Jam CS will create an engineering ticket (JIRA) and notify the requester when the integration is complete.
2.  The Customer (or PS/CS with BizX Admin access for the company) will then need to permission users for access to the SAP Jam Module (if partial permissions are enabled).
    a)  After the integration, a new link "Permission to Access Jam" will appear on the BizX Admin Page, under Manage Security
    b)  This will only be available to a Full SuccessFactors Admin
    c)  Once user's are permissioned, there is up to a one hour delay before the user will be set up in SAP Jam

 

2.4. The Environments


The following is the list of available SuccessFactors Environments where Jam is available.

Note: Services shown in cells with yellow backgrounds provide production environments only.

Table 6: SuccessFactors Platform and SAP Jam data centers
Old nameNew nameLocationSuccessFactors Platform (Production & Preview)SAP Jam (Prod. & Preview)
DC2 Amsterdam1 /HCM Amsterdam, NL, EU

https://performancemanager.successfactors.eu
https://hcm2preview.sapsf.eu

https://jam2.sapjam.com
DC4 Chandler1 /HCM Chandler, AZ, US

https://performancemanager4.successfactors.com
https://hcm4preview.sapsf.com

https://jam4.sapjam.com
DC8 Ashburn1 /HCM Ashburn, VA, US

https://performancemanager8.successfactors.com
https://hcm8preview.sapsf.com

https://jam8.sapjam.com
DC10 Sydney1 /HCM Sydney, NSW, AUS

https://performancemanager10.successfactors.com
https://hcm10preview.sapsf.com

https://jam10.sapjam.com
DC12 Rot1 /HCM St. Leon-Rot, DE, EU

https://performancemanager5.successfactors.eu
https://hcm12preview.sapsf.eu

https://jam12.sapjam.com
DC15 Shanghai1 /HCM Shanghai, CN https://performancemanager15.sapsf.cn https://jam15.sapsf.cn
DC17 Toronto1 /HCM Toronto, ON, CA

https://hcm17.sapsf.com
https://hcm17preview.sapsf.com

https://jam17.sapjam.com
DC18 Moscow1 /HCM Moscow, RU

https://hcm18.sapsf.com
https://hcm18preview.sapsf.com

https://jam18.sapjam.com

DC19

Sao Paulo1/HCM

Sao Paulo, BRA

https://hcm19.sapsf.com
https://hcm19preview.sapsf.com

https://jam19.sapjam.com

2.5. SAP Jam & Data Center Migration

Data Migration is not possible for SAP Jam at this time.

  • A Data migration tool / feature is on the road-map but no release date available.
  • Clients can download their content before migrating > then upload content and create new groups in the new data center.
  • Before migrating, clients can download documents, videos and pictures from the old SAP Jam instance & re-upload via the SAP Jam multi-document up-loader into the new SAP Jam instance.
  • Clients can copy / paste wiki’s and blogs into a Word document before migrating, but the associated comments (if any) will be lost.


2.6. SAP Jam Support & Documentation

SAP Jam Admin and User Guides: http://help.sap.com

SAP Jam Customer Community: http://community.successfactors.com/t5/SAP-Jam/ct-p/Jam

SAP Jam FAQ: http://service.sap.com/sapjamfaq

SAP Jam Mobile App User Guide: http://bit.ly/1DAo90m

SAP Jam Developer Community:  http://scn.sap.com/docs/DOC-55050

SAP Jam Support Center (Internal Only): https://jam4.sapjam.com/groups/about_page/3B960zLBubCXJjPjDT59T5

For Customers and Employees > SAP Enterprise Support Value Map for SAP Jam Collaboration: Please register here: http://support.sap.com/valuemaps

 

ToTop.png

 3. Demo SAP Jam Integration with LMS Configuration Steps

NOTE: LMS can be integrated to the customers JAM systems provided the JAM version in use is either "Advance", "Advanced Plus" or "Enterprise" Edition.

Step-by-Step – Installation of JAM demo in your LMS instance

  • Step 1-2  (Gather SFSF Learning OAUTH Token) is for Advanced integration
  • Step 3 and others are only for Advanced Plus / Enterprise

 

Link of the specific chapter: https://help.sap.com/viewer/u_admin_help/7bb26b5afea340f290571696b55514ea.html

1. Getting started

a. Go into SAP Jam demo admin section  >  Demo  >  Demo Data.  You will see all available demo scenarios, including the new integrated ones: “Situational Leadership” and “Leadership Development Academy” (will be greyed out until integration is setup)

Picture12.png

b. Important: Make sure that the SAP Jam admin has a corresponding account in SuccessFactors Learning and can also access to the learning catalog (demo user “admin” should have access to all. IMPORTANT: “sfadmin” will be made an admin in the next update, for now, please use “admin”)

c. It is highly recommended that import the „Actor pack“ to BizX before proceed to next steps, described in this guide

2. Integrate SF LMS and SAP Jam (see full version in the SAP Jam Admin Guide)

-Gather SuccessFactors Learning OAuth token information

I.  SF Learning Admin > System Admin >  Configuration > System Configuration
II. Search in the LMS_ADMIN configuration file for "jamIntegrationEnabled", ensure that it is set to "true", and click Apply Changes.
  • jamIntegrationEnabled = true
Picture13.png
 

Picture10.png

 

iii. Navigate to System Admin>Configuration>System Configuration>BizX (click “Edit” icon) to access configuration properties.

 Picture6.png

Update “successFactorsCubeTreeBaseURL” according to the correct server mapping (see below).

Table 6: SuccessFactors Platform and SAP Jam data centers
Old nameNew nameLocationSuccessFactors Platform (Production & Preview)SAP Jam (Prod. & Preview)
DC2 Amsterdam1 /HCM Amsterdam, NL, EU

https://performancemanager.successfactors.eu
https://hcm2preview.sapsf.eu

https://jam2.sapjam.com
DC4 Chandler1 /HCM Chandler, AZ, US

https://performancemanager4.successfactors.com
https://hcm4preview.sapsf.com

https://jam4.sapjam.com
DC8 Ashburn1 /HCM Ashburn, VA, US

https://performancemanager8.successfactors.com
https://hcm8preview.sapsf.com

https://jam8.sapjam.com
DC10 Sydney1 /HCM Sydney, NSW, AUS

https://performancemanager10.successfactors.com
https://hcm10preview.sapsf.com

https://jam10.sapjam.com
DC12 Rot1 /HCM St. Leon-Rot, DE, EU

https://performancemanager5.successfactors.eu
https://hcm12preview.sapsf.eu

https://jam12.sapjam.com
DC15 Shanghai1 /HCM Shanghai, CN https://performancemanager15.sapsf.cn https://jam15.sapsf.cn
DC17 Toronto1 /HCM Toronto, ON, CA

https://hcm17.sapsf.com
https://hcm17preview.sapsf.com

https://jam17.sapjam.com
DC18 Moscow1 /HCM Moscow, RU

https://hcm18.sapsf.com
https://hcm18preview.sapsf.com

https://jam18.sapjam.com

DC19

Sao Paulo1/HCM

Sao Paulo, BRA

https://hcm19.sapsf.com
https://hcm19preview.sapsf.com

https://jam19.sapjam.com

iv. Gather the OAuth information: SF Learning Admin > System Admin > Configuration > OAuth Token Server. Generate a new client secret button. Copy and save : Client ID and Newly Generated Client Secret. Also copy the URL from domain name of your SuccessFactors Learning.

Picture14.png

 

3. Check that Enable Api is enable in JAM Admin
Go to SAP Jam (from BizX page) > Go to JAM Admin > On the left hand side, select features > You will see "Enable API"

Make sure it is CHECKED

Picture9.png

Admin can create Item based Jam groups.
NOTE: LMS Admin must be an Admin in Jam.

Picture11.png

 

4. Register SuccessFactors Learning as an External Application in SAP Jam
  • SAP Jam Admin > Integrations > External Applications > Add Application: SF Learning
  • Add:
    –OAuth 2.0 Client Id
    –Newly Generated Client Secret field

Picture15.png

  • Domain name of your SuccessFactors Learning (learning admin URl or e.g. in Chrome, right click "View frame info" and copy the base URL for the page)

 

5. Make sure the admin user you are using has access to LMS Core Catalogue

i. IMPORTANT: your LMS admin account might NOT be a User account (search under Users, your admin account does not appear). In this case, raise IT Ticket ask your LMS admin account to have access to LMS Core Catalogue.

ii.BizX => Admin centre => Learning => Learning Administration

iii.In LMS admin => Users => Assignment Profile, search for “EMP” and select

iv.Click on “Manage Rule” 
 
 Picture16.png
 
 
 
v. Add admin user “sfadmin”, “admin” to the rule, Save
    1. Include, “twalker” and “ghill” if you already have imported actor pack
vi. Click on “Propagate” to apply the changes

 
6. Register the SuccessFactors Learning business record in SAP Jam

i. IMPORTANT: the user you are using to register business record in SAP Jam should be a corresponding user on SFSF SuccessFactors Learning and should have access to LMS’s Core Learning Catalogue. Refer to above Step C.

ii. SAP Jam Admin > External Applications >  SF Learning > Action > Manage record type > Add record type > Import Default types. 

iii. Note: if you get the error message “import external resources” – failed – then there is most likely a cut and paste mistake, e.g. Extra spaces anywhere etc. can cause it to fail. To fix it, re-generate the client secret and delete and re-created the External Application.
 
Picture17.png

 

7. Setup demo data in LMS
-Add schedule offerings to learning item (e.g., Situational Leadership)

i.SF Learning Admin > Learning > Items  > Search in item title for “situational”

ii.Go to Actions > Schedule > add date and time > save. Add additional dates and times. All will be shown in SAP Jam

iii.Edit the item description as needed, (e.g., shorten the description to something like “Situational leadership model is a powerful, yet flexible tool that enables leaders to diagnose the variables of any given situation and adapt their management styles to the behavioral needs of the individual or group they are trying to influence. The model provides a framework which leaders can use to assess an individual’s performance readiness level to perform a specific task or function.”)

iv.If the item does not show for a specific user, make sure that the user has access to the catalog where the item is listed or add the item to the right catalog. Example: Add the “Situational Leadership” item to the “HR” catalog (to which Tessa has access). Catalog tab for the course > click on the plus icon to add additional catalogs to the item if you should need
 
8.  Add “Test user” to BizX and LMS (required to see the two new demo groups)
-Adding Tessa Walker (test user) to BizX/Foundation

1.If you have uploaded the “SAP Jam demo actor pack.csv” you can skip this step. 

2.If you have not uploaded it yet and/or are unfamiliar with adding new users to BizX, see the SAP Jam Demo Systems FAQ. You have two ways:

a)Option 1: Upload the SAP Jam demo actor pack.csv, which is the complete set of user accounts that support the official SAP Jam demo scenarios. You can find the link to the file and instructions in the SAP Jam Demo Systems FAQ

b)Option 2: Manually add specific users. Admin Tools > Add New Employee (or directly in the BizX file). In particular, take care in selecting the correct Login ID (=Person ID, e.g., twalker) and Email.
 

-Adding user to LMS: LMS Admin > User > add new.

1.Important: make sure you add the UserID (not username/login!). To do that, export the BizX excel with user information that contains both UserID and User name and find the UserID. Tipically, twalker’s UserID = 82094.

2.Change her domain to your demo system’s main Domain: this can be “Corporate (CORP)”, “Industry(IND)”, “BestRun USA(10001)”, etc.

Picture18.png

 

9. Manage the Assignment profile to give her access to a learning plan
i. Add Tessa(twalker) and Geoff (ghill) manually (or if you are familiar with LMS ensure that the “CORP” domain is included Assignment Profile “COREDEMO” and/or “EMP”)

1.Go to the Assignment Profile rules: User > Assignment Profile > EMP > Manage Rules

2.Add Tessa: Add new group > name it e.g. Tessa > Add rule: Attribute “userID” / Operator “matches” / [userID], e.g. twalker)

3.Save and if necessary synchronize/propagate

4.In Learning Administration > Users, add the Curricula LEAD-001 (Leadership Candidate Training Track) to the user.
 
Picture19.png
 
 
ii. To check: Login as Tessa, navigate to Learning. You should see her learning plan and if you search for “situational leadership”, the class should show.
iii. Also,
 
Picture20.png
 

10. Finalize the SAP Jam groups

You are now ready to perform the demo.  Go into demo admin section and select the demo scenarios “Situational Leadership” and “Leadership Development Academy”, by checking the checkboxes and click refresh.  Select the highlighted icon to access the demo scripts.

Note: Make sure you can search, „Situational Leadership“ course in Business Record Type: Items. And user twalker(82094) exists on LMS with Core Catalogue profile assigned.

Picture21.png
 

11. Additional useful tips

  • See below links to the key documents that contain all information to setup the integration and your demo system
  • One common issue is that the automatic process of inviting users into SAP Jam after enrolling into a training is not working. This can be easily fixed by restarting the process in LMS: >Learning Admin > System Admin > Automatic Processes > Jam Groups
  • SAP Jam group can be created from a learning item and with 1505 also from a curriculum or scheduled offering
  • When creating a Jam group based on a Business Record, the learners are not automatically assigned to the Jam group, the link has to be created in LMS

More Information:
·The setup instructions are in the official SAP Jam Admin Guide: http://help.sap.com/download/documentation/sapjam/administrator/index.html#7bb26b5afea340f290571696b55514ea.html

·The feature descriptions are in the User Guide:
http://help.sap.com/businessobject/product_guides/Jam14/en/sap_jam_user_guide.pdf 
(section 12.1.7)

·For questions on demoing SAP Jam are addressed in the SAP Jam Demo Systems FAQ
https://jam4.sapjam.com/groups/6aISwLJBdnaryocM2nqtqg/documents/OKfX8SR11TZOIDBLxXsS9R/slide_viewer?_lightbox=true
 
 

12. How to Screenshots in LMS
Adding a learning item to a catalogue:
Picture22.png

Add a New User :

Picture23.png

Ensure that new user is part of the Domain “Corporate CORP” :

Picture24.png

 

 

Jam Configuration Considerations
 
SAP Jam / BizX integration is performed by the SAP Jam Customer Success team unless the customer is brand new.

New customers receive integrated SAP Jam / BizX instances from the provisioning team after their initial SAP order is placed. Customers receive credentials for BizX first. A few days later they will receive a notice from the provisioning team that their SAP Jam instance is integrated: SF_Provisioning@sap.com

• Advanced Plus version of Jam is required for Learning to automatically create Jam Groups

• Firewall configurations maybe needed by Operations team

NOTE: Also Partner/Implementation team may need to review KBA 2266004 - SAP Jam integration with LMS  for the JAM implementation side in Provisioning.

 

ToTop.png

4. LMS KBA for SAP JAM

KBA LMS JAM

2161834 - Unable to Connect to Jam. Please Verify your Jam Integration setting and connectivity whilst adding Jam Groups to an item in LMS

2092903 - BACKLOG - What happens if an Assignment Profile has the attribute settings changed but it is not propagated and synchronized? - SAP Jam

2092912 - LMS - Errors while creating "Program" in LMS - SAP JAM

2101268 - BACKLOG - When the admin navigated to Learning > Item > Jam group – the admin gets the following error: “Unable to Authenticate your User account. Please check you Jam account credentials” - Learning

2266004 - SAP Jam integration with LMS

2278820 - Should you generate a new OAuth token for LMS Jam integration?

2397209 - SAP Jam Administrator Types Access Explained

 You can continue searching in your launchpad for more KBA related on the next link SecureIcon.JPG.

 

ToTop.png

Environment

  • Learning Management System (LMS)
  • SAP JAM

Keywords

  • LMS Integration
  • Integration LMS and JAM
  • JAM Integration
  • JAM Integration in LMS
, KBA , LOD-SF-LMS , SuccessFactors Learning , LOD-SF-LMS-ADM , Admin Tools , LOD-SF-JAM , SAP Jam , How To

Product

SAP Jam Collaboration all versions ; SAP SuccessFactors Learning all versions

Attachments

Quick Guide - Demo Learning WorkPatterns with LMS and Jam_20160616.docx