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 new 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.

Division (String)

This property is used to define a filter for the sites in the site area. The format for this property is "Field_Title;Text".

Example:
Division;IT

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.Document.Spreadsheet.RollUp'>/personal/&lt;%User%&gt;</MySite>

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

SendSubAreaURLs (Boolean)

When a web part connection has been established between the SPS Workplace View Advanced and the Workplace View Advanced, site collection URLs are sent by default. By enabling this property (setting it to true), sub-area URLs will be sent instead of site collection URLs.

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)

This property is used to show the Self Management Folder for each site returned.  The valid values are true and false.

ShowSite (Boolean)

This property is used 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.

SiteDirectory (String)

This parameter is used to specify the site directory where new sites are to be created when the "Create a Site" link is selected under Site Administration.

SitesList (String)

This parameter is used to specify the name of the sites list and the form to use when creating new sites.

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)

The target window 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.

Back to Top