Primary Content

The Primary Content page is default category. You need to configure one or more elements in this page to get started using this web part.

Primary Content contains the following:

 

Table 1. Primary Content

Element	Description
Title	Allows you to enter a title for the web part.
Selector Direction	Allows you to control the positioning of the selectors. If LeftToRight is selected, the selectors are positioned side by side. If TopToBottom is selected, the selectors are stacked on top of one another.
Configuration	See Configuration.

Configuration

This property defines the configuration for each selector.

The top-level element is called Configuration. This element contains one or more PersistentSelector elements. Each PersistentSelector element represents one qSelector selector. Most attributes in the PersistentSelector element are the same properties as those defined for qSelector without spaces in its name. For example, the Show Empty Selection property in the qSelector becomes the ShowEmptySelection attribute in the PersistentSelector element.

The Configuration section contains the following:

 

Table 2. Configuration

Element	Description
Advanced Mode	Turn on if you want to edit Configuration in XML format. <Configuration>    <PersistentSelector Title="Select a Project" SessionName="ProjectSession" SiteUrl="." ListName="Projects" DisplayFieldName="Project Name" DisplayFields="&lt;Fields&gt;&lt;Field Name=&quot;Project ID&quot;/&gt;&lt;Field Name=&quot;Project Name&quot;/&gt;&lt;/Fields&gt;" />    <PersistentSelector Title="The select a Phase" ParentFilterFieldName="ID" FilterFieldName="Project List Item ID" SessionName="PhaseName" SiteUrl="." ListName="Phases" DisplayFieldName="Phase Name" /> </Configuration>
Title	Allows you to enter a title that is displayed above the selector. This field is mandatory.
List Name	Allows you to select a list. This field is mandatory. For more information, see List Name
Session Name	Allows you to define the search session variable name where the qSelector stores the last selected item. If you want to associate several selectors, you must define the same Search Session Name property for all of them. This field is mandatory.
Hidden	Allows you hide the field to prevent other users from changing the selection.
Parent Filter Field Name	Allows you to enter the field name from the previous selector that is used to filter the information in this selector.
Filter Field Name	Allows you to enter the field name in the selector that filters the information.
Display Field Name	Allows to select the name of the field that you want to display in the selector.If you want to display information from multiple fields, use the Display Format properties. The Display Field Name property is ignored if the Display Format property is defined. This field is mandatory.
Display Format	Allows you to define the format of the items that are displayed in the selector. You can use field replacement expression (<%field name %>) to refer to a field name. For more information, see Display Format
Display Fields	Allows you to define the fields that are displayed in the drop-down menu of the web part. You can enter values for the following: • 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. • 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.
Eliminate Duplicate Values	Allows you to define whether or not you want to eliminate duplicate values in the drop-down menu. This is useful in case you want to use the selector as a filter to another Web Part.
CAML Filter Expression	Allows you to enter a CAML (Collaboration Application Markup Language) query expression to filter your data. CAML is an XML based query language. For more information, see CAML Filters
Complex Filter	Allows you enter Complex Filter expression to define a static filter for the data. The complex filter is applied to the data after the CAML Filter is applied. For more information, see Complex Filters
Sort Field	Allows you to enter a value that is used to sort the entries in the qSelector. This property accepts a single field name.
Sort Ascending	Allows you to sort the entries in the ascending order. Deselect this check boxif you want the entries in descending order. This field is ignored if the Sort Field property is not defined.
Show Empty Selection	Allows you to display the value of Empty Selection Item Name property as the first item. You should check this property if you want the user to be able to select nothing. Selecting nothing returns the entire unfiltered list. Another case is when the qSelector acts as a filter to another web part and you want the ability to pass an empty filter. This means the other web part will display all its data unfiltered.
Empty Selection Item Name	Allows you to display a specified value as the first item in the Selector when the Show Empty Selection is checked. The default is - Select One -.
Empty Drop Down Item Name	Allows you to display specified text that is displayed in the drop-down menu when it contains no list items. The default is <Empty>.
Persistent Width Selector	Allows you to set the width of the input part for the persistent selector.
Drop Down Width	Allows you to set the width of the drop-down for the selector in pixels. If you specify the width for each field in the Display Fields property in pixels, the value of this property is usually the total width of all fields.
Drop Down Height	Allows you to set the height of the drop-down menu.
Refresh Page When Selection Changed	Allows you to determine whether the page should be refreshed when you select another item in the selector. By default, the value is false, which means that the page is only posted back.

List Name

This property defines the following:

•	The list whose data is viewed in the selector.

The following are the elements for the List attribute.

Table 3. List Name

Element	Description
Advanced Mode	Turn on if you want to edit List Name in XML format. XML will look like the following: <Lists>  <List SiteUrl="." ListName="Employee List" /> </Lists>
Site URL	Allows you to set the URL to the site that contains the list to be searched. The URL can be absolute (http://...) or relative to the current page URL. This attribute is mandatory. When using a relative URL, you can use a single dot (.) to denote the current path, a double dot (..) to denote the previous path, and a slash (/) to denote the root path.
List Name	Allows you to enter the name of the SharePoint list that is displayed. The list name is case sensitive. If the list name contains spaces, include the spaces here as well.