Skip to Content

What do you need to try out the HCP Gamification Service?

You need a free SAP Cloud Platform developer account (trial instance): Signing Up for a Developer Account

 

Note: We recommend that you use the Firefox or Chrome Web Browser.

 

 

How to Subscribe to the Gamification Service?

 

  1. Log on the SAP Cloud Platform Cockpit: https://account.hanatrial.ondemand.com/cockpit.
  2. Go to the Services tab
  3. Go to Gamification Service
    Screen Shot 2016-08-19 at 13.00.06.png

  4. Choose Enable for the gamification service entry.
    Screen Shot 2016-08-19 at 13.00.37.png
  • A subscription of the gamification service will be automatically assigned to your account.
  • All roles (AppStandard, AppAdmin, GamificationDesigner, TenantOperator, helpdesk) are automatically assigned to your user. These roles are required to access the Gamification Service Workbench and the sample application (Help Desk).
  • A subscription of the sample application Help Desk is automatically assigned to your account.
  • The destinations “gsdest” and “gswidgetdest” are automatically created. The destinations are required by the sample application.
  • Principal propagation for the local service provider is enabled.

 

Further documentation: https://help.hana.ondemand.com/help > SAP Cloud Platform >  Services > Gamification Service > Getting Started > Enable Gamification Service

 

 

How to use the Sample Application and Get Started?

 

Note: You must have obtained subscriptions for the Gamification Service Workbench and Sample Application (Help Desk) through service enablement.

 

1 Configure Roles (optional)

 

All roles (AppStrandard, AppAdmin, GamificationDesigner, TenantOperator, helpdesk) are automatically assigned to your user. If you want to grant other users the roles proceed as follows:

 

  1. Select the gamification service and choose Configure Gamification Service.
  2. Select the Roles tab.
  3. Assign the roles AppStandard, AppAdmin and helpdesk to the user.

 

Further documentation: https://help.hana.ondemand.com/help > SAP HANA Cloud Platform >  Services > Gamification Service > Getting Started > Assign Gamification Roles

 

 

2 Configure Destinations

 

Note: The two destinations gsdest” and “gswidgetdest” are automatically created while being enabled for your account. You only need to enter the user credentials.

 

  1. On the Cloud Platform cockpit account page navigate to the Destinations section. Note: Do not use the destinations of your subscription. Screen Shot 2015-09-24 at 14.05.50.png
  2. Open the destination “gsdest”.
  3. Enter the user ID and password of your SAP ID user (same as SCN).Destination.png
    • Note: In productive scenarios a separate user is recommended.

 

 

Further documentation: https://help.hana.ondemand.com/help > SAP HANA Cloud Platform >  Services > Gamification Service > Getting Started > Configure Destinations

 

 

3 Generate Demo Content for HelpDesk Sample App

 

  1. During first launch of the Gamification Service Workbench you will be asked to create the demo content. Press on Create.Screen Shot 2016-08-19 at 12.57.51.png
  2. Optional: Open the Gamification Service Workbench is opened.
  3. Go to the Administration tab in the Gamification Service Workbench.
  4. Go to Demo Content Generatio and press Create HelpDesk Demo and press Confirm in the upcoming dialog. After a while you will see the notification “Demo app successfully created.”
    Screen Shot 2016-08-19 at 12.58.15.png
  5. Switch to the “HelpDesk” application by using the dropdown box in the upper right corner of the Gamification Service Workbench to select the sample app context.
    Screen Shot 2016-08-19 at 13.09.52.png
  6. Go to the Summary tab to check if all game mechanics are available.

 

 

Further documentation: https://help.hana.ondemand.com/help > SAP Cloud Platform >  Services > Gamification Service > Getting Started > Generate Demo Content for HelpDesk

 

4 Use Sample App – Help Desk

 

  1. Go to the Services tab.
  2. Choose Go to Service of the gamification service subscription. The Gamification Service Workbench is opened.
  3. Click the Help link in the upper right corner of the Gamification Service Workbench. A help popup appears.
  4. Click the Open HelpDesk link in the help popup.
    Screen Shot 2016-08-19 at 13.11.21.png
  5. You can now start using the application and process tickets. For each ticket you will gain experience points according to the demo content created. For critical tickets three experience points are assigned. Furthermore, missions and badges are assigned. (Details on the gamification design can be found here: https://help.hana.ondemand.com/help > SAP Cloud Platform >  Services > Gamification Service > Case Study: Gamified Help Desk Application > Gamification Design

Screen Shot 2015-12-18 at 09.39.58.png

Further documentation: https://help.hana.ondemand.com/help > SAP Cloud Platform >  Services > Gamification Service > Getting Started > Use Gamified HelpDesk App

 

 

Detailed Documentation for a Gamification Service integration scenario?

 

Further Documentation: https://help.hana.ondemand.com/help > SAP Cloud Platform > Services > Gamification Service > Integrating Service into Target Application

 

 

Additional Material

 

Hands On: Using the SAP HCP Gamification Service (by Philipp Stehle, Moya Watson, Michael Ameling,)

Integrating SAP Cloud Platform Gamification Service into an Issue Tracking Tool (JIRA) (by Anuj Mehta)

 

Gamification Service

 

How to consume the SAP Cloud Platform Gamification Web APIs (by Sourav Mukherjee)

Questions and Feedback?

Gamification_Service_48.pngWe highly appreciate your questions or feedback. Please add your comments below.

Additionally, you can keep yourself up to date by visiting the SAP Cloud Platform Release Notes page regularly.

 

 

To report this post you need to login first.

16 Comments

You must be Logged on to comment or reply to a post.

  1. Michael Ameling Post author

    FAQ

    Destinations are not visible

    In case you don´t see the automatically created destinations you are probably at the wrong space. You have to go the the Destinations tab of your account (not from the subscriptions).

    HelpDesk app does not work

    Most likely you have not entered your SAP ID User (same as SCN) password in the destination “gsdest”.

    In case you forgot your SAP ID Password you can reset your password here: SAP ID – Forgot My Password

    (0) 
  2. Vasily Baranovsky
    (0) 
    1. Moya Watson

      Hi Vasiliy –

      There’s a password that appears to be saved by default in the gsdest destination — when I changed that to my SCN user ID password, this worked.  Try that out and see if it helps? Let me know!

      thanks

      -m

      (0) 
      1. Michael Ameling Post author

        Thanks Moya. This solves the issue in case you don´t see your user profile or don´t get notifications in the sample app (Help Desk). Regarding the issue with the userprofile embedded as iFrame please see my comment below.

        (0) 
    2. Michael Ameling Post author

      Hi Vasily,

      the behaviour is correct. The user profiles are protected by default. In order to see basic user achievements as an administrator you can go on the “Players” tab in the Gamification Workbench and select the according user:

      /wp-content/uploads/2015/05/players_696684.png

      /wp-content/uploads/2015/05/players_ivan_696685.png

      The access to the user profile via the iFrames using /gamification/userprofile.html requires an according security mechanism. In our sample app (Help Desk) you can see how the integration is done. The source code is available on GitHub. (The integration of the user profile is done in the file profile.view.js). In our automatically deployed sample app the security is covered via destinations (basic authentication). The result can be seen if you open the Help Desk app (via Help in the Workench) and press on your user name on the top right corner:

      User_Profile.png

      (0) 
      1. Vasily Baranovsky

        Thank you a lot for your detailed answer, Michael!

        I like this Gamification Service – it can really bring value to the HR cases I’m working around.

        (0) 
    1. Michael Ameling Post author

      Hi Martin,

      in general the Gamification Service is open for the integration in any application. An integration in Drupal would require the following integration steps:

      • Sending gamification relevant events (e.g., content changes) to the Gamification Service
      • Displaying the achievements in Drupal (if required)

      The integration can be done via the API (Gamification Workbench > Help > Open API Documentation) of the Gamification Service. An example of an integration scenario is described in the following documentation: Integrating Gamification Service into a Target Application

      Best regards,

      Michael

      (0) 
  3. Monika Kaiser

    Hi Michael,

    I’m able to run the application but I do not get any points!

    Do you have any idea, what the reason could be?

    Generally I like preconfigured destinations and the concept of the Helpdesk demo app very much!

    Best Regards,

    Monika

    (0) 
    1. Michael Ameling Post author

      Hi Monika,

      Thanks a lot for your feedback!

      The most common reason is the configuration of destinations. Can you please check that you entered your username and password (SAP Identity User) manually in your destination “gsdest” of your account (not service).

      Another issue could be that you have not created any content (default content). Can you please check if you have any points, levels and rules deployed on you summary page?

      Best regards,

      Michael

      (0) 
  4. Christian Pfisterer

    Hi Michael,

    I can see the gamification service in my trial account, but can’t see the gamification service in our productive landscape. I enabled the function to show BETA services but it’s still not showing up.

    Is it not released for the productive enviroments yet?

    Great post. Looking forward to build our first gamification service for Jira.

    Christian

    (0) 
    1. Michael Ameling Post author

      Hi Christian,

      this is correct. Currently the service is only released on Trial. We are currently working on to make it available in the productive environments (with Beta flag). I´ll send an update once it is available.

      Best regards,

      Michael

      (0) 
  5. Mingho Su

    It would be nice that team can add creator or group so they can be easily identified by different people.

     

     

    Thanks Mingho

    (0) 

Leave a Reply