Web Part Settings

The majority of the properties associated with a Data Display are view-specific. However, a few properties apply to the entire instance of the component. These properties are located on the Web Part Settings page, which is accessed via the Web Part Settings button on the Display Wizard’s Views page.

There are four sections on this page, described below.

Display Text

This section is used to define:

      Display Title – The title that is shown to the end user at the top of the Grid Display.

      Display Description – The component description that is displayed to the user in a pop-up when they hover over the Grid Display name.

Display Width and Height

Only displayed when using the v11.1 and earlier Grid Type (see below).  The properties in this section allow the builder to define a static size to apply to the Grid Display. If the default values are kept in the Height and Width properties (0 or -1), the Grid Display will automatically size to fit the available space in the web part zone. Otherwise, the desired size (measured in pixels) can be specified here. Do not clear the value in the Custom Column Headers Adjustment Value property, or the column headers will not be displayed.

Display Theme

This section is used to identify the color theme to apply to the Grid Display. Options are available to use the SharePoint color theme that is already applied to the page, use a custom theme file, or select one of the pre-built themes developed by CorasWorks.

      With the v11.2 release (and later), there is a new display interface for the Calendar.  This interface supports a series of predefined skins.  The default skin is Sitefinity, which offers the greatest compatibility with SharePoint 2010.

End User Help

This section is used to identify whether or not the help icon should be displayed to end users on the toolbar, web part menu, and in the display footer. It can also be used to bring the end user to a different set of online help. These properties do not affect the help displayed to builders in the Display Wizard.

      The default is for help icons to be shown to end users.

      The builder can choose to use the CorasWorks online help or point the component to help at a URL that they specify. The builder is responsible for creating and maintaining any alternative help that they specify with the Use help at this URL property.

Grid Type

This section is used for selecting the type of control to use.  There are three choices within the drop-down menu:

      Default: this option tells the component to use the display interface that has been set for the CorasWorks Platform installation.  This is set at the server-level and the settings are one of the options presented below.

      v11.2 (new interface): this option uses the new display interface.  This interface offers better performance and SharePoint 2010 compatibility.

      v11.1 and earlier: this option uses the original v11 display interface.  This option is presented for backward compatibility.
 

 

NOTE

The two Grid Types offer different options within the views and the web part.  For example, the Grid exporting and printing options are only available with the v11.2 type.

 

Grid Export

Only displayed when using the v11.1 and earlier Grid Type (see above).  This property can be used to enable and set up the export of data from the data grid.  This property should contain a root node value of ExportInfo along with the elements described below.

IISReportPath

A string that specifies the virtual report path for the temporary reports exported by the grid.

ReportPath

A string that specifies the physical report path for the temporary reports exported by the grid.

DeleteOutputFileTime

A numeric value that specifies how many minutes the temporary file is cached before it is deleted from the server.

Default: 5

Here is an example of valid XML for this property:

<ExportInfo>

<IISReportPath>/GridExports/</IISReportPath>

<ReportPath>D:\GridExports\</ReportPath>

</ExportInfo>