advancedsearch Element

advancedsearch Element

Description

Options

Example

Properties

...to a new Folder creates a new Folder when you click Add, then adds the selected SDIs to it.

A Search Type of "Version Filter" renders an additional panel in the Search Bar that lets users choose the specific Version Statuses to be listed in the List page. Access to this panel can be controlled by assigning Roles to the collection item.

The initial state of the checkboxes is derived from the default values defined for the Page Type. Subsequent visits to the page will persist settings made by the last user to access the page. If all checkboxes are unchecked, all statuses are displayed. This panel displays only Versioned SDCs.

Note the "Last Search" option. If you choose this, the advancedsearch Element remembers the last executed search. Upon returning to the List Page, the last executed search is repeated.

When constructing your Query SDIs, you can use either Collective or Cascaded Arguments. However, do not use the "Auto Quote Arguments" feature (it will corrupt the query).

The following properties configure this search engine:

Property Name	Description
style	Determines how the Query SDIs are displayed for selection: Property Name Displays Query SDIs as... Hyperlink Hyperlinks (default). Cliking one executes the Query. Dropdownlist Items in an HTML select list. Choosing an item executes the Query.
Query Category	If you want to display only Query SDIs in a specific Category, choose the Category.
Filter	If you want to search using one or more Query SDIs, enter the Query SDI Ids, separating each with a semicolon.
Default Query	Query SDI to execute when page loads.
Use Description	"Yes" shows the query description rather than the query id
Use Query Label	Show the Query Label specified in the Query Maintenance page (if it exists). "No" is provided for backward-compatibility.
Show	Determines whether or not to show the Search Options.
title	title displayed on the Search Options.
Use Query OrderBy If Provided	"Yes" overrides the default page sort order by using the sort order specified in the Query.
Display Option	Determines where the Query Search Options are placed within the Layout: Property Name Location Top Search Bar Side Search Bar Both Top and Side Search Bars
Top Search Option	Determines how to show Queries in the Top Search Bar: Property Name Location Show Query List Show Default Query Only If the Query has arguments, the arguments are shown: If the Query has no arguments, only the "Default Query" is shown:

For more information, see About Search by Folder above.

As with the Search Callback JavaScript property below, you can use the GroupBy Callback JavaScript property to specify your own function that will execute the grouping. Your function will then use the parameters passed to it by the Group By property.

The default function is groupBy, which uses a fixed list of parameters.

If you want to use your own function, enter only the function name (such as groupBy).

Alternatively, you can use this property to specify your own JavaScript function that will execute the searches. Your function will then use the parameters passed to it by the relevant search engine (Basic, Query, or Category).

The default function is:

showResult( searchtype, searchid, sdcid, queryfrom, querywhere, argarray )

This function is located in WEB-CORE/pagetypes/list/list.jsp, and called by the search JSP rendered in the browser.

If you want to use your own function, enter only the function name (such as showResult). To assist in writing your function, use showResult() as an example. Note the parameter values passed to it by each search engine (see the function for explicit guidance):

Make certain your function is in list.jsp or the file you specify using the Include property of the List Page Type.