Welcome to your new SAP Jam developer edition
The SAP Jam team is pleased to announce the availability of the free SAP Jam developer edition.
The SAP Jam developer edition is accessible only through the SAP Cloud Platform free developer account. If you haven’t yet signed up for your SAP Cloud Platform free developer account, then you can do so here: https://account.hanatrial.ondemand.com/register. Once you have registered, and logged in, to your SAP Cloud Platform free developer account, click on the Services menu option and SAP Jam will be listed as one of the services available to developers. Click on the Enable link to create your SAP Jam developer edition.
The purpose of this blog post is to help you get started with your new environment. First, a brief introduction to SAP Jam.
SAP Jam is the combination of social networking, collaboration, and business tools integrated with data and your business processes to help you get work done.
There’s so much you can do with SAP Jam – here are just a few of the things you can do:
- Ask questions
- Share information
- Collaborate on data coming from other applications
- Provide status updates
- Track tasks in projects
- Share, review and comment on documents
- Discuss with peers
- Evaluate ideas
- Find an expert
- Make decisions
- Write a blog or wiki
The SAP Jam developer edition will allow you to explore the capabilities listed above, how you can extend, integrate and customize SAP Jam as well as incorporate SAP Jam’s collaboration capabilities into your own applications.
Let’s get started…
Login to SAP Jam
Once you have enabled your SAP Jam developer edition, click on the Go To Service link within the SAP Jam Services section of the SAP Cloud Platform Cockpit to log in to your SAP Jam developer edition environment. You will be logged in as the SAP Jam administrator.
When you log into SAP Jam, you will be presented with the Home page. This page provides you with useful information about your environment as well as links to resources and documentation.
On this page you also have your own personal feed, showing you activities that you should be interested in from people you follow, groups you’re a member of and notifications sent directly to you. This is not to be mistaken with a group feed, which is visible when you’re viewing a specific group. When you log in for the first time your feed will be empty.
From this page you can post feed update updates, documents, videos and access other common actions such as your profile, your Account Settings and the Admin Console.
Administering SAP Jam
To access the SAP Jam Admin Console, click in the Cog icon at the top of the page and select the Admin menu option.
This will bring you to the Admin Console where all of the Administrator options that are available are accessible down the left hand side of the page.
Setting up new users
Collaboration is not possible, or much fun, with only one user so lets add another user.
The SAP Jam developer edition provides 3 user licenses. The first user to login is automatically assigned as the Company Administrator and consumes one of these licenses. The administrator will always login from the Go To Service link within the SAP Jam Services section of the SAP Cloud Platform Cockpit.
For additional users, they will need to login separately. To do this you first need to assign Roles in the SAP Cloud Platform Cockpit. Click on the Configure SAP Jam link and select Roles.
For the additional users that you require to login to the SAP Jam developer edition, it is necessary to assign each of them the SAP_JAM_USER role. To do this click the Assign button, enter their SAP ID Service User ID and click Assign. Once you have assigned the roles for additional users they will be displayed in the Individual Users list.
Unlike the Administrator, the additional users do not log into SAP Jam from within the SAP Cloud Platform Cockpit. To get the URL for the login page for your SAP Jam developer edition, right-click on the Go To Service link within the SAP Jam Services section of the SAP Cloud Platform Account Cockpit and select Copy Link Address.
Start a new browser window/Incognito window/private browsing session such that you don’t pick up any existing sessions and paste the URL. You will be presented with an SAP Jam developer edition login page.
As you will see from the Login page, the SAP Jam developer edition relies on the SAP ID Service as its Identity Provider (IDP) so any additional users must have an SAP Cloud Identity account. For this article, I used my SAP details as well as a personal email address.
Having assigned the SAP_JAM_USER role to your new user you can login using your SAP Cloud Identity account. A new user is created in your SAP Jam developer edition and you will consume another of the 3 available licenses.
You can view the users in your environment by navigating to the Users area of the Admin Console.
You can remove a user by editing the user and setting their Member Status to Alumni. This will then free up another license for use.
In addition to “internal users”, the SAP Jam developer edition also supports “external users”. The ability to create SAP Jam groups that support external users is not enabled by default but you can enable this capability by navigating to the Admin Console and selecting Features. Check the “Enable External Group Creation” option.
Create a Group
Groups are a big part of SAP Jam – they’re the places where you bring together people, data, best practices and content to solve business problems and get stuff done. Groups are a membership of users who can upload, create, or reference material specific to a department, project, or team. Members can participate in a topic discussion with a select number or all members in a group.
Lets start by creating a new group. We are creating this group as the Administrator but end users can also create groups.
Go to the Groups drop-down menu and choose Create a Group.
When creating a group, there are a number of pre-built templates available to use. Click the drop-down menu and scroll to the bottom and select No Template as we want to build a new one. We can create a re-usable group template from our new group once we are happy with the design.
Provide a group name and a group description that describes the purpose of the group. Click on Public to set the permissions of the group. Ensure that the “Activate this group now” checkbox is enabled. Click Create. For this example, the group I created is focused on Innovation such that a product team can share product updates, facilitate discussion and drive suggestions and ideas for product improvement.
We can now customize our group to meet our requirements. Click on the Overview option in the menu on the left-hand side of the page. The Overview page for the group is now displayed. The Overview page is used to present various types of information to the group including content, people and business data. Let’s customize the Overview page to meet our requirements. Click the Customize the Overview page link at the top of the page. This will take you to the Page Designer.
The Page Designer enables you to create a page layout using SAP Jam widgets. There are a number of page layouts provided as a starting point. I used the default layout for this example.
Provide a Title for your Overview Page. Using the Page Designer, we can very easily add widgets to the Overview Page.
There are widgets available for adding feeds, content, video, photos, forums, people and business data. Using these tools you can quickly build a structured, fully featured group for collaboration.
For the Innovation group, you can use the Forum widget, along with the provided filters, to create areas for Submitted, Accepted and Delivered Ideas. This will allow group members to post their ideas and track how the ideas are being managed and hopefully delivered.
Using the Page Designer, it is possible to very quickly create an engaging group using the provided widgets. By clicking the + icons you can start to add columns and rows to your page. For the Innovation group, I used the Text, Photo, Forum, Feed and People widgets.
Invite users to the Group
Now that we have created our group we can invite additional users to drive collaboration.
Using the Invite button you can invite other users to the group.
Let’s invite one of the users that we setup earlier.
As you start entering the users name their details will appear. Once selected, their name will appear in the Invitation List. Click the Send button to invite them to the group.
The invited user will receive their invitation as a Notification inside SAP Jam – note the red numbered notification at the top of the page.
Clicking on the Notification icon will display all of the users notifications – in this case the group invitation.
Now that we have our group, and users, we now need content to drive collaboration and discussion!
Content items are blog posts, decision tools, links, planning tools, videos, wiki pages, images, documents (PowerPoint, Word, Excel), polls, and any other file that you upload to SAP Jam. Group members can provide feedback on the information that content items contain, and use this information to collaborate and make decisions.
Let’s add a document. Click on the Feed Updates menu option within the group and in the Feed Widget at the top of the page – click the Add a Document icon. For this example, I uploaded a PowerPoint document.
Once uploaded, the document will be displayed inline inside SAP Jam and can be navigated by using the arrow buttons.
The uploaded document will appear in the Group feed. Group members can then add general comments or select areas of the document to comment upon.
Let’s now create a poll asking for product input and feedback. Click on the Content menu option. Click the Create menu to see the different content and tools available. Select Decision-Making Tools and then Poll from the menu.
The Poll decision-making tool allows you to ask a multiple-choice question. The Poll appears on the group feed and as people vote, the results are displayed graphically.
Finally, let’s add some product suggestions as Ideas. If you have added Forum widgets to your Overview page then you can click the Go To Forums link at the bottom of the widget and then click on Ideas. Alternatively, you can click on the Feed Updates menu option within the group and in the Feed Widget at the top of the page click the Add an Idea icon.
Once published, the Idea will appear in the Group feed and should also appear in the Forum widgets. Experiment with the widget filters to display Submitted, Accepted and Completed Ideas.
Users can now vote on the idea and the product team can review the ideas and decide whether to consider the idea or reject the idea. Filters on the Forum widgets allow us to see the Ideas as they flow through the product development process.
Testing your changes
Now that we have added users, created a group and added content we can now test out our changes. Log in as each of the users to test out the collaboration capabilities, comment on documents, vote ideas etc.
As you go through and submit, and comment, on content, vote in polls and post ideas you will see notifications appear in the top of the screen. Click on the Notification icon to view them.
You should now have an SAP Jam group containing content, decision-making tools as well as comments and discussion.
In this article, we have walked through the basics of setting up SAP Jam and getting to know your SAP Jam developer edition environment. We have only scratched the surface of SAP Jam’s capabilities but you now have a base from which to develop using SAP Jam.
With subsequent articles, we will explore the developer-focused capabilities of SAP Jam and how you can incorporate the collaboration capabilities and content you’ve created in your SAP Jam developer edition into your own applications or bring data from other applications such as those running on SAP Cloud Platform into SAP Jam to solve specific business challenges.
Please ask any questions via the comment section below or visit the SAP Jam Developer Community: http://scn.sap.com/docs/DOC-55050.
You can find more information in the SAP Jam Developer Guide, Administrator Guide and User Guide available here: http://help.sap.com/sapjam.
Enjoy your new SAP Jam developer edition!
Very cool! thanks James for the step-by-step! Can't wait to try it out.
Great stuff. So easy to get a Jam sandbox now, thanks for that!
I've registered and created a Jam tenant (in 2 min ... love it!) and am trying to add an OpenSocial gagdet like in the tutorial. So I registered the Lumira gagdet, and can see it in the Content (Add new Lumira Gadget). However from there, nothing happens. Where should I see that gadget?
http://help.sap.com/download/documentation/sapjam/developer/hcp/concepts/ADVANCED_TOPICS-OpenSocial_HCP.html is the tutorial.
Hi Julien, now that your gadget is registered in Content you can now add the gadget to an Overview page using the Tool Content Widget. Thanks.
Hi Julien a couple of things to remember. Make sure the gadget is "enabled", it won't show up if that check box is not marked. If you did that, you now need to remember if you marked it as a "Content" or "Profile" gadget. Profile gadgets show up on your Jam profile, Content gadgets need to first be added to the group from the "Content" section. To do this you need to go to "create" --> Extension --> Lumira gadget. Once added to the content section you can add it to the overview page if you like.
Thanks James Penfold and Robert Horne. I had followed all these instructions and the Lumira gadget had not appeared. Trying again this morning it showed up, so I guess it was just a question of sleeping on it 🙂
I am so glad to see that we are building a playground each time bigger and more fun to play with.
Have a great week!
Hi James. Amazing documentation. I am a researcher in University of Genova and me and my collegue want to create a new knowledge management system with the new perspective and we are going to decide about the tool. I was a ABAP developer so of course i prefer SAP. But i have a question that has SAP JAM an opportunity to change or create new screens etc..? Is it possible to create what ever we want in our database?
Hi Onur, lets connect directly and have a discussion?
Excellent tutorial and summary, managed to set up my personal trial instance in minutes. One question: is it possible to connect the SF app to this trial instance? If I go to Manage Devices in the mobile setup part I'm redirected to an error page.
Great to hear you are setup! We are fixing the error and working to make mobile available for the Developer Edition.
Great and very detailed guide - Thank you James! There was a lessons learned for me and I thought I might just share it with everyone:
In our project we are trying to add other users and we don’t get it working. All the users are having both HCP accounts and SCN account.
So what is the right way to add user and how the other user get notified?
We need to create a group with the users that are added in the member list. It shows the user as publish when we publish the member list in admin section.
Hi Latha, per the instructions in this blog post, you add additional "internal" Jam users through the Roles menu for the SAP Jam service in the HCP cockpit. Once added the "internal" user can log in using their Cloud Identity credentials and can be added to Jam groups. If you are still having issues we can connect directly offline.
Thanks for the information. After doing from the cockpit it worked. Just that internally it always logs in using SAML, so I had to send the link to my colleague to check add user functionality.
Creating a user does not work any more as you described above:
When the 2. user which has been invited to the SAP Jam (of 1. User) then after successfully authenticating with the copied service URL the following screenshot is displayed:
I tried this for two different trial accounts and in both cases the Logon screen appears.
I know that this worked already in the past for another trial account.
Do you know why this happens?
Let's connect offline to look at what you're trying to achieve (and then update this thread with the conclusion).
thanks for your great help.
I can confirm that my described issue has been fixed.
How was this resolved? I have signed up for a developer SAP JAM with myself as admin and am struggling to add another user to test the functionality.
The new user registered via https://accounts.sap.com/saml2/idp/sso/accounts.sap.com I added the new user name under SAP Cloud Platform Cockpit > Roles but the new user is not appearing under the users in my SAP JAM instance. This statement from above can be clearer and dummy proof:
Update: I found a dummy proof steps at https://sap.github.io/cloud-s4ext/week-3/unit-3/
Bojan - the issue reported by Jens was subsequently fixed and was concerned with creating new users in the SAP Jam Developer Edition.
Thank you for your update regarding the detailed steps for adding new users from the openSAP course - hopefully this solved your issue - if not we can connect offline.
This blog post - Welcome to your new SAP Jam Developer Edition - is due a refresh so we will make sure we provide more details on adding new users.
(second time trying to add a comment, apologies for the brevity this time around)
Thanks for the post, James. I'm still getting the same issue as described by Jens and by Bojan - the interstitial SAP Jam login page as shown by Jens in the screenshot he shared above. I read from your comment (in June) that the issue was fixed, but I don't think it is.
I even followed the flow at https://sap.github.io/cloud-s4ext/week-3/unit-3/ as highlighted by Bojan, but no luck - still the same problem, specifically at the end of step 3.2 "Lisa accepts the SAP Jam Invitation from John".
Can you please let us know what's going on here?
Are you still experiencing the issue? I saw a tweet from you that suggested the issue has been resolved (the old issue re-surfaced but had now been fixed) ?
Thanks for following up James, the issue has been resolved (some fix on the backend). Appreciated! DJ
Hi how do I send a custom kudos to someone?
Is this still available in SAP Cloud Platform as a free service for developers?