Admin: Display Tab

NOTE: This topic applies only to My Roll-Ups for Summer 2005 and later releases. If you are working with a prior release, please see Web Part Properties (Pre-Summer 2005 Only)” instead.

The fields on this tab are used to enable and disable aspects related to the display of items in the roll-up. For example, you can enable or hide links that allow users to add and edit items. Additional fields are used to define the font, style, and background color of the sites and lists named in the roll-up, as well as any dates and times included in the display.

When you are finished making your selections on this tab, click any other administration tab to save your changes and keep the administration interface open, or click OK to save your changes and return to the roll-up display.

Show Add and Edit Links

When this checkbox is selected, the "Add Item" link and "Edit Item" icon are included in the roll-up display so users can add and edit items from the web part.  When this checkbox is left blank, users can only view list items.

Show Lists with No Results

When this checkbox is selected, every list set up to be searched by the web part will be named in the roll-up results, regardless of whether or not any items are available in that list.

If a filter is applied and this option is enabled, only those lists that contain items that meet the filter criteria will be displayed; any lists that do not contain items that meet the criteria will not be shown.

Expand Lists and Items

When this checkbox is selected, the web part display will be expanded, showing all lists and list items returned. When it is not selected, all lists and list items will be contracted within a tree-view that can be expanded by the user.

Expand Sites Only

When this checkbox is selected, only the sites (not the lists or items) returned by the web part will be expanded, saving screen real estate. If the Expand Lists and Items checkbox is selected, it will override this setting.

Show Icons for Document

This property only applies to document libraries. When this checkbox is selected, the document roll-up display will include an icon to represent the document type. When it is not selected, no icon will be included in the return.

Show Item Link

When this checkbox is selected, users can click a link to go directly to the item within the roll-up display. If you choose to leave this checkbox blank, you can use it in conjunction with the Show Site and List Links option (described below) to remove a user’s ability to go directly to a list from within the web part.

Show Site and List Links

When this checkbox is selected, the display of the site name and list name for each item returned include a clickable link.

Show Items Created By Current User

Select this checkbox to return all items that have been created by the currently logged in user. This overrides the Assigned To functionality built into the web part.

Show Items Modified By Current User

Select this checkbox to return all items that have been modified by the currently logged in user. This overrides the Assigned To functionality built into the web part.

Display Format for Sites

This field is used to define the display format of the sites returned by the roll-up. For example, to display the site title and URL, you would place the following in this field: <%SiteTitle%> (<%SiteURL%) This would display the information as follows: Site 1 (http://www.site.com/site1).

Alternatively, you could enter text before the site title, as in Site: <%SiteTitle%>

Document Type Heading Name

This field is used to identify the name of the heading for the column that displays document type icons. It is only used when “Show Icons for Document” (described above) is selected, and it only applies to document libraries.

Font and Style

This option is used to define the font family, size, color, and weight utilized for the names of sites and lists that appear as group headings returned by the roll-up. Leave this field blank to use the default font and style.

This setting is useful if your site utilizes a color structure that is not matched by the CorasWorks default of a grey background and blue text. The style is based upon CSS definitions. While the CSS class cannot be entered, you can enter any text oriented toward a font style class like, such as "Font-Size:8; Color:Red"

Example: font-family: Verdana; font-size: 10pt; color: blue; font-weight: bold

Site and List Background Color

This field is used to define the background color utilized for each site and list returned by the roll-up. Click Choose Color to the right of this field to select the desired color, or you can enter the color in hex format. Alternatively, you can leave this field blank to use the default color of gray (#DDDDDD).

Date Format

This field allows you to alter the return of date-type fields. By default, SharePoint displays date/time fields as MM/dd/yyyy, hh:mm:ss. If you wish to have all dates or times returned show only a time or a date, you can use the following parameters.

d

The day of the month. Single-digit days will not have a leading zero.

dd

The day of the month. Single-digit days will have a leading zero.

ddd

The abbreviated name of the day of the week, as defined in AbbreviatedDayNames.

dddd

The full name of the day of the week, as defined in DayNames.

M

The numeric month. Single-digit months will not have a leading zero.

MM

The numeric month. Single-digit months will have a leading zero.

MMM

The abbreviated name of the month, as defined in AbbreviatedMonthNames.

MMMM

The full name of the month, as defined in MonthNames.

y

The year without the century. If the year without the century is less than 10, the year is displayed with no leading zero.

yy

The year without the century. If the year without the century is less than 10, the year is displayed with a leading zero.

yyyy

The year in four digits, including the century.

gg

The period or era. This pattern is ignored if the date to be formatted does not have an associated period or era string.

h

The hour in a 12-hour clock. Single-digit hours will not have a leading zero.

hh

The hour in a 12-hour clock. Single-digit hours will have a leading zero.

H

The hour in a 24-hour clock. Single-digit hours will not have a leading zero.

HH

The hour in a 24-hour clock. Single-digit hours will have a leading zero.

m

The minute. Single-digit minutes will not have a leading zero.

mm

The minute. Single-digit minutes will have a leading zero.

s

The second. Single-digit seconds will not have a leading zero.

ss

The second. Single-digit seconds will have a leading zero.

f

The fraction of a second in single-digit precision. The remaining digits are truncated.

ff

The fraction of a second in double-digit precision. The remaining digits are truncated.

fff

The fraction of a second in three-digit precision. The remaining digits are truncated.

ffff

The fraction of a second in four-digit precision. The remaining digits are truncated.

fffff

The fraction of a second in five-digit precision. The remaining digits are truncated.

ffffff

The fraction of a second in six-digit precision. The remaining digits are truncated.

fffffff

The fraction of a second in seven-digit precision. The remaining digits are truncated.

t

The first character in the AM/PM designator defined in AMDesignator or PMDesignator, if any.

tt

The AM/PM designator defined in AMDesignator or PMDesignator, if any.

z

The time zone offset ("+" or "-" followed by the hour only). Single-digit hours will not have a leading zero. For example, Pacific Standard Time is "-8".

zz

The time zone offset ("+" or "-" followed by the hour only). Single-digit hours will have a leading zero. For example, Pacific Standard Time is "-08".

zzz

The full time zone offset ("+" or "-" followed by the hour and minutes). Single-digit hours and minutes will have leading zeros. For example, Pacific Standard Time is "-08:00".

:

The default time separator defined in TimeSeparator.

/

The default date separator defined in DateSeparator.

Back to Top

 

Sorting Options

The Sorting Options section of the Display tab allows you to define how roll-up results are sorted.  In the past, you could click on a column heading to change the way a roll-up was sorted, but the default sort would resume the next time you returned to the display.  Now, these settings enable you to “lock in” the desired sort order.  You can select up to three fields to sort on in a single roll-up.

Because a roll-up can reference multiple schemas, each of which can reference columns with different names, you need to identify the schema you want to work with when defining a custom sort. 

The steps to define a custom sort are as follows:

1.  Place the roll-up web part on the page and make the appropriate site and list selections, plus any other web part property settings necessary on the administration interface.

2.  Access the Display tab and select the first schema you want to work with from the Schema for Sort Order field. Note that the schemas listed in this drop-down are limited to the schema(s) you chose on the Sites and Lists tab.

3.  Use the drop-down fields and radio buttons below the Schema for Sort Order field to define the fields and order to use to sort the roll-up results.  You can sort on up to three fields; if you want to sort on only one or two fields, leave the other drop-down(s) blank.

NOTE: As of Summer 2005, all fields in the schema are available for sorting.  Past versions of the Workplace Suite only allowed you to sort on certain fields that were identified for sorting in the schema.

4.  Click Apply.

5.  Select the next schema from the Schema for Sort Order field, then select the desired fields and sort order as described above.

6.  When you are finished, click Apply or OK.  All of your changes are saved, including all of the sort rules defined above.

 

Back to Top