How to set up SAP Jam for Integration with other SAP Solutions

Transcription

1 How to set up SAP Jam for Integration with other SAP Solutions 1 How-To Guide Document Version: How to set up SAP Jam for Integration with other SAP Solutions

2 How to set up SAP Jam for Integration with other SAP Solutions 2 Copyright 2015 SAP SE or an SAP affiliate company. All rights reserved. No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP SE or an SAP affiliate company. SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP SE (or an SAP affiliate company) in Germany and other countries. Please see for additional trademark information and notices. Some software products marketed by SAP SE and its distributors contain proprietary software components of other software vendors. National product specifications may vary. These materials are provided by SAP SE or an SAP affiliate company for informational purposes only, without representation or warranty of any kind, and SAP SE or its affiliated companies shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP SE or SAP affiliate company products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty. In particular, SAP SE or its affiliated companies have no obligation to pursue any course of business outlined in this document or any related presentation, or to develop or release any functionality mentioned therein. This document, or any related presentation, and SAP SE s or its affiliated companies strategy and possible future developments, products, and/or platform directions and functionality are all subject to change and may be changed by SAP SE or its affiliated companies at any time for any reason without notice. The information in this document is not a commitment, promise, or legal obligation to deliver any material, code, or functionality. All forward-looking statements are subject to various risks and uncertainties that could cause actual results to differ materially from expectations. Readers are cautioned not to place undue reliance on these forward-looking statements, which speak only as of their dates, and they should not be relied upon in making purchasing decisions.

3 How to set up SAP Jam for Integration with other SAP Solutions 3 Content 1 Introduction Business Scenario Background Information Prerequisites Setting up the BizX instance Create users in BizX Reset user password Grant Permissions to Access Create another BizX admin Setting up the Jam instance Create another Jam admin Customizing Customizing your SAP Jam instance via Jam Customizing your SAP Jam instance via BizX (Theme Manager) Customizing notification templates Next Steps Integration with SAP Cloud for Customer (C4C) SAP Cloud for Customer (C4C) and SAP Jam Test Script Integration with ABAP SMI Troubleshooting... 23

4 How to set up SAP Jam for Integration with other SAP Solutions 4 1 Introduction 1.1 Business Scenario Integrating SAP Jam with other SAP solutions enables cross-application collaboration using the SAP Jam Feed, and allows users to use the flexibility and freedom of Jam for multiple collaboration scenarios. 1.2 Background Information This document details the steps required to set up SAP Jam in order to enable the integration with other SAP solutions.

5 How to set up SAP Jam for Integration with other SAP Solutions 5 2 Prerequisites SAP Jam An SAP Jam tenant at the same release level as the other SAP Cloud solution has been provisioned for your company, and you have been given administrator access. SuccessFactors Platform (BizX) The instance/ instances have been provisioned and you have access to the below.

6 How to set up SAP Jam for Integration with other SAP Solutions 6 3 Setting up the BizX instance 3.1 Create users in BizX The SuccessFactos BizX platform is the shared user pool for all SuccessFactors modules of a single customer. SAP Jam is (historically seen as) a SuccessFactors solution and therefore also uses the BizX user management. The BizX platform can be seen as the identity provider of SAP Jam. 1. Connect to the SAP SuccessFactors system using an internet browser with your company ID, administration user, and password.

7 How to set up SAP Jam for Integration with other SAP Solutions 7 2. On your Home screen, click on Admin Tools 3. Under Manage Users, choose Employee Export

8 How to set up SAP Jam for Integration with other SAP Solutions 8 4. Select the options Valid users only and Character Encoding as Unicode (UTF-8) and click Export Users. 5. Choose Save as to save the ZIP file to your local drive. 6. Extract the files to a folder and save it. 7. Copy this file (as backup) and open the copied file. 8. Keep the first 2 rows and delete all the other rows in the copied file. 9. Start maintaining the users and use the original file as reference. Maintain the following fields shown in the table, the values shown are example values for your reference. Field Name Value STATUS active USERID DOMDIRECTSALES USERNAME DOMDIRECTSALES FIRSTNAME DOM LASTNAME DIRECTSALES DOM@company.com TITLE DIRECTSALES GENDER M DOM@company.com MANAGER NO_MANAGER HR NO_HR DEPARTMENT IT (IT) JOBCODE IT Manager (IT-MGR) DIVISION Industries (IND) LOCATION Arlington, Virginia (US_DCM) TIMEZONE US/Eastern HIREDATE 02/29/2012 TITLE IT Manager

9 How to set up SAP Jam for Integration with other SAP Solutions 9 ADDR1 33 West St CITY Alexandria STATE Virginia ZIP COUNTRY United States DEFAULT_LOCALE en_us Attention USERID - Common pitfalls. a. The USERID cannot be changed anymore. Take this into account if you have to integrate other systems. b. The USERID is case sensitive. c. Using tools like MS Excel might corrupt the format of your.csv after saving. d. If your USERIDs include leading zeros (for example: E), MS Excel will remove them automatically by default. Uploading the file again will create a new user (USERID = 6372E). e. SSO check is for the USERNAME (which is flexible) instead of the USERID. 10. Save the file and close it.

10 How to set up SAP Jam for Integration with other SAP Solutions In your SuccessFactor s browser, under Manager Users, choose Import Employee Data 12. Scroll down to find the Choose File option and choose Browse 13. Select the file in which you have maintained the users. 14. Select UTF-8 as File Encoding 15. Choose Import to import the data into SUCCESS FACTORS BIZX server.

11 How to set up SAP Jam for Integration with other SAP Solutions Reset user password The next section explains how to reset a password. This is a common admin task and also an easy way to create a system generated onetime password for your newly created user. 1. Navigate back to Admin Tools 2. Under Manager Users, choose Reset User Passwords 3. Choose Reset individual user password to reset the password for the user which you have created just now. 4. Enter DOM as First Name and click Search Users.

12 How to set up SAP Jam for Integration with other SAP Solutions Select the displayed user and click Reset Selected Users Passwords. 6. The selected user gets an with the password

13 How to set up SAP Jam for Integration with other SAP Solutions Grant Permissions to Access In this section, you give the access permission to the BIZX users so that they can access the SAP Jam with their same SuccessFactor s user ID and password. 1. In the Admin Tools page, under Manage Security, choose Permission to Access Jam. 2. Choose Manage permissions through individual users 3. Enter DOM as First Name and click Search Users 4. Select the username and click Grant Permission 5. User is granted the access to SAP Jam and can log on to SAP Jam as soon as the user is available or replicated to SAP Jam. (max. 24h) HINT: If you want to be forwarded to Jam directly without going to BizX, you can add a RelayState parameter to the URL:

14 How to set up SAP Jam for Integration with other SAP Solutions Create another BizX admin If you do not want to use the PSADMIN user all the time, you can grant administrative privileges to another BizX user. 1. In the Admin Tools page, under Manage Security, choose Administrative Privileges. 2. Search for your user and check (at least) the following checkboxes. Remark: This view will show all possible permissions of the whole BizX platform. This guide will not cover how to create a permission concept for an enterprise. We will only explain what to do to get SAP Jam going. A standard SuccessFactors implementation would use a concept called Role Based Permissions (RBP). How to set this up is explained in the RBP-Handbook and should be supported by a PS consultant. 3. Click Save Admin Permission for Selected User. 4. The permissions will be active after the next logon.

15 How to set up SAP Jam for Integration with other SAP Solutions 15 4 Setting up the Jam instance After preparing the BizX platform we are now able to configure the Jam instance. Navigate to Jam by using the drop-down menu on the BizX home screen. 4.1 Create another Jam admin 1. Logon to Jam with a Company Admin user 2. Select Jam Admin in the menu dropdown 3. Search for Users in the left navigation menu 4. Select the user you want to promote 5. Go to Administrator Type and change it to Company Administrator

16 How to set up SAP Jam for Integration with other SAP Solutions Save your changes Remark: Refer to the official Jam handbook for further insights about the different admin levels and administration concepts.

17 How to set up SAP Jam for Integration with other SAP Solutions 17 5 Customizing There are two ways to customize your Jam instance. Since Jam was historically a standalone tool, you can use the internal customizing features (this is not recommended). They are very limited but easy to use. All settings done will only be active in Jam. If you are looking for more advanced ways to customize your instance and to enable a consistent user experience throughout all modules (including Jam), you should use the BizX Theme Manger. 5.1 Customizing your SAP Jam instance via Jam This is the legacy branding feature of SAP Jam. We recommend the use of the BizX branding functionality included in the Theme Manager. If you want to use the legacy branding nevertheless, here is what you need to do. 1. Login to Jam with a Company Admin user 2. Select Jam Admin in the menu dropdown 3. Click Branding 4. If you want to use this (Jam only) branding feature, make sure the checkbox Enable Success Factors Theming is not checked. 5. Go ahead with you customizations

18 How to set up SAP Jam for Integration with other SAP Solutions Customizing your SAP Jam instance via BizX (Theme Manager) Prerequisite: Perform the same steps as those used while customizing your SAP Jam instance via Jam, but make sure the checkbox Enable Success Factors Theming is checked. 1. Switch back to the BizX suite by using the navigation drop down or home icon 2. Go to the Admin Tools (legacy version recommended)

19 How to set up SAP Jam for Integration with other SAP Solutions Search for the Company System and Logo Settings 4. There are two sub-menus, which are of interest to you Upload Company Logo You can customize the login experience by adding your company logo. (This can also be done using the Theme Manager below, which is recommended as best practice). Nevertheless you are also free to change the logo without doing any major theming changes.

20 How to set up SAP Jam for Integration with other SAP Solutions 20 Theme Manager The Theme Manager is a comprehensive customization tool where you can create your own design according to your corporate identity. Themes can be shared throughout all SF modules for a consistent user experience. This guide will not cover how to use it, since is not relevant for integration purposes.

21 How to set up SAP Jam for Integration with other SAP Solutions Customizing notification templates BizX offers the chance to customize your notifications. The following section describes how to implement minor changes. Note that your changes might affect several modules since you are doing the changes on platform level. 1. Login to BizX -> Admin Tools 2. Search for System Properties -> Notification Templates Settings 3. There you will find all templates used by your SuccessFactors instance. As an example, you could look for Welcome Message Notification with Reset Password Support and click on it. 4. On the right side the template will be shown. You can customize it now by adding new content or creating an entire new message. 5. Save your changes Next time the event is triggered you will see the changes you have configured in the relevant template.

22 How to set up SAP Jam for Integration with other SAP Solutions 22 6 Next Steps You are now ready to integrate with other SAP Solutions. Follow the instructions below to integrate with the following products. 6.1 Integration with SAP Cloud for Customer (C4C) If you plan to integrate your SAP Jam instance with SAP Cloud for Customer (C4C), refer to the following guides. Integrate SAP Cloud for Customer and SAP Jam 6.2 SAP Cloud for Customer (C4C) and SAP Jam Test Script Test your configuration SAP Cloud for Customer (C4C) and SAP Jam integration Test Script 6.3 Integration with ABAP SMI If you plan to integrate your SAP Jam instance with ABAP Social Media Integration (ABAP SMI), refer to the following website. Connecting SAP Jam with ABAP SMI

23 How to set up SAP Jam for Integration with other SAP Solutions 23 7 Troubleshooting A Tips and Tricks guide can be found here. (This resource is only available to SAP employees since it might contain sensitive data)