Deploying a help site
You can deploy your help site to your web self-service portal or other web applications. Pega Knowledge automatically generates the required JavaScript and HTML snippets.
Pega Knowledge
Implementation Guide
Pega Knowledge
Implementation Guide
Pega Knowledge
Implementation Guide
- Log in to Pega Knowledge portal.
- Click Knowledge > Help sites.
- Select the help site link you want to publish and click Publish.
- Click Embed site to generate the JavaScript and HTML snippets.
- Follow the instructions provided in the JavaScript code and embed the snippet in the
desired placeholder.
- You can insert the JavaScript code into a .js file on the web server that is serving your targeted self-service web site or other web application. This allows the referencing HTML code visibility when being called. Alternatively, you can embed the JavaScript code directly into the source code of the targeted self-service web pages.
- Insert the HTML code where you want the help site to be called or redirected, such as a button, link, or image. To pass a specific articleID to display upon reaching the help site, insert the related "KC-" article number in the HTML code as the articleID parameter. This is passed with the calling URL and allows the help site to display this specific article once the user reaches the redirected help site.
- To test your code, open the web page that contains the Pega Knowledge code, and click the UI element (button, link, or image) that contains the JavaScript and HTML snippet. You are directed to your help site.
Configuring access to the help site
To configure and provide help site access for external users, follow these steps:
- In the Explorer panel, click App.
- Open PegaFW-KM-Admin-ApplicationSetting class.
- Click Data Model > Data Transform > pyDefault.
- Update the .KMPrefHelpSiteName source column with Organization-helpsite, for example, Uplusbank.
- Click Save to save and update the data transform sources.
Launching the help site
The following information describes the process to launch the deployed help site:
- To launch the help site, identify the details such as host name, IP address, and port details. To launch a particular help site, add the host name, IP address, and port details along with the given help site name to this URL pattern: https://< hostname>:<port> /prweb/PRServletCustom/help/< helpsitename >.
- Another way of launching a help site is by accessing the activity KMDisplayHelpPortal. The KMDisplayHelpPortal activity considers parameters like help site name, status, community site name. This activity can also be used to open a particular article in a given help site or a post in a given community.
Previous topic Publishing a help site Next topic Optional: Configuring Pega Knowledge Self-Service help site URLs