About the Configurable Search Webform

When defining a configurable search webform, you need to understand the structure of the href parameter and how to define a custom toolbar for the search results.

Structure of the href Parameter

The emxFormEditDisplay.jsp allows developers to use a single JSP file for searches.

Currently, each individual search command is configured with an href parameter that calls a custom JSP to execute a search. The search command can be configured with href=emxFormEditDisplay.jsp along with any required parameters.

The search command needs to be attached to the appropriate search menu as described in Building a Configurable Toolbar. To configure the query and results interface to use the configurable table component, the search command must specify:


  • Setting: Target Location=searchContent
  • The command href=emxFormEditDisplay.jsp
  • The URL Parameter program set to the program that processes the search criteria and queries the database
  • The URL Parameter tableto the table admininstrative object that defines the layout for the search results page
  • The URL Parameter form specifies the webform that defines the search dialog page

When the user clicks Search from the Search dialog box, the search component submits the search criteria and all request parameters to the JPO specified in the program URL parameter, and the results are displayed in a table component using the table defined by the table URL parameter.

This sample URL invokes a search for Parts:

${COMMON_DIR}/emxFormEditDisplay.jsp?program= 
emxPart:getPartSearchResult&table=ENCGeneralSearchResult&form= 
EngPartSearch&sortColumnName=Name&header=emxEngineeringCentral.
Common.SearchResults&pagination=&Style=dialog&selection= 
multiple&HelpMarker=emxhelpfindselectresults&CancelButton=true&
CancelLabel=emxProductCentral.Button.Close

See URL Parameters Accepted by emxFormEditDisplay.jsp for the list of supported and non-supported parameters.

Toolbar for Search Results

If you need to include a different toolbar for the search results, you can pass the resultsToolbar URL parameter.

If you pass the resultsToolbar URL parameter to the webform, you must also add this function to your custom JS file:

function doSearch() {
         .....
         .....
         var strToolbar = 
currentURL.indexOf("&resultsToolbar=");
         if (currentURL.indexOf("&resultsToolbar=") != -1) {
            strToolbarName = 
currentURL.substring(strToolbar+16,currentURL.indexOf("&",strTo
olbar+1));
             }
         theForm.action = "../common/
emxTable.jsp?toolbar="+strToolbarName; 
         .....
         .....
}

This code is a portion of the method doSearch() in emxUIFormUtil.js installed by the Business Process Services.

User Access to Objects

Users must have both show and read access to objects in order for those objects to appear in search result lists. When assigning accesses to users, show access without read access performs no function. If only show access is required by a custom application, then a custom search tool must be created.