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.

MySite (String)

This property allows you to change the default My Site 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 My Site 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 My Site 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

DynamicGrouping (String)

This property allows the user to see all items grouped by the field chosen here. The field you enter must be one of the web part’s display fields. (Example, Announcements: Title/Body, Expires will not function as it is not displayed) Only one field can be identified here.

Use:
<DynamicGrouping xmlns='webpart_namespace'>Field Title</DynamicGrouping>

Example:
<DynamicGrouping xmlns='CorasWSC.Document.RollUp'>Title</DynamicGrouping>

DynamicGroupingProperties (String)

This property allows you to define the look and feel of the dynamic grouping by defining the background color (TD Color), font style, and whether the results are expand or contracted. If no properties are defined here, the default properties will be used. Each element of this property must be separated by a comma. Please make sure that there is no space between each element and the comma. The color can be defined in hex format or as a direct color name.

Use:
<DynamicGrouping xmlns='webpart_namespace'>TD Color,Font Style,true/false</DynamicGrouping>

Example:
<DynamicGrouping xmlns='CorasWSC.Document.RollUp'>blue,font-family: Verdana; font-size: 8pt; color: white; font-weight: bold,true</DynamicGrouping>

Settings:
First Element = Tree-View TD Background Color, Second Element = Tree-View Font Style, Third Element = Expanded/Contracted (true/false) < /FONT >

FontStyle (String)

This property allows you to define the font style used to display each site/list returned.

Use:
<FontStyle xmlns='webpart_namespace'>Font Style</FontStyle>

Example:
<FontStyle xmlns='CorasWSC.Document.RollUp'>font-family: Verdana; font-size: 8pt; color: white; font-weight: bold</FontStyle>< /FONT>

TDColor (String)

This property will allow you to specify the background color of the sites and lists returned by the web part. This can be used in conjunction with the FontStyle property to match your site theme. The color can be identified in hex format or as a direct color name. (Example: grey or #DDDDDD)

Use:
<TDColor xmlns='webpart_namespace'>TD Color</TDColor>

Example:
<TDColor xmlns='CorasWSC.Document.RollUp'>#DDDDDD</TDColor>< /FONT>

ExpandSite (Boolean)

This property allows you to define whether or not you want only the sites returned by the web part to be expanded, not the lists. If you also use the Expand Site/Lists property, this property will be overridden. By setting this property to true, all sites will be expanded, showing the lists within. By setting this property to false, all sites will be contracted and no lists will be displayed until the user expands the display.

Use:
<ExpandSite xmlns='webpart_namespace'>true/false</ExpandSite>

Example:
<ExpandSite xmlns='CorasWSC.Document.RollUp'>true</ExpandSite>< /FONT>

ShowCorasWorks (Boolean)

This property allows you to hide or show the "Powered By CorasWorks" text. When this property is set to true, the user will see the "Powered By CorasWorks" text. When this property is set to false, the user will not see this text.

Use:
<ShowCorasWorks xmlns='webpart_namespace'>true/false</ShowCorasWorks>

Example:
<ShowCorasWorks xmlns='CorasWSC.Document.RollUp'>true</ShowCorasWorks>< /FONT>

ShowSearch (Boolean)

This property allows you to hide or show the List Return Search Bar. When this property is set to true, the Search bar will be displayed. When it is set to false, the bar will not be displayed. This property can be changed from true to false by executing the proper search command (:search:). Once the property is set to false using the search command, you must edit the properties here to return it to its original state.

Use:
<ShowSearch xmlns='webpart_namespace'>true/false</ShowSearch>

Example:
<ShowSearch xmlns='CorasWSC.Document.RollUp'>true</ShowSearch>< /FONT>