Enabling the Search Portlet and Link

You can begin using the PeopleSoft Online Help website as soon as it is installed. However, to make full-text searching available to users you need to set up the user interface to display the Search portlet and the Search link in the universal navigation header.

To enable full-text searching:

1. Crawl the help files to generate a full-text search index, if you haven’t already.

   If you are using Oracle Secure Enterprise Search, see PeopleTools Installation for your database platform, ”Installing PeopleSoft Online Help.” If you use a different search engine, see the documentation for your chosen search engine.

2. Modify the docroot/js/common.js file to set the following variables, which are used to generate the search engine URL that the help site uses:

   Field or Control	Definition
   searchURL	Enter the URL for the search home page. In Secure Enterprise Search, this is the URL for the search source group that you created when you crawled the help files to generate a full-text search index.
   searchOpt	Enter optional parameters that are appended to the URL that is generated from the values of the searchURL, queryTextParamName, and the text that the user enters in the Search field. For example, if you are using Secure Enterprise Search, you can specify source groups to search. To do this, enter group=SourceGroupName, where SourceGroupName represents the name of the source group in Secure Enterprise Search. Always enter a name and value pair (for example, field1=value1). To add multiple values, separate the name and value pairs with ampersands (for example, field1=value1&field2=value2&field3=value3). Note: For more information on adding multiple source groups, see Including External Documentation in Full-Text Search Results.
   queryTextParamName	Enter the parameter name for the search text. If you are using Secure Enterprise Search, enter the lowercase letter q.
   advancedSearchURL	Enter the URL for the advanced search page. This may be the same as the search home page that you specify for searchURL.

   The following example shows the common.js file with values added for the search variables (highlighted in bold).

   Note: The file contains sample values as comments (preceded by //) for each variable.

   /**  
   * common.js  
   **/ 
   var searchURL = "http://example.com:7777/search/query/";          //http://host:port/search/query
   var altHelpURL = "";         //http://www.oracle.com/pls/topic/lookup?id=%CONTEXT_ID%&ctx=hr91fp1
   var searchOpt = "group=pt853";          //group=pt853
   var queryTextParamName = "q"; //q
   var advancedSearchURL = "http://example.com:7777/search/query?group=pt85";  //http://host:port/search/query?group=pt85

var searchURL = "http://host:port/search/query"; 
var searchOpt = "group=pt853&search_p_atname=Host&search_p_op=contains&search_p_val=abc6110000"; 
var queryTextParamName = "q";