Search/Filter Panel

The Search/Filter Panel allows you to define the panels for search, filter, and replace in the web part.

The Search/Filter Panel contains the following elements:

Table 12. Search/Filter Panel

Element	Description
Searched Fields	See Searched Fields.
Turn On List View Link Mode	Allows you to link this chart view with qListView. When selected, the chart view will display the same data that is displayed in the listview, with the same filters and sort condition applied. The filters and the sort conditions are being passed by the List View using Session variable. Therefore, you must set the Search Session Name property to the same value as the Search Session Name property in the listview. NOTE: The chart view does not have Search/Filter panel available in this mode.
Turn On List Searcher Mode	Allows you to perform a search before the chart view displays any data.
Show Search All Fields Control in Search Panel	Determines whether the Filter panel should display the control to search all fields in the list. When set to true, the following control is shown in the Filter panel: The Search All Fields Control allows you to do the following: • Combine the search all fields functionality with other search criteria that has been entered for specific fields. • When the search all fields criteria is entered, the Filter panel will construct a filter expression with the "Contain" operator for the following fields in the list: Single line of text, Multiple lines of text, Choice, Lookup (only Lookup to a Single Text field and Lookup to a Number field are supported), Person or Group and Hyperlink or Picture. If the list contains a Lookup to Number field, Search All Fields will not work for negative numbers for that field. The Filter panel will use the entire keywords as the value to be searched. Therefore, if you enter "High Priority" in the search all fields control and perform the search, it will find the following sentence: ‘This is a high priority task’ However, it will not find the following sentence: ‘The priority is not always high’
Expand Filter panel on Load	Allows you to automatically open the Filter panel by default so that the user can perform a search quickly. When set to true, the Filter panel opens when the web part is loaded for the first time.
Panel Button Location	Determines the location of the Go, Reset and Close buttons in the Filter panel. This property also determines the location of the Go and Close buttons in the Replace panel.
Organization Chart Searched Fields	See Searched Fields. NOTE: The search result displays one level up (n+1) and one level down (n-1) of employee hierarchy as per availability of data in the select data source.

Searched Fields

This property defines what fields are displayed in the Search Filter panel.

You will be able to perform a search by pressing Enter.

NOTE: Pressing Enter will not allow you to perform a search on such fields as external data, people picker, managed metadata, and a drop-down list. Instead, the default behavior will occur. NOTE: For the Number type field, the “Contain” operator is not supported for negative numbers, and is not available for the following fields: Lookup to DateTime field, Lookup to Calculated field, and Lookup to ID field.

You can further edit fields using the following elements:

 

Table 13. Searched Fields

Element	Description
Advanced Mode	Turn on if you want to edit Searched Fields in XML format: <Fields>    <Field Name="fieldName" [optional attributes]/>    <!-- To search a cross site lookup field, use one of the following two formats -->    <Field Name="fieldName" DisplayFieldName="fieldName" SortField="fieldName" [optional attributes]>       <List SiteUrl="siteUrl" SiteName="siteName" ListName="listName"/>    </Field>    <Field Name="fieldName" DisplayFormat="fieldName" SortField="fieldName" [optional attributes]>       <List SiteUrl="siteUrl" SiteName="siteName" ListName="listName"/>    </Field> </Fields>
Field Name	Indicates the element you are editing.
Title	Displays title for the field. The value can be a plain string or an encoded HTML string.
Description	Describes the field. This is useful if you want to give a short instruction or explanation about the field.
Default Value	Defines the default value for the field. You can define a text, a number or a date. A date value must be specified in ISO 8601 format: YYYY-MM-DDThh:mm:ssZ, for example: midnight of February 14, 2002 is 2002-02-14T00:00:00Z.
Default Operator	Defines the default operator for the field.
Fixed Operator	Defines the operator for the field. If specified, the list to select the operator for this field is turned off.
Use People Editor	Enables you to enter any user information that is in your directory service. If you set this to True and the field to be searched is a People and Group field, the Filter panel will show the People Editor control for entering the search criteria.
Column Count	Defines the number of columns for the options in a multi-choice field or in a choice-and-lookup field if the Enable Multi Choice attribute is set to True. This is useful in case your choice or lookup fields have too many choices and you want to break the choices into several columns to minimize the vertical scrolling in your form.
Enable Multi Choice	If selected, allows you to select multiple options for the choice-and-lookup field. Therefore, the user can specify a condition like "A or B". This attribute is ignored by other field types. To search a cross-site lookup field, you must specify one or more List elements inside the Field element. The cross-site lookup field is displayed as two drop downs.
Sort Field	Defines the field that is used to sort the value in the list. The field name is case sensitive.
Sort Order	Allows you to sort the values in ascending or descending order.
AutoPostBack	When selected, causes the Filter panel to refresh when the user changes the selection in a lookup field or cross-site lookup field. You need to set AutoPostBack to true if this field is a lookup or a cross-site lookup field and it is being used to filter another lookup or cross-site lookup field in the Filter panel.
Parent Field	Defines another lookup or cross-site lookup field that is used to filter this field. The parent field must be listed before this field in the XML property.
Parent Filter Field Name	Defines the field in the parent field that is used to filter this field. It is the primary key in the list that is used in the lookup or cross-site lookup field.
Filter Field Name	Defines the field in the list that is used by this lookup or cross-site lookup field that is filtered by the parent filter field.
Display Field Name	Shows the name of the field whose value is displayed in the list. The field name is case sensitive. Use this attribute instead of the Display Format attribute if you only want to display a single field in the list.
Display Format	Indicates the format of the value that is displayed in the list. Define this attribute instead of the Display Field Name attribute if you want to display multiple fields in the drop-down menu. You can use the field replacement expression <%Field%> to refer to a field. NOTE: If you are using Advanced Mode, you must use the encoded form of the < and > characters, which are &lt; and &gt;, respectively unless you type in the value in the Searched Fields editor in the List View Editor, where the Editor will encode the characters automatically for you. NOTE: For more information, see Display Format
Site URL	Indicates the Site URL of the field. You can use an absolute or relative URL.
List Name	Indicates the name of the List. The field name is case sensitive.
Site Name	Indicates the name of the site specified in the Site URL. This is used in case you have multiple lists. In this case, the first drop-down menu to select the list will display as "List Name in Site Name". You can use any name for the Site Name. It does not have to match the real title of the Site.