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, or accept the default. This field is mandatory.
Viewed Lists	See Viewed Lists.
Display Fields	See Display Fields
ID HTTP Parameter Name	Allows the qDiscussionView and several other web parts to an HTTP Parameter called ID to identify the item to be displayed or edited. This HTTP Parameter is usually generated automatically by the viewer web part, when you select an item to be displayed or edited. NOTE: If qDiscussionView is placed on a web part page that is contained within a document library, the page will generate an error if the value of the ID HTTP Parameter is bigger than the number of pages within the document library. To prevent this error from happening, rename the ID HTTP Parameter. By default, the value of this property is "ID". You can change the value of this property to something else, such as LID. In that case, when you select "View Properties" or "Edit Properties" in the context menu, the URL of the display or edit form becomes: http://mysite.com/EditFormURL.aspx?LID=xxx NOTE: Set the same property in the qListForm to the same value.

Viewed Lists

The Viewed Lists section defines:

•	the discussion lists whose data is viewed in qDiscussionView and how it is aggregated. You can define the lists to be aggregated one by one, in a Rolled-Up list, or from lists with a particular name from all the subsites (recursive rollup)

•	the dependent lists for each list. If the Dependent Lists information is provided, qDiscussionView will check whether or not there are child records in the Dependent Lists when you delete items from the view. If there are any, qDiscussionView will not delete the selected items.

You will need the qListForm web part in order to establish a relationship between different lists.

The following are the elements for the Viewed List attribute:

 

Table 2. Viewed Lists

Element	Description
Advanced Mode	Turn on if you want to edit Viewed Lists in XML format:  <Lists>    <List SiteUrl="siteUrl" ListName="listName" IncludeSubsites="true/false" IncludeThisSite="true/false" IsRollupList="true/false" SiteUrlFieldName="fieldName" RolledUpListName="listName" TargetUrl="targetUrl" SetSessionName="sessionName" ResetSessionNames="name1, name2" NewFormUrl="URL" EditFormUrl="URL" DisplayFormUrl="URL">       <!-- To define dependent lists, add a DependentLists element inside the List element -->       <DependentLists>          <List SiteUrl="siteUrl" ListName="listName" KeyFieldName="keyFieldName" />          <List SiteUrl="siteUrl" ListName="listName" KeyFieldName="keyFieldName" />       </DependentLists>    </List>    <List ...></List>    <List ...></List> </Lists>
Site URL	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	The name of the SharePoint list that is edited or displayed by this Discussion View. The list name is case sensitive. If the list name contains spaces, include the spaces here as well. To denote the current list, you can use a single dot (.) as the list name. NOTE: This only works if the qDiscussionView is contained in the AllItems.aspx. For example, if you are replacing the Microsoft® Discussion View in the AllItems.aspx of the Tasks list and you use a single dot as the ListName attribute, the ListName attribute of the qDiscussionView is set to Tasks. If you want to save the list as a template and then add it somewhere else, the name of the new list might not be Tasks and using this relative list name will automatically pick up the new list name for the view.
List Type	Indicates the type of the list selected. This is a read-only field and displays for all available list templates.
Include Subsites	If set to true, the Discussion View will search all the subsites for a list whose name specified in the ListName and aggregate the information from those list. NOTE: If you have many subsites, the information may take a long time to aggregate. Use this attribute if you have only a small amount of subsites. You must test this feature in your environment to see whether or not the response comes back in a reasonable amount of time and the request does not time out.
Include This Site	Used in conjunction of the IncludeSubsites attribute. If you set this property to true, the list in the current site will be aggregated by the Discussion View. The current site is the site whose URL is specified in the SiteUrl attribute.
Is Rollup List	Indicates whether or not the list specified by the SiteUrl and ListName attributes contains the Site URLs of the lists to be aggregated instead of the data to be aggregated. If you set this to true, the list specified by the SiteUrl and ListName must have a field that contains the URL information. By default, the name of that field is Site URL. If you use different field name, specify the name using the SiteUrlFieldName attribute.
Rolled Up List Name	Used in conjunction with the IsRollupList property, indicates the name of the lists to be rolled up if you set the IsRollupList to true. If you want to aggregate more than one list from each site specified in the rollup list, you can define more than one List elements with the same rollup list, but different RolledUpListName. For example, if you want to aggregate Public Library and Private Library document libraries from each site, you can specify the following: <Lists>    <List SiteUrl="." ListName="Project Sites" IsRollupList="true" SiteUrlFieldName="Project Site URL" RolledUpListName="Public Library" />    <List SiteUrl="." ListName="Project Sites" IsRollupList="true" SiteUrlFieldName="Project Site URL" RolledUpListName="Private Library" /> </Lists>
Site URL Field Name	Used in conjunction with the IsRollupList property, indicates the field that contains the Site URLs of the lists to be aggregated. This attribute is optional if the field name is Site URL. NOTE: The Site URL field must be a single line of text field.
Active Field Name	Used in conjunction with the IsRollupList property. The rollup list may contain a Yes/No field to indicate whether or not a particular site should be included in the rollup. This property is optional if the name of this field is Active. NOTE: The Active field must be a Yes/No field.
Reset Session Names	Resets (sets to NULL) the value of the session variables whose name is specified in this attribute. You can specify multiple names by separating them with commas; for example  TaskSession, IssueSession. You can reset the session name if a discussion may have one or more tasks associated with it. In addition to storing the selected discussion in the session, you may store the dependent task information in the session as well. This means that every time you store a new discussion into a session, you need to reset the dependent task information from the session as well.
Set Session Name	Defines the name of the session variable where the Discussion View will store the item whose column is being clicked by the user. The user can click the item if one of the LinkTo, LinkToTarget or the LinkToSource attributes in the Display Fields property is defined. This attribute is usually used if you have another web part (such as the qListForm) that can consume the stored values from the session. You can set the session name when you want to consume the item from a session variable in a qListForm later.
Target URL	When the LinkToTarget attribute of a specific column is set to true (in the Display Fields property), the data in that column becomes a hyperlink to the URL specified in this attribute. NOTE: The TargetUrl can use the <%field name%> field replacement expression. If you are using Advanced Mode, you must use the encoded form of the < and > characters, which are &lt; and &gt; respectively. Use the LinkToTargetUrl attribute if you want each list to have a different URL; for example, when you want to aggregate multiple lists from the same workspace and connect a certain column to the display form of the list. In that case, the URL to the display form of each list is different.
New Form URL	Indicates the URL where the form to create a new item resides. The URL is relative to the Site URL of the list. The user is redirected to the specified URL when one of the New buttons in the toolbar is clicked. If not defined, the user is redirected to the NewForm.aspx of the list (or Upload.aspx for the document library). Redefining the New Form URL is useful if you have different way of creating an item depending on the current view. For example, in the view for external vendor, you may want to give them a new form that does not contain all the fields in the list. NOTE: The Source HTTP parameter is automatically appended to the New Form URL during redirection. This attribute is usually used in conjunction with qListForm.
Reply Form URL	Indicates the URL where the form to create a new response resides. The URL is relative to the Site URL of the list. The user is redirected to the specified URL when the Reply button in the toolbar or in the preview panel or the Reply context menu item is clicked. If not defined, the user is redirected to the URL specified in the NewFormUrl, if one is defined. Otherwise, the user is redirected to the NewForm.aspx of the list. Redefining the Reply Form URL is useful if you want to have a different form to create a reply than the one that is used to create a new discussion. For example, in the form to create a reply, you may want to use 2 qListForms. The first qListForm is used to display the detail of the parent discussion and the second qListForm is used to create the response itself. NOTE: The Source HTTP parameter is automatically appended to the Reply Form URL during redirection. This attribute is usually used in conjunction with qListForm.
Edit Form URL	Indicates the URL where the form to edit an item in the list resides. The URL is relative to the Site URL of the list. The user is redirected to the specified URL when the user clicks Edit Properties in the Context Menu. If not defined, the user is redirected to the EditForm.aspx of the list. Redefining the Edit Form URL is useful if you have different ways of editing an item depending on the current view. For example, in the view for external vendor, you may want to give them an edit form that does not contain all the fields in the list. NOTE: The ID and Source HTTP parameters are automatically appended to the Edit Form URL during redirection. This attribute is usually used in conjunction with qListForm.
Display Form URL	The URL where the form to display an item in the list resides. The URL is relative to the Site URL of the list. The user is redirected to the specified URL when the user clicks View Properties in the Context Menu. If not defined, the user is redirected to the DisplayForm.aspx of the list. Redefining the Display Form URL is useful if you have different way of displaying an item depending on the current view. For example, in the view for external vendor, you may want to give them a display form that does not contain all the fields in the list. NOTE: The ID and Source HTTP parameters are automatically appended to the Display Form URL during redirection. This attribute is usually used in conjunction with qListForm.
Site URL	The URL to the site that contains the dependent list.
List Name	The name of the dependent list. The list name is case sensitive.
Key Field Name	The name of the field in the dependent list that contains the ID of the parent item. It is the foreign key in the dependent list. The key field is usually a single line of text that contains the parent item ID or a cross-site lookup field to the parent list. The name is case sensitive.

Display Fields

This property defines the fields that should be displayed in the tree list panel of qDiscussionView.

The Display Field contains the following elements:

 

Table 3. Display Fields

Element	Description
Advanced Mode	Turn on if you want to edit Display Fields in XML format: <Fields LookupThresholdControlSettings=”On”> <Field Name="fieldName" [optional attributes]/> <!-- Grouped field --> <Field Name="fieldName" Grouped="true" SortDirection="asc|desc" GroupExpanded="true|false" /> </Fields>
Query All Fields	Controls how Web Parts behave in relation to the Discussion View Lookup Threshold in SharePoint Resource Throttling. The options are: • Default — uses the level set in the Configuration Editor. If you have selected Query All Fields check box in the Configuration Editor, the Web Part will query only those fields that are not included in the Discussion View Lookup Threshold. If the Query All Fields check box is cleared, the Web Part will query all fields. • On — If the Web Part level is On, the Web Part queries all fields in lists, except Lookup fields. • Off — If the Web Part level is Off, the Web Part queries all fields in lists, including Lookup fields. • Explicit — If the Web Part level is Explicit, the Web Part queries only those fields selected in the Display Fields. This option renders the best performance for your Web Part.
Title	Indicates the title of the field. This is useful if the real field name is too long and you want to abbreviate the title in the field header, or if you simply want to display a different title in the field header. If this attribute is not specified, the value specified in the Name attribute is used in the field header. For example: <Field Name="Created By" Title="Author" />
Field Type	Indicates the type of the field selected. This is a read-only field and displays for all available list templates.
Title Resource ID	Indicates the identifier in the Resource List that is used as the title of the field. The TitleResourceID and the current cultural setting (identified with the Culture HTTP parameter) are used to retrieve the string in the Resource List. If the string with the given identifier is not found, the default Title is used.
Width	Indicates the width of the field. You can specify the value in pixels (Width="20px") or percentage (Width="20%"). We recommend leaving at least one field where you do not specify this property. That field will take up the remaining width of the page. For example: <Field Name="Subject" Width="100px" />
Align	Indicates the horizontal alignment for the field. The values is one of the following: left, right, or center. For example: <Field Name="Created" Align="right" />
Item Style	Indicates the style for the item. You can define the style as you would in a CSS class; for example, color: red; font-weight: bold
Item CSS Class	Indicates the distinct style for the column and you already have defined the style in an external CSS file.
Display Field Name	If specified, indicates a cross-site lookup field. It contains the name of the field in the cross-site list that contains the value to be displayed. The field name is case sensitive. A cross-site lookup field enables you to lookup a list that resides in another site, another site collection, or another web application as long as it is in the same configuration database. You need the qListForm web part to create a cross-site lookup field.
Display Format	If specified, indicates a cross-site lookup field. It contains the format of the value that is displayed. Define this attribute if you want to display values from multiple fields. 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 Display Fields editor in the Discussion View Editor, where the Editor will encode the characters automatically for you. NOTE: For more information, see Display Format
Show User Groups	Allows you to show groups where the user is a member of one of the SharePoint groups listed. Separate site group names with commas.
Hide User Groups	Allows you to hide groups where the user is a member of one of the SharePoint groups listed. Separate site group names with commas.
Hyperlink Field Target	If this field is a SharePoint Hyperlink or Picture field, indicates the target window for the hyperlink. For example, use "_blank" if you want to open the target URL in a new window. If this attribute is left blank, the target URL will open in the current window. This attribute will not affect the hyperlink column created with the LinkTo, LinkToSource or LinkToTargetURL attributes.
Link To	Indicates that the Discussion View will turn the field into a hyperlinked column to the specified URL. The URL can be an absolute or relative URL. The LinkTo can use the <%field name%> field replacement expression. 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 Display Fields editor in the Discussion View Editor, where the Editor will encode the characters automatically for you. If you use a relative URL, the URL is appended to the site URL of the target site. For example, specify "Lists/TeamDiscussion/EditForm.aspx?ID=&lt;%ID%&gt;" as the value of this property. If you click a customer record that comes from the Customers list in Workspace A, whose site URL is "http://mydomain/sites/mysite", you are directed to http://mydomain/sites/mysite/Lists/TeamDiscussion/EditForm.aspx?ID=23 (assuming you click the discussion with ID=23). Here is an example on how to make the Subject field a hyperlink column to the edit form of the Discussion list: <Field Name="Subject" LinkTo="Lists/TeamDiscussion/EditForm.aspx?ID=&lt;%ID%&gt;&Source=../../default.aspx" />
Link To Target	If set to true, indicates the Discussion View will make the field value a hyperlink to the URL specified in the TargetUrl attribute in the Viewed Lists property. Use this element when you aggregate lists with different name. In that case, you specify a different TargetUrl for each list in the Viewed Lists property and the Discussion View will redirect the user to the correct URL depending on the list where the clicked item comes from.
Link To Source	The Discussion View will make the field value a hyperlink to the URL specified in the Source HTTP parameter of the current request. For this option to work, the current page URL must look like: http://.....?Source=.... Use this element when the URL for the hyperlink is dynamic. This could be because it contains dynamic parameters or the URL is different depending on the referral page. Also, when you want to make the URL in the link dynamic. In that case, you can pass in the URL for the link into the HTTP parameter of your page.
Is Complex Category	If selected, you can set the following: • Complex Category Index Site URL — By default, the complex category index list resides in the same site as the discussion list itself. If this is not the case, then you must specify the URL of the site that contains the index list here. • Complex Category Index List Name — By default, the complex category index list is named "<Discussion list name> Categories". For example, if your discussion list name is "Team Discussion", then its index list name is "Team Discussion Categories". If this is not the case, then you must specify the name of the index list here.
Grouped	Allows you to group data by: • Sort Direction — This attribute determines whether the values in the header of the grouped field must be displayed in ascending or descending order. The options are asc for ascending order or desc for descending order. The default value is asc. • Group Expanded — If set to true, the group is initially expanded. Otherwise, it is collapsed. If not specified, the default value is false. NOTE: Grouping is not supported on any field that has "Allow Multiple Values" enabled.