Integrate external application into SAP Jam Collaboration

An external application in SAP Jam Collaboration defines the connection between SAP Jam Collaboration and an external application to securely access the data in that application exposed via its API. Use the following steps to create this:

1. Click the settings icon, and select Admin.
2. Select Integrations | External Applications from the sidebar menu.
3. Click Add Application and select SAP Cloud Platform from the dropdown menu.
4. In the Name text box, enter ESPM.
5. Click the Select Authentication Type drop-down menu, and select Common User.
6. Click Save to create the external application.

Record types in SAP Jam Collaboration define how the data from the external application will be displayed within SAP Jam Collaboration. Use the following steps to import the ESPM Web Shop records into SAP Jam Collaboration:

1. Import the Product records
   

   1. From the External Applications page, select Action | Manage Record Types next to the ESPM application.
      
   2. Click Add Record Type.
      
   3. In the Name text box, enter Products.
      
   4. In the External Type text box, enter:

      https://espmrefapps.hana.ondemand.com/espm-cloud-web/espm.svc/$metadata#Products
      

      This data includes the information on the products included in the ESPM application. It is exposed as OData.
      

   5. In the Annotation URL text box, enter:

      https://espmrefapps.hana.ondemand.com/espm-cloud-web/webshop/reviews_annotations.xml
      

      This file is used by SAP JAM Collaboration to render the data. The annotations.xml file, together with the available data, exposed via OData, enables you to create an external application in SAP Jam Collaboration that brings in products and product reviews data from the ESPM application into SAP Jam Collaboration. The OData annotations file specifies how each type of data is displayed in a specified UI element.
      
   6. Click Import External Resources.
      
   7. Click Done.
      
   8. Click Create.
   
   
2. Import the Customer Reviews records.
   To import the Customer Reviews records, repeat Steps b to g, but change the Name value in Step c to CustomerReviews and the External Type value in Step d to
   https://espmrefapps.hana.ondemand.com/espm-cloud-web/espm.svc/$metadata#CustomerReviews

Groups are a membership of users who can upload, create, or reference material specific to a department, project, or team. Group members can participate in discussions, forums and much more. Use the following steps to create a new ESPM Reviews Group in SAP Jam Collaboration for an ESPM Web Shop Record:

1. Select Business Records from the top menu-bar.
2. Select ESPM in the Name column.
3. Select Products in the Type column.
4. Copy the ID value next to Notebook Basic 15 in the ID column.
5. Hover over Notebook Basic 15 in the Product Name column.
6. Click the Create Group button in the quick view panel.
7. In the Type a Group Name text box, enter ESPM Product Reviews - and paste the ID value.
8. Set the Group Permissions by selecting Public.
9. Select the Activate this group now checkbox.
10. Click the Create button. The new group has now been created.

SAP Jam Collaboration groups act as the collaborative workspaces for work patterns. Group templates organize the content in a way that provides guidance to users on the best way to approach the work required to support a particular repeatable business process. Use the following steps to create the ESPM Reviews group template in your SAP Jam Collaboration group:

1. Select Overview.
2. Click the Create an Overview Page button.
3. Click the OK button.
4. Enter Current ESPM Product in the Title field.
5. Setup the Current Item widget:
   
   1. Click the Add Widget button for the widget in the top middle of the page.
      
   2. Select the suitcase icon in the bottom row.
      
   3. Select Item Detail from the Show drop-down list.
      
   4. Select the Widget Title field and enter Current Item.
      
   5. Click the OK button.
6. Setup the Highest Reviews widget:
   
   1. Click the Add Widget button for the widget in the lower left side of the page.
      
   2. Select the suitcase icon in the bottom row.
      
   3. Select Related from the Show drop-down list.
      
   4. Select CustomerReviews from the Type drop-down list.
      
   5. Select Rating from the Sort by drop-down list.
      
   6. Select the Widget Title field and enter Highest Reviews.
      
   7. Click the OK button.
7. Setup the Lowest Reviews widget:
   
   1. Click the Add Widget button for the widget in the lower left side of the page.
      
   2. Select the suitcase icon in the bottom row.
      
   3. Select Related from the Show drop-down list.
      
   4. Select CustomerReviews from the Type drop-down list.
      
   5. Select Rating from the Sort by drop-down list.
      
   6. Select the Ascending radio button.
      
   7. Select the Widget Title field and enter Lowest Reviews.
      
   8. Click the OK button.
8. Click the Publish button.
9. Click the Publish button. Your group template is published into your group.

The Overview page now displays rich information about the product and its reviews.

Start collaborating with other users on this ESPM Review group! Try creating other sales collaboration groups for other items from the ESPM Web Shop business records as well.