com.plumtree.portalpages.pei
Interface IAdvancedSearchActions

public interface IAdvancedSearchActions

This interface was created to allow developers the ability to create functions that can be dynamically discovered by the Plumtree application for the purposes of performing some functionality when a particular advanced search based event occurs. The functions will allow primarily for the modification of the Search criteria and the available Search Settings.

NOTE: Should this interface be implemented more than once within the Dynamic Discovery process, the implementations will be processed in the order that they are displayed within the representative XML file. All implementations will be called.

NOTE: Developers should be very careful implementing either of these functions as these will be called every single time that an Advanced Search is performed and it could hurt performance.

Method Summary

void	CustomizeQueryOnBeforeSearch(AActivitySpace _asCurrentSpace, IPTSession _ptUserSession, QueryArguments _qaQueryInfo) This function allows for the modification of the query portion of an advanced search.
SearchSettingCollection	GetCustomSettingsOnBeforeSearch(AActivitySpace _asCurrentSpace, IPTSession _ptUserSession) This function allows for the modification of the settings used for an advanced search.

Method Detail

CustomizeQueryOnBeforeSearch

void CustomizeQueryOnBeforeSearch(AActivitySpace _asCurrentSpace,
                                  IPTSession _ptUserSession,
                                  QueryArguments _qaQueryInfo)

This function allows for the modification of the query portion of an advanced search. Implementers of this interface should modify the QueryArguments object that is passed in to change the search that will be run.

Parameters:

_asCurrentSpace - - Provides access to the current MVC classes as well as the Application and the HTTP Session

_ptUserSession - - Plumtree session object for the current user

_qaQueryInfo - - On entry, this structure will contain: userQuery (String): null basicFields (String): null advancedFilter (IPTFilter): Filter the user defined on the Advanced Search page

GetCustomSettingsOnBeforeSearch

SearchSettingCollection GetCustomSettingsOnBeforeSearch(AActivitySpace _asCurrentSpace,
                                                        IPTSession _ptUserSession)

This function allows for the modification of the settings used for an advanced search. Implementers of this interface should modify the SearchSettingCollection object that is passed in to change the search that will be run.

Parameters:

_asCurrentSpace - - Provides access to the current MVC classes as well as the Application and the HTTP Session

_ptUserSession - - Plumtree session object for the current user

Returns:

SearchSettingCollection that will add to or override default settings