Sap Jam Communities For Hybris Administration Guide

Transcript

SAP Jam Communities for hybris Administration Guide Document Version: February 2016 Release – 2016-03-03 SAP Jam Communities for hybris Administration Guide Content 1 Get started. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 1.1 Welcome to SAP Jam Communities for hybris Administration Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . 3 1.2 SAP Jam Communities for hybris Admin console. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 2 Administration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 2.1 Manage Topics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 2.2 Design your Home Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 2.3 Design the About Page. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 2.4 Configure 3rd Party Analytics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 2.5 Configure Advertising. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 2.6 Configure Moderation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 2.7 Configure Legal notices and Disclosures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 2.8 Configure Branding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26 2.9 Configure Email templates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 2.10 Configure Profile Fields. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 2.11 Configure Permissions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 2.12 View Communities Reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 2.13 Manage your e-commerce integration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 2.14 Configure an OAuth client. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 3 Get support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 3.1 Get help with SAP Jam Communities for hybris. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 2 © 2016 SAP SE or an SAP affiliate company. All rights reserved. SAP Jam Communities for hybris Administration Guide Content 1 Get started 1.1 Welcome to SAP Jam Communities for hybris Administration Guide Introduction SAP Jam Communities for hybris commerce is a new solution offered by SAP that is the first commerceoptimized community. SAP Jam Communities enables B2B and B2C online commerce sites to: ● Enhance product catalog information with authentic community content and peer recommendations to enhance your SAP hybris Commerce investment. ● Drive increased traffic via search-engine-optimized community content and sharing community content in social networks. ● Offer relevant, credible content to instill buying confidence and increase revenue. ● Enable customers to find answers to their questions on their own time and terms. ● Establish emotional relationships to create loyalty. These objectives are met by providing the following capabilities to SAP Jam Communities for hybris commerce users: ● The ability for users to ask questions about any product (topic) listed in hybris. ● The ability for users to discuss any product (topic) listed in hybris. ● The ability for authorized users to write blogs—such as detailed comparisons of similar products, product usage tips, or partial or even full tutorials on the use of the product—about any product (topic) listed in hybris. ● The ability for users to contribute reviews on any product (topic) listed in hybris. ● The ability for users to comment on other user's contributions. ● The ability for users to like other user's contributions. ● The ability for users to follow topics or specific exchanges. ● The ability for users to view a summary of other user's contributions. ● The ability for users to search and find user's contributions. Version and compatibility This document covers the SAP Jam Communities for hybris, version 1.0, which is compatible with hybris v.5.5. SAP Jam Communities for hybris Administration Guide Get started © 2016 SAP SE or an SAP affiliate company. All rights reserved. 3 Requirements The SAP Jam Communities for hybris sample code must be installed on your organization's hybris v.5.5 server and be properly configured, as is described in the SAP Jam Communities for hybris sample code Installation Guide. 1.2 SAP Jam Communities for hybris Admin console SAP Jam Communities for hybris administration is performed in the Admin console. To access the SAP Jam Communities for hybris Admin console 1. As the SAP Jam Communities for hybris administrator, click on your name at the top of any hybris page and select Admin from the context menu. Figure 1: Accessing the Admin console The Admin console is displayed. 4 © 2016 SAP SE or an SAP affiliate company. All rights reserved. SAP Jam Communities for hybris Administration Guide Get started Figure 2: The Admin console SAP Jam Communities for hybris Administration Guide Get started © 2016 SAP SE or an SAP affiliate company. All rights reserved. 5 The SAP Jam Communities for hybris Admin console The SAP Jam Communities for hybris Admin console allows you to design or configure the following: Table 1: The SAP Jam Communities for hybris Admin console The Admin console options are documented in the following pages: Figure 3: The SAP Jam Communities for hybris administrator menu 6 ● Use the Topics [page 7] section to design the layout of the individual "topic", or prod­ uct pages. ● Use the Home Page [page 11] section to design your site's home page. ● Use the About Page [page 14] section to design your site's about page. ● Use the 3rd Party Analytics [page 15] section to configure your on-site, third-party web analytics. ● Use the Advertising [page 17] section to configure your site's advertising sources and placement. ● Use the Moderation [page 19] section to configure, review, and respond to user posts that have been flagged as inappropriate. ● Use the Legal/Disclosures [page 23] section to configure the legal and disclosure noti­ ces that you post in each page's footer. ● Use the Branding [page 26] section to configure the stylistic and branding options of your site. ● Use the Email Designer [page 28] section to configure the stylistic and boilerplate seg­ ments of your site's notification emails to users. ● Use the Profile Fields [page 32] section to configure what fields of information are re­ quired from your users, what information is displayed in their personal profile pages, and what information is deemed private. ● Use the Permissions [page 33] section to give or remove administrator or moderator privileges to users, either throughout your site or per-topic page. ● Use the Reports [page 37] section to download Communities reports, such as monthly and yearly page views, weekly and monthly user returns, number of new users, and num­ ber of new posts. ● Use the E-commerce Integration [page 47] section to synchronize topics data with your e-commerce application and to schedule regular synchronizations. ● Use the OAuth Configuration [page 51] section to establish a trusted connection with an external application by configuring it as an OAuth client, which allow it to connect and exchange data with SAP Jam Communities. © 2016 SAP SE or an SAP affiliate company. All rights reserved. SAP Jam Communities for hybris Administration Guide Get started 2 Administration 2.1 Manage Topics The Admin Topics section allows you to design the layout of the individual "topic", or product pages. 1. Access the Admin console [page 4] and select Topics from the left navigation sidebar. The initial page of the Admin Topics section is displayed. Figure 4: The Topics pages catalog The initial page of the Topics section is a catalog of all previously created topic pages. From this page, you can add a new topic page, or view or edit an existing topic page. To create a new topic page 1. To create a new topic page, click + New Topic at the top of the The Create New Topic page is displayed. SAP Jam Communities for hybris Administration Guide Administration Admin Topics page. © 2016 SAP SE or an SAP affiliate company. All rights reserved. 7 Figure 5: The Create New Topic page 2. In the Topic Name text box, enter the name or title that you want to give the new topic (product) page. This will be displayed as the title of the page. 3. In the Topic Caption text box, enter a short description of the topic page. This page caption can be a maximum of 140 characters. 4. In the Topic Thumbnail panel, either drag and drop an image from your local computer's file manger onto this panel, or click browse in the panel to open your browser's file location and upload dialog box, navigate to the image, and select Upload or whatever the button is labeled in your browser's File upload dialog box. You will be prompted to scale or select the viewable portion of the image if it is larger than the recommended size. Once you set and accept the scale and viewable area (if required), the uploaded image will be displayed in the Topic Thumbnail panel. You can select a different image by clicking Change Photo. 5. In the Select Topic Type panel, click either Engagement or Q&A/Support to set the user subscription option described in those boxes. 6. Optionally, select the Enable advertising check box to have advertisements appear on your topic pages. Note that you must have advertising configured in the properly. Admin Topics section for this option to work 7. Once these options are set to your satisfaction, click Next: Design/Configuration. The second page of the Create New Topic wizard is displayed. 8 © 2016 SAP SE or an SAP affiliate company. All rights reserved. SAP Jam Communities for hybris Administration Guide Administration Figure 6: Edit Topic 8. Add a detailed image to the page in a similar manner to how you added the image in step 3 above. SAP Jam Communities for hybris Administration Guide Administration © 2016 SAP SE or an SAP affiliate company. All rights reserved. 9 9. Optionally, click on the pencil icon below the image to add a description or more detailed commentary to your page. This text input allows unlimited text to be added. 10. Once you have these options set to your satisfaction, click Next: View Topic. A preview of the topic is displayed. Figure 7: Topic preview 11. You have several options at this point: 10 © 2016 SAP SE or an SAP affiliate company. All rights reserved. SAP Jam Communities for hybris Administration Guide Administration 1. You can click Back at the top of the page to return to the previous page(s) to change the settings you made previously. 2. You can click Create New at the bottom left of the page to add another paragraph. Note that this option allows extensive formatting of the text, as well as the addition of more images. 3. You can click Publish Changes at the top of the page to publish your changes. The new topic is created, and you are returned to the will be listed in the Topics table. Admin Topics catalog, where your new topic To edit an existing topic page ● In the Admin Topics page's catalog, click Edit on the row beside the topic that you want to edit. The steps that you can perform here are much the same as those for creating a topic, as described above. To view an existing topic page ● In the Admin Topics page's catalog, click View on the row beside the topic that you want to view. The steps that you can perform here are much the same as those for the view stage of creating a topic, as described above. 2.2 Design your Home Page Design your home page in the Admin Home Page section. 1. Access the Admin console [page 4] and select Home Page from the left navigation sidebar. The Admin Home Page section is displayed. SAP Jam Communities for hybris Administration Guide Administration © 2016 SAP SE or an SAP affiliate company. All rights reserved. 11 Figure 8: The Admin > Home Page section 2. Click View Home Page for a full-page preview of your current home page settings. 3. Click Edit Home Page to modify your home page design. The Edit Home Page page is displayed. 12 © 2016 SAP SE or an SAP affiliate company. All rights reserved. SAP Jam Communities for hybris Administration Guide Administration Figure 9: Edit Home Page 4. Click Change Photo to open the Upload Image dialog box, from which you can browse your device for an image to upload or enter a URL from which an image can be uploaded. 5. Click Toggle Text to toggle the text color of the title between black and white. Select the color that provides the best contrast between your title text and your selected background image. 6. Click on the pencil icon beside the title to change the Home Page title. 7. Click on the pencil icon beside the text below the banner image to change the Home Page descriptive text. 8. Click on the pencil icon beside the text near the bottom of the Home Page form, but above the footer section, to add or modify a paragraph of text at the end of the page. If you click on either the footer text pencil icons (steps 7 or 8), a simple rich text editor displays in which you can enter and format the text that you want to appear in these locations. Figure 10: The "footer" rich text editor 9. Your changes are saved as you work, so when you are satisfied with the look of the page, you can navigate to your next task. Your changes will be saved, and the Home Page will show your changes. SAP Jam Communities for hybris Administration Guide Administration © 2016 SAP SE or an SAP affiliate company. All rights reserved. 13 2.3 Design the About Page Design your "about" page in the Admin About Page section. 1. Access the Admin console [page 4] and select About Page from the left navigation sidebar. The Admin About Page section is displayed. Figure 11: The About Page section 2. Click View About Page for a full-page preview of your current about page settings. 3. Click Edit About Page to modify your home page design. The Edit About Page page is displayed. 14 © 2016 SAP SE or an SAP affiliate company. All rights reserved. SAP Jam Communities for hybris Administration Guide Administration Figure 12: The About Page Designer 4. Click Change Photo to open the Upload Image dialog box, from which you can browse your device for an image to upload or enter a URL from which an image can be uploaded. 5. Click Toggle Text to toggle the text color of the title between black and white. Select the color that provides the best contrast between your title text and your selected background image. 6. Click the pencil icon below the banner image to set a paragraph of text. 7. Click View About Page. Your changes will be saved and published. 8. In the About Page preview, you can click Edit About Page if you want to make further, or you can navigate to another page if no further changes are required and your changes will be saved. 9. Your changes are saved as you work, so when you are satisfied with the look of the page, you can navigate to your next task. Your changes will be saved, and the Home Page will show your changes. 2.4 Configure 3rd Party Analytics If you want to use a third-party analytics service to track your users' usage of your SAP Jam Communities for hybris site, you can configure your on-site, third-party web analytics in the section. SAP Jam Communities for hybris Administration Guide Administration Admin 3rd Party Analytics © 2016 SAP SE or an SAP affiliate company. All rights reserved. 15 To register a third-party web analytics service 1. Access the Admin console [page 4] and select 3rd Party Analytics from the left navigation sidebar. The Admin 3rd Party Analytics section is displayed. Figure 13: The 3rd Party Analytics section 2. Click the Analytics Provider drop-down menu to select your analytics provider. Currently, the options are: ○ Google Analytics: To configure this option, enter your Google Analytics Tracking ID in the text box. Figure 14: The "Google Analytics" configuration option ○ Adobe Analytics: To configure this option, enter the following information, which you should have received from Adobe: ○ Adobe Analytics Report Suite ID: the ID of your Adobe Analytics report suite. ○ Adobe Analytics Organization ID: your organization's ID with Adobe Analytics. ○ Adobe Analytics Tracking Server: the URL of your organization's analytics tracking server. 16 © 2016 SAP SE or an SAP affiliate company. All rights reserved. SAP Jam Communities for hybris Administration Guide Administration Figure 15: The "Adobe Analytics" configuration options 3. Once you have set the required options, click Submit. Your analytics service is registered, and analysis is enabled. To de-register a third-party web analytics service 1. In the Analytics Provided drop-down menu, select No Provider. 2. Click Submit. Your analytics service is deregistered, and analysis that includes your SAP Jam Communities pages is disabled. 2.5 Configure Advertising Configure advertising in your SAP Jam Communities for hybris site in the Admin Advertising section. 1. Access the Admin console [page 4] and select Advertising from the left navigation sidebar. The Admin Advertising section is displayed. SAP Jam Communities for hybris Administration Guide Administration © 2016 SAP SE or an SAP affiliate company. All rights reserved. 17 Figure 16: The Admin > Advertising section 2. In the Embedding Content ID section, select the advertisements service that you want to use, and enter your advertisements content ID. Note Currently, Google AdSense is the only service that is supported. 3. Optionally, in the Top Banner section, select the advertisements service that you want to use, and enter your content ID number for that format of advertisements (728px wide by 90px high). Note Currently, Google AdSense is the only service that is supported. 4. Optionally, in the Side Banner section, select the advertisements service that you want to use, and enter your content ID number for that format of advertisements (300px wide by 250px high). Note Currently, Google AdSense is the only service that is supported. 5. When you have set these options to your satisfaction, click Save. Your advertisements for the configured locations are enabled and will appear in the preconfigured locations in your hybris site's pages. Note You must have configured the Embedding Content ID and at least one of the location options (Top Banner or Side Banner) for advertisements to appear. 18 © 2016 SAP SE or an SAP affiliate company. All rights reserved. SAP Jam Communities for hybris Administration Guide Administration 2.6 The Configure Moderation Admin Moderation section allows you to: ● Set the number of "inappropriate" flags a post must receive before the post is automatically removed from view. Note that posts that receive any "inappropriate" flags are immediately shown in the Flagged Posts tab of this page, no matter what value is set in this option. ● Review and take action on flagged posts. ● Review permanently removed posts to evaluate user behavior. To set the Flag Threshold 1. Access the Admin console [page 4] and select Moderation from the left navigation sidebar. The Admin Moderation section is displayed. Figure 17: The Admin > Moderation section SAP Jam Communities for hybris Administration Guide Administration © 2016 SAP SE or an SAP affiliate company. All rights reserved. 19 To set the Flag Threshold 1. In the Admin Moderation section, click the Moderation Threshold tab. The Moderation Threshold tab is displayed. Figure 18: The Admin > Moderation page's "Moderation Threshold" tab 2. In the Flag Threshold text box, enter the number of inappropriate flags that a post must receive before it will be removed from view and click Save. The Flag Threshold value will be saved and it will be used to determine how many inappropriate flags a post must receive to be removed from view. To review and respond to flagged posts 1. In the Admin Moderation section, click the Flagged Posts tab. A table of flagged posts is displayed, with one flagged post per row. Note that posts that receive any "inappropriate" flags are immediately shown in this tab. Figure 19: The Admin > Moderation section's Flagged Posts tab 2. Click on the text of the flagged post to view the complete post. A preview of the flagged post is displayed. 20 © 2016 SAP SE or an SAP affiliate company. All rights reserved. SAP Jam Communities for hybris Administration Guide Administration Figure 20: The Flagged Post preview 3. Click on the down arrow beside the "flagged" indicator for a list of your possible responses to the post. Your options are: ○ Feature this conversation or Mark as best answer: (The label of this option will change, depending on whether it was a discussion, a question, or an answer.) Select this option if you find the content of the post to be not only acceptable, but worthy of being brought to the attention of your other users, or of being marked as the best answer to the original question. ○ Reinstate this content: Select this option if you find the content of the flagged post to be acceptable. Note that you can respond to the post before reinstating it. ○ Permanently Remove: Select this option if you agree that the content of the post is unacceptable and you want to remove it from view by your other users. If you choose this option, you will be shown a dialog box that will allow you to take further action: Figure 21: Remove Post dialog box ○ You can also Remove all posts by the same user. ○ You can also Ban the user. ○ Edit: Select this option if you think that this content is acceptable with a minor modification, such as removing an offensive word or phrase. You can then reinstate the content. SAP Jam Communities for hybris Administration Guide Administration © 2016 SAP SE or an SAP affiliate company. All rights reserved. 21 To review all permanently removed posts When posts are permanently removed, their content is deleted, but a record of the text of the post and the identity of the user who wrote it are retained. Those records are listed in the table of this tab for future review of the removed posts so that the behavior of offenders can be evaluated over the longer term of your site's operation. 1. In the Admin Moderation section, click the Permanently Removed Posts tab. A table of the permanently removed posts is displayed, with one removed post per row. Figure 22: The Admin > Moderation section's Permanently Removed Posts tab To configure profanity blocking When posts are permanently removed, their content is deleted, but a record of the text of the post and the identity of the user who wrote it are retained. Those records are listed in the table of this tab for future review of the removed posts so that the behavior of offenders can be evaluated over the longer term of your site's operation. 1. In the Admin Moderation section, click the Profanity Blocker tab. The Profanity Blocker tab displays. 22 © 2016 SAP SE or an SAP affiliate company. All rights reserved. SAP Jam Communities for hybris Administration Guide Administration Figure 23: The Admin > Moderation page's Profanity Blocker tab (disabled) 2. If disabled, click Enable Profanity Blocker. The profanity blocker controls display. Figure 24: The Admin > Moderation page's Profanity Blocker tab (enabled) 3. To upload an initial set of profane terms, create a comma-separated values file, and then upload it by clicking Import CSV and using your browser's file locate and upload features. 4. To update an existing set of profane terms, click Download CSV, then update the CSV file, which will download using your browser's file download feature, and then upload the updated CSV file by clicking Import CSV and using your browser's file locate and upload features. 5. Optionally, to disable profanity blocking, click the Disable Profanity Blocker button. 2.7 Configure Legal notices and Disclosures Footer Links & Details Set the legal and disclosure notices that you want displayed in your SAP Jam Communities for hybris site in the Admin Legal/Disclosures section. 1. Access the Admin console [page 4] and select Legal/Disclosures from the left navigation sidebar. SAP Jam Communities for hybris Administration Guide Administration © 2016 SAP SE or an SAP affiliate company. All rights reserved. 23 The Admin Legal/Disclosures section is displayed. Figure 25: The Admin > Legal/Disclosures section 2. Optionally, in the Footer text box, enter the copyright or other information that you want displayed at the bottom of each page of your SAP Jam Communities for hybris site. Alternatively, leave this text box empty if you do not want to display a text message at the bottom of each page. 3. Optionally, in the Terms of Use text box, enter the URL to the "terms of use" agreement for your SAP Jam Communities for hybris site. If set, a "Terms of Use" link will be displayed below the footer text on each page of your SAP Jam Communities for hybris site. Alternatively, leave this text box empty if you do not want to display a Terms of Use link at the bottom of each page. 4. Optionally, in the Privacy Policy text box, enter the URL to the "privacy policy" for your SAP Jam Communities for hybris site. If set, a "Privacy Policy" link will be displayed below the footer text on each page of your SAP Jam Communities for hybris site. Alternatively, leave this text box empty if you do not want to display a Privacy Policy link at the bottom of each page. 24 © 2016 SAP SE or an SAP affiliate company. All rights reserved. SAP Jam Communities for hybris Administration Guide Administration 5. Optionally, in the Imprint text box, enter the URL to a page of information about your SAP Jam Communities for hybris site. If set, an "Imprint" link will be displayed below the footer text on each page of your SAP Jam Communities for hybris site. 6. Optionally, in the Contact Us text box, enter the URL for the "Contact us" page for your SAP Jam Communities for hybris site. If set, a "Contact Us" link will be displayed below the footer text on each page of your SAP Jam Communities for hybris site. Alternatively, leave this text box empty if you do not want to display a Contact Us link at the bottom of each page. 7. Optionally, to see what your changes will look like, click Preview. A dialog box is displayed with your changes shown. 8. When you have set these options to your satisfaction, click Publish. Your changes will be saved and displayed in the pages of your SAP Jam Communities for hybris site. Note The links must use either the http or https protocol, and the URL must be sufficient to access a publicly accessible HTML page with the appropriate content. The labels for each text box indicate the hyperlink text that will be shown in the footer. HTML tags are not permitted, so the link text cannot be changed. Cookies, Terms of Use, and Privacy Policy Message When users first log in to a SAP Jam Communities for hybris site, a notification is displayed at the bottom of their browser window prompting them to read and accept the site's Terms of Use and Privacy Policy. To display that message to users again: 1. Click on the Show Message button at the bottom of the A confirmation dialog box is displayed. Admin Legal/Disclosures page. Figure 26: Confirmation dialog box 2. Click Proceed to have the notification displayed to users again. The message is displayed to users again, until they click on the I Acknowledge and Accept button in that notification banner. SAP Jam Communities for hybris Administration Guide Administration © 2016 SAP SE or an SAP affiliate company. All rights reserved. 25 2.8 Configure Branding You can use the Admin Branding section to set the styles of most elements of the SAP Jam Communities for hybris site to match your company's branding. 1. Access the Admin console [page 4] and select Branding from the left navigation sidebar to configure the style options. The Admin Branding page is displayed. Figure 27: Admin > Branding: Change Logo, Fonts, Link Colors, and Header Titles options 2. In the Change Logo section, click Browse your device to find the logo that you want to use on your local computer or other device, set the area of the image to be used in the selection preview of the image, and click Select Image. The selected area of the selected image will be used as the logo on your SAP Jam Communities for hybris site. The suggested formats are .jpg, .png, and .bmp, and the optimum size of the original image is any image with a 1:1.5 aspect ratio, with a 53px width by a 35px height being the currently displayed logo dimensions. 3. In the Fonts section, select the font that you want to use as the base body font in your SAP Jam Communities for hybris site. 4. In any of the color selection options—Link Colors, Header Titles, Button Colors, Lines Colors, Top Navigation Bar, Banner, or Sub Navigation—either click the color patch button and select the color that you want applied 26 © 2016 SAP SE or an SAP affiliate company. All rights reserved. SAP Jam Communities for hybris Administration Guide Administration to that element, or paste the hexidecimal value for the color that you want to use in the text box for that element in the format #rrggbb. Figure 28: Admin > Branding: Buttons, Lines, and Top Navigation options Note In the Top Navigation Bar section, the Header Top Keyline option refers to the full page width line above the top navigation bar at the very top of each page in your SAP Jam Communities for hybris site. 5. In the Favicon section, enter a publicly accessible URL to the icon that you want to use as your SAP Jam Communities for hybris site favicon. Note This URL must be accessible from your end users' browsers. SAP Jam Communities for hybris Administration Guide Administration © 2016 SAP SE or an SAP affiliate company. All rights reserved. 27 Figure 29: Admin > Branding: Banner, Sub Navigation, and Favicon options 6. You now have several options: ○ Click Reset to Default to set all Branding options to the initial SAP Jam Communities for hybris defaults. Note Selecting this option cannot be "undone", so take note of any changed settings that you want to restore before selecting this option. ○ Click Preview to view an example page of the settings that you have made. ○ Click Publish to save the settings that you have made and to publish these changes. 2.9 Configure Email templates The Admin Email Designer section allows you to alter the style and layout of the email notifications sent from your SAP Jam Communities for hybris site to your end users. To modify the email template 1. Access the Admin console [page 4] and select Email Designer from the left navigation sidebar. The Admin settings. 28 Email Designer section is displayed, showing a preview of your current email template © 2016 SAP SE or an SAP affiliate company. All rights reserved. SAP Jam Communities for hybris Administration Guide Administration Figure 30: The Admin > Email Designer section (template preview) 2. Click Edit Email Template to make modifications to the email. The Edit Email Template page is displayed. SAP Jam Communities for hybris Administration Guide Administration © 2016 SAP SE or an SAP affiliate company. All rights reserved. 29 Figure 31: The Edit Email Template page 3. Hover over the segment of the email template that you want to change and click Edit in the upper-right corner of that segment. 30 © 2016 SAP SE or an SAP affiliate company. All rights reserved. SAP Jam Communities for hybris Administration Guide Administration Figure 32: The Edit Email Template page (editing interface) The segments that you can edit are: ○ The Email Background segment. A Custom CSS text box will appear in the right sidebar, showing the options for this segment. ○ The Content Background segment. (This is also the Content Area segment.) A Custom CSS text box will appear in the right sidebar, showing the options for this segment. ○ The Content Header segment. HTML and Plain Text text boxes will appear in the right sidebar, showing the options for this segment. ○ The Content Footer segment. HTML and Plain Text text boxes will appear in the right sidebar, showing the options for this segment. ○ The Copyright/Disclaimer/Terms of Service segment. HTML and Plain Text text boxes will appear in the right sidebar, showing the options for this segment. 4. Make the changes that you want for the selected segment. 5. Repeat for each segment. 6. At this point, you have several options: ○ Click Cancel to reverse the changes that you have made. ○ Click Reset to revert to the default settings of the SAP Jam Communities for hybris Email Templates. ○ Click Preview to view an example HTML or Plain Text email, showing the modifications that you have made. ○ Click Publish to save your changes and to have them applied to all email notification sent out from this time forward. SAP Jam Communities for hybris Administration Guide Administration © 2016 SAP SE or an SAP affiliate company. All rights reserved. 31 2.10 Configure Profile Fields Set the fields of information in the Admin Profile Fields section that will be: ● Displayed on your users' profile pages ● Required from your users ● Public or hidden To set your users' profile fields 1. Access the Admin console [page 4] and select Profile Fields from the left navigation sidebar. The Admin Profile Fields section is displayed. Figure 33: Profile Fields (first half) Each row in this table represents an available field of information. 2. For each field in the table, you can set the following options: ○ Select available on profile to have this field of information displayed in a user's profile page. ○ Select required to require that users provide this information in order to enable their accounts. 32 © 2016 SAP SE or an SAP affiliate company. All rights reserved. SAP Jam Communities for hybris Administration Guide Administration ○ Select public to allow the display of this field of information to any user of your SAP Jam Communities for hybris site. Note By ensuring that this option is NOT selected, this field of information will be available only to SAP Jam Communities for hybris administrators. 3. The available fields are shown in the preceding and following diagrams. Figure 34: Profile Fields (second half) 4. When you have set these options to your satisfaction, click Save. 2.11 The Configure Permissions Admin Permissions section allows you to: ● Grant administrator or moderator privileges to SAP Jam Communities for hybris users ● Delete a user account ● Set administrator or moderator privileges to SAP Jam Communities for hybris users on a per-topic basis SAP Jam Communities for hybris Administration Guide Administration © 2016 SAP SE or an SAP affiliate company. All rights reserved. 33 To access the SAP Jam Communities for hybris Permissions section 1. Access the Admin console [page 4] and select Permissions from the left navigation sidebar. The Admin Permissions section is displayed. Figure 35: The Admin > Permissions page 2. To give a member administrator privileges, do the following: 1. In the Admin Permissions The Network tab is displayed. section, click the Network tab. 2. In the Network tab, click Administrators. The Administrators panel is displayed. 3. Click Add Member. The Add People to Network Administrator Group dialog box is displayed. Figure 36: The Add People to Network Administrator Group dialog box 4. Type the user's name that you want to give administrator privileges to into the text box, and click Add. You are returned to the Admin Permissions Network Administrators that you just gave administrator privileges to is listed in the panel. panel, and the member 3. To remove administrator privileges from a user, click the garbage can icon beside their name in the Permissions 34 Network Administrators © 2016 SAP SE or an SAP affiliate company. All rights reserved. Admin panel. SAP Jam Communities for hybris Administration Guide Administration The user is no longer listed in the panel and their administrator privileges are removed. 4. To give a member moderator privileges, do the following: 1. In the Admin Permissions The Network tab is displayed. section, click the Network tab. 2. In the Network tab, click Moderators. The Moderators panel is displayed. Figure 37: The Admin > Permissions > Network > Moderators page 3. Click Add. The Add People to Network Moderator Group dialog box is displayed. Figure 38: The Add People to Network Moderator Group dialog box 4. Type the user's name that you want to give moderator privileges to into the text box, and click Add. You are returned to the Admin Permissions Network you just gave moderator privileges to is listed in the panel. Moderators panel, and the member that 5. To remove moderator privileges from a user, click the garbage can icon beside their name in the Admin Permissions Network Moderators page. The user is removed from the panel and their moderator privileges are removed. 6. To grant a user Administrator status for just one topic, do the following: 1. In the Admin Permissions The Topic tab is displayed. SAP Jam Communities for hybris Administration Guide Administration section, click the Topic tab. © 2016 SAP SE or an SAP affiliate company. All rights reserved. 35 2. In the Topic tab, click Administrators. The Administrator panel is displayed. Figure 39: The Admin > Permissions > Topic > Administrators page 3. In the bottom left drop-down menu, select the topic page for which you want to grant a user administrator privileges. 4. Click Add Member. The Add People to Topic Administrator Group dialog box is displayed. 5. Type the user's name that you want to give administrator privileges to into the text box, and click Add. You are returned to the Admin Permissions Topic Administrators panel, and the member that you just gave administrator privileges to is listed as an administrator for the selected topic. 7. To remove administrator privileges from a user for just one topic, click the garbage can icon beside their name in the Admin Permissions Topic Administrators panel. The user is removed from the panel and their administrator privileges are removed. 8. To grant a user Moderator status for just one topic, do the following: 1. In the Admin Permissions The Topic tab is displayed. section, click the Topic tab. 2. In the Topic tab, click Moderators. The Moderators panel is displayed. 36 © 2016 SAP SE or an SAP affiliate company. All rights reserved. SAP Jam Communities for hybris Administration Guide Administration Figure 40: The Admin > Permissions > Topic > Moderators page 3. In the bottom left drop-down menu, select the topic page for which you want to grant a user moderator privileges. 4. Click Add Member. The Add People to Topic Moderator Group dialog box is displayed. 5. Type the user's name that you want to give moderator privileges to into the text box, and click Add. You are returned to the Admin Permissions Topic Moderators panel, and the member that you just gave moderator privileges to is listed as a moderator for the selected topic. 9. To remove moderator privileges from a user for just one topic, click the garbage can icon beside their name in the Admin Permissions Topic Moderators panel. The user is removed from the panel and their moderator privileges are removed. 2.12 View Communities Reports SAP Jam Communities for hybris reports display information on page views in the selected period in the Reports Admin section. To view a report 1. Access the Admin console [page 4] and select Reports from the left navigation sidebar. The Admin Reports page is displayed. SAP Jam Communities for hybris Administration Guide Administration © 2016 SAP SE or an SAP affiliate company. All rights reserved. 37 Figure 41: SAP Jam Communities for hybris Reports: weekly site-wide page views 2. Select the tab for the type of report, the particular report, and the time period that you want to view. Report Descriptions ● The Key Charts section provides the following reports: ○ Page Views: A bar graph showing the total number of page visits for the entire site in the selected time period. Selectable time periods are "Daily", "Weekly", "Monthly", and "Yearly". Note This report is shown in the screen capture above. ○ Popular content: Two pie charts showing proportions of the total for the top 10: ○ Conversations with Most Views: Percentage values and actual number of views are shown for each of the top 10 Conversations. Also, a count of the total page views for all conversations is shown. 38 © 2016 SAP SE or an SAP affiliate company. All rights reserved. SAP Jam Communities for hybris Administration Guide Administration ○ Topics with Most Views: Percentage values and actual number of views are shown for each of the top 10 Topics. Also, a count of the total page views for all Topics is shown. Selectable time periods for the two pie charts are the "Last 7 Days" or the "Last 30 Days". Figure 42: The "Key Charts > Popular Content" report ○ Responsiveness: A pie chart showing an elapsed time between the first post and the response to that post that: ○ Received a response in less than 30 minutes. SAP Jam Communities for hybris Administration Guide Administration © 2016 SAP SE or an SAP affiliate company. All rights reserved. 39 ○ Received a response in more than 1 day. Percentages are shown for each of these pie chart segments. Figure 43: The "Key Charts > Responsiveness" report ● The Traffic section provides the following reports: ○ Returning Users: Shows a pair of bar graphs for showing the count of "Registered Users" and "Anonymous Users" for each unit of time in the time period covered. Selectable time units are "Daily", "Weekly", "Monthly", and "Yearly". The time period covered is shown below the graph. 40 © 2016 SAP SE or an SAP affiliate company. All rights reserved. SAP Jam Communities for hybris Administration Guide Administration Figure 44: The "Traffic > Returning Users" report ○ Referrers: A pie chart showing the proportions of page visit referrals for the selected time period that are: ○ Default, which are page visits from another page in the SAP hybris/Communities site. ○ Google, which are page visits from Google.com. ○ Direct, which are page visits from other external sources. A count of the Total page Visits is shown below the pie chart. The selectable time periods are the "Last 7 Days" or the "Last 30 Days". SAP Jam Communities for hybris Administration Guide Administration © 2016 SAP SE or an SAP affiliate company. All rights reserved. 41 Figure 45: The "Traffic > Referrers" report ● The Business Value section provides the following reports: ○ Community CTA: The total number of Call to Action widget clicks in the SAP Jam Community pages for each week or month in the selected time period. ○ Hybris CTA: The total number of Call to Action widget clicks in the SAP hybris pages for each week or month in the selected time period. The range of time covered is shown below the graph. The selectable time periods are "Weekly" or "Monthly". 42 © 2016 SAP SE or an SAP affiliate company. All rights reserved. SAP Jam Communities for hybris Administration Guide Administration Figure 46: The "Business Value > Community CTA" report ● The Liveliness section provides the following report: ○ New posts across all topics: Counts of the number of new posts for each of the top 10 topics that were posted by general users, administrators, and moderators. SAP Jam Communities for hybris Administration Guide Administration © 2016 SAP SE or an SAP affiliate company. All rights reserved. 43 Figure 47: The "Liveliness" report ● The Members section provides the following reports: ○ New Registered Users: A bar graphs showing the number of newly registered users for each unit of time in the selected range. Selectable ranges are "Daily", "Weekly", "Monthly", or "Yearly". The range of time covered is shown below the graph. 44 © 2016 SAP SE or an SAP affiliate company. All rights reserved. SAP Jam Communities for hybris Administration Guide Administration Figure 48: The "Members > New Registered Users" report ○ Posts Growth: A series of three bar graphs showing the number of newly registered users for each time period in the selected range with: ○ 0 posts ○ 1 post ○ more than 1 post Selectable ranges are Weekly, Monthly, and Yearly. The range of time covered is shown below the graph. SAP Jam Communities for hybris Administration Guide Administration © 2016 SAP SE or an SAP affiliate company. All rights reserved. 45 Figure 49: The "Members > Posts Growth" report ● The Interaction section provides the following report: ○ Unique Participants in Topics: Two line graphs showing: ○ The number of Unique Participants in each of the top 10 products. ○ The number of Posts in each of the top 10 products. 46 © 2016 SAP SE or an SAP affiliate company. All rights reserved. SAP Jam Communities for hybris Administration Guide Administration Figure 50: The "Interaction > Unique Participants in Topics" report 2.13 Manage your e-commerce integration The Admin E-commerce Integration section allows you to manually synchronize topic data with your integrated e-commerce application and to schedule regular synchronizations. To configure your e-commerce integration This configuration is required to integrate your e-commerce application with SAP Jam Communities the topic and related data must be synchronized between the two for them to be able to work together. 1. Access the Admin console [page 4] and select E-commerce Integration from the left navigation sidebar. The initial page of the Admin SAP Jam Communities for hybris Administration Guide Administration E-commerce Integration section is displayed. © 2016 SAP SE or an SAP affiliate company. All rights reserved. 47 Figure 51: The E-commerce Integration configuration page 2. Fill in the following information: ○ Title: Enter a meaningful title for your configuration. ○ Base URL: Enter the base URL of your e-commerce service. ○ Base Web Prefix URL: Enter the base web prefix URL for your Communities store front. ○ Base Products API: Enter the base product API search URL. ○ Base Product API: Enter the Communities base product API URL. ○ On Demand Sync: Set this toggle left to enable on-demand synchronizations for this configuration; set it to the right to disable on-demand synchronizations. Disable this option for a configuration that you intend to schedule for regular, automated topic and data synchronizations. 3. To test your configuration, click Sync. A message displays at the top of the page indicating the outcome of your synch operation. 4. To save your configuration, click Save. A message displays at the top of the page indicating the outcome of your save operation. To schedule a regular synchronization between SAP hybris and SAP Jam Communities 1. Access the Admin console [page 4], select E-commerce Integration from the left navigation sidebar, and scroll down to view the area below the Sync configuration section. 48 © 2016 SAP SE or an SAP affiliate company. All rights reserved. SAP Jam Communities for hybris Administration Guide Administration You see the Schedule Configuration and Synchronization History sections. Figure 52: The "Schedule Configuration" section 2. Click New Schedule. The New Schedule configuration form displays. Figure 53: The "New Schedule" configuration form 3. In the New Schedule configuration form, set the Frequency of your scheduled synchronization by selecting either Yearly, Monthly, Weekly, Daily, or Hourly. 4. Set the Time at which the scheduled synchronization occurs by entering the Day, Hour, and Minute at which you want the synchronization to occur. 5. Once these options are set to your satisfaction, click Save. Your scheduled synchronization is saved and will run on the days, times, and at the frequency that you have set. SAP Jam Communities for hybris Administration Guide Administration © 2016 SAP SE or an SAP affiliate company. All rights reserved. 49 To review past synchronizations 1. Access the Admin console [page 4], select E-commerce Integration from the left navigation sidebar, and scroll down to view the area below the Sync configuration and the Schedule Configuration sections. You see the Synchronization History section, which is a table that shows a row for each recent synchronization, with the following columns of information: ○ Last Sync: shows the date and time of the synchronization. ○ Status: shows whether the synchronization "Completed" or "Failed". ○ Duration: shows the time that it took to complete the synchronization operation. Figure 54: The "Synchronization History" section 2. Optionally, click Re-Sync to re-run the synchronization. 3. Optionally, click the synchronization name in the Config column to view a pop-up dialog box that shows the details of the synchronization configuration. The Synchronization History dialog box displays, showing the configuration options that were set for that operation, as shown in the image below. 50 © 2016 SAP SE or an SAP affiliate company. All rights reserved. SAP Jam Communities for hybris Administration Guide Administration Figure 55: The "Synchronization History" dialog box 2.14 Configure an OAuth client The Admin OAuth Configuration section allows you to establish trust with an external application to allow that application to exchange data with SAP Jam Communities. 1. Access the Admin console [page 4] and select OAuth Configuration from the left navigation sidebar. The initial page of the Admin SAP Jam Communities for hybris Administration Guide Administration OAuth Configuration page displays. © 2016 SAP SE or an SAP affiliate company. All rights reserved. 51 Figure 56: The OAuth Configuration page The initial view of the OAuth Configuration page shows a catalog of all previously created OAuth configurations. From this page, you can add a new OAuth configuration, or view or edit an existing OAuth configuration. To create a new OAuth configurations 1. To create a new topic page, click New Application at the top of the The New Application form displays. 52 © 2016 SAP SE or an SAP affiliate company. All rights reserved. Admin OAuth Configuration page. SAP Jam Communities for hybris Administration Guide Administration Figure 57: The add a "New Application" form 2. In the Name text box, enter a recognizable name for the external application that you want to allow to exchange data with SAP Jam Communities. This will be displayed as the title of the configuration in the catalog. 3. In the Callback text box, enter the URL to the callback script of external application. 4. When both fields are set to your satisfaction, click Save. The form closes, the new configuration is displayed in the catalog, and the external application that you configured will now be able to interact with SAP Jam Communities. To view an existing OAuth Configuration's information ● In the Admin OAuth Configuration page's catalog, click the name of the configuration in the Name column. The OAuth Application Id and Secret for the external application display. SAP Jam Communities for hybris Administration Guide Administration © 2016 SAP SE or an SAP affiliate company. All rights reserved. 53 Figure 58: The external application's OAuth "Application Id" and "Secret" To edit an existing OAuth Configuration 1. In the Admin OAuth Configuration page's catalog, click Edit on the row beside the OAuth configuration that you want to modify. The Edit OAuth configuration form displays. 54 © 2016 SAP SE or an SAP affiliate company. All rights reserved. SAP Jam Communities for hybris Administration Guide Administration Figure 59: The "Edit" OAuth configuration form 2. Change the Name or Callback URL as required. 3. When both fields are set to your satisfaction, click Save. The form closes, the modified configuration is displayed in the catalog, and the external application that you configured will now be able to interact with SAP Jam Communities. SAP Jam Communities for hybris Administration Guide Administration © 2016 SAP SE or an SAP affiliate company. All rights reserved. 55 3 Get support 3.1 Get help with SAP Jam Communities for hybris To file a SAP Jam Communities for hybris support request, please see: https://support.sap.com . Customer support for SAP Jam Communities is provided by LOD-COM. 56 © 2016 SAP SE or an SAP affiliate company. All rights reserved. SAP Jam Communities for hybris Administration Guide Get support Important Disclaimers and Legal Information Coding Samples Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, unless damages were caused by SAP intentionally or by SAP's gross negligence. Accessibility The information contained in the SAP documentation represents SAP's current view of accessibility criteria as of the date of publication; it is in no way intended to be a binding guideline on how to ensure accessibility of software products. SAP in particular disclaims any liability in relation to this document. This disclaimer, however, does not apply in cases of wilful misconduct or gross negligence of SAP. Furthermore, this document does not result in any direct or indirect contractual obligations of SAP. Gender-Neutral Language As far as possible, SAP documentation is gender neutral. Depending on the context, the reader is addressed directly with "you", or a gender-neutral noun (such as "sales person" or "working days") is used. If when referring to members of both sexes, however, the third-person singular cannot be avoided or a gender-neutral noun does not exist, SAP reserves the right to use the masculine form of the noun and pronoun. This is to ensure that the documentation remains comprehensible. Internet Hyperlinks The SAP documentation may contain hyperlinks to the Internet. These hyperlinks are intended to serve as a hint about where to find related information. SAP does not warrant the availability and correctness of this related information or the ability of this information to serve a particular purpose. SAP shall not be liable for any damages caused by the use of related information unless damages have been caused by SAP's gross negligence or willful misconduct. All links are categorized for transparency (see: http://help.sap.com/disclaimer). SAP Jam Communities for hybris Administration Guide Important Disclaimers and Legal Information © 2016 SAP SE or an SAP affiliate company. All rights reserved. 57 go.sap.com/registration/ contact.html © 2016 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. The information contained herein may be changed without prior notice. 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 or its affiliated companies shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP 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. 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. All other product and service names mentioned are the trademarks of their respective companies. Please see http://www.sap.com/corporate-en/legal/copyright/ index.epx for additional trademark information and notices.