Custom Displays: Introduction

CorasWorks roll-ups support customization through the addition of JavaScripting to the DWP and combination with other web parts.  Roll-ups that have been enhanced in this manner are called “custom displays.”  The following topics provide detailed procedures for a number of custom displays utilized in CorasWorks solutions and the CorasWorks showroom. You can create an unlimited number of custom displays by making your own modifications utilizing supported features, or by referencing the examples presented here.  With custom displays, you can total numeric fields, change how columns are displayed, color code them, and more.

These examples are provided for your reference to see the types of things that can be done with custom displays. They are meant to be used as a springboard for your imagination, and are not meant to be considered as “the only way” to customize roll-ups.

Modifying the DWP

The web parts referenced in the following sections have a number of properties that can only be modified by manually editing the DWP file associated with the web part. A DWP file can be edited by exporting the web part to a location of your choice, making the desired changes, and then uploading it back onto a site.  Complete procedures for modifying DWPs are provided in the Web Part DWP Modification – Overview topic.  The basic steps are as follows:

1.  Go to the web page with the roll-up web part that you want to alter.

2.  Go to Modify Shared Page and then choose Design this page. This will place the page into design mode.

3.  Choose Export from the web part menu.

4.  Save the file, placing it somewhere on your local drive where you can find it.

5.  Open the exported DWP file in Notepad. You will see some XML code.

6.  Make the necessary changes as described in the topics in this section.

7.  Save the updated DWP file. You might want to alter the name of the file to keep the original in case there is a mistake.

8.  Go back to your web page and choose Modify Shared Page/Add Web Parts/Import.

9.  In the Add Web Parts property section, browse for the updated web part and then upload it.

IMPORTANT! This section of help includes Display HTML and JavaScript that can be copied and pasted into your DWP. However, when you copy and paste from the help into FrontPage, hard returns may be inserted. These will need to be removed to avoid any errors.

 

When modifying a DWP, keep in mind the XML namespace of the web part being changed, or the properties will not be enabled within the web part.  XML namespaces for all CorasWorks web parts are provided in the XML Namespaces help topic.

Also note that some of the web part properties require the use of a "<", ">", or "&" symbol. If that is the case, these characters must be replaced with their encoded equivalents of "&lt;", "&gt;", and "&amp;" respectively, unless utilizing the XML CDATA element. (Example <![CDATA[ HTML TEXT ]]>)