Modifiable DWP Properties

CorasWorks web parts have a number of properties that can only be modified by manually editing the DWP file associated with this web part. You can edit a DWP file by exporting the web part to a location of your choice, making the desired changes, and then uploading it back onto your site.

The properties described here allow you to change the function and display of the web part. Please keep in mind the XML namespace of the web part you are changing, or these properties will not be enabled within the web part.  XML namespaces for all CorasWorks web parts are provided in the For Developers help topic.

Also note that some of these properties some may require the use of a "<", ">", or "&" symbol. If that is the case, you will need to replace these characters with their encoded equivalents of "&lt;", "&gt;", and "&amp;" respectively.

These properties are only viewable in the DWP if the default settings have been changed.

NOTE: As of the Summer 05 release of the Workplace Suite, a Localization tab on the administration interface allows you to make many of the localization changes described below. Before you make these changes in the DWP, you may want to review the available settings that can be modified on the Localization tab.

HomePageURL (String)

This property is used to define the name for the homepage of the site (*.aspx). This is useful if in a framed environment the homepage you have setup is default.aspx but the display page for the body frame of the page is index.aspx.

LevelsReturned (Integer)

This property is used to define the number of levels that you want to search to find sites and lists to include in the web part display. The maximum number of levels is 7.

If you want to search more than one level, be sure to enter a numerical value (1-7). If you spell out a number, it will result in an error and no lists will be found.

MySite (String)

This property allows you to change the default MySite characteristics of the web part. The default characteristic modifies the URL "/mysite" to point to "/personal/User". This allows the web part to search through the MySite section of SharePoint Portal Server. SPS allows administrators to alter the URL definition for each SPS server. To accommodate for this, the DWP Property "MySite" was designed to allow Administrators to alter the web part to support their particular SPS MySite setup.

Use:
<MySite xmlns='webpart_namespace'>/sites/<%Domain%> AND/OR <%User%></MySite>

Example:
<MySite xmlns='CorasWSC.WorkPlace.View'>/personal/&lt;%User%&gt;</MySite>

Settings:
<%User%> = User Name
<%Domain%> = Domain Name

NodeTextWidth (Integer)

This hidden property is available in the Winter 2006 and later releases. It allows long node text to wrap to the next line. The default value is 28 characters (NOT pixels), which makes the WVA fit best within the usual 220 pixel wide space that comprises the Quick Launch area on standard WSS home pages. With a setting of 28, the WVA will wrap text as close as it can to the 28th character without hyphenating or cutting any words in half. Different fonts take up a different amount of space, so you may want to tweak this value.

ShowAdmin (Boolean)

This property is used to show the Administration folder for each site returned. The valid values are true and false.

ShowExpanded (Boolean)

Set this property to true to have each site with folders or sub-sites returned in an expanded form. The number of sites returned depends on the number of Levels chosen in the "Levels Returned" field.

ShowList (Boolean)

This property is used to show the Lists folder for each site returned. The valid values are true and false.

ShowListItemCount (Boolean)

Set this property to true to show the total number of items in each list returned.

ShowSelf (Boolean)

Set this property to true to show the Self Management folder for each site returned.  The valid values are true and false.

ShowSite (Boolean)

Set this property to true to show the sites available below the site where the web part is pointing. The valid values are true and false.

ShowWhereIAm (Boolean)

Set this property to true to have all sites above the current web part returned in an expanded form.

SiteURL (String)

This property is used to identify the URL(s) for the site(s) from which you want to return management links, sites, and lists. This can be any SharePoint site that resides on the same server as this web part. The format for the URL must be: http://Site-URL/SiteName

Examples:

      http://www.sitename.com/ http://www.sitename.com;http://www.sitename2.com

      http://www.sitename.com/site1

      http://www.sitename.com/site1/site1a

      http://www.sitename.com/site 1

SupressErrors (Boolean)

Set this property to true to display site access errors.

Target (String)

This property is used to identify the target in which you wish to have each of the web part’s links open. This can be "_parent", "_top", "Custom", or any other variable permitted by a Target reference in an anchor (<a>) tag.

UseRelativeURL (Boolean)

This property is used to make the hostname entered in the URL irrelevant. This is useful if you expect that you will move from one hostname to another in the future. The valid values are true and false.

Example:
http://www.hostname.com/site1 - the "http://www.hostname.com" will be replaced with the current hostname.

Back to Top