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: The 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.

LCIDXML

This property applies specifically to document libraries. It allows you to localize the user interface. The easiest way to use this property is to follow these steps:

1.  Copy the sample code below into Notepad and make the appropriate translations to the content between each tag.

2.  Remove all of the carriage returns and replace any double quotes (“) with single quotes (‘). Make sure there aren’t any brackets ([ ]) anywhere in the text. If there are, replace them with parentheses ( ). The XML nodes must appear in the exact order as they are shown below; you can not omit nodes or reorder them.

3.  Export the web part you want to localize and add this: <LCIDXML xmlns="webpart_namespace"><![TA[]]></LCIDXML>  (where 'webpart_namespace' is the web part names identified in the .chm file included in the Developer and Small Business editions of the Suite)
For example: <LCIDXML  xmlns="CorasWSC.Chart.Display"><![TA[]]></LCIDXML>

4.  Copy the modified LCIDXML content from Step 2 and place it after the opening bracket after TA.

5.  Save the localized web part and import it into your site. CorasWorks recommends that you use a naming convention that makes it clear which language(s) are supported by the web part.

Sample Code:
<?xml version='1.0' ?>
<CorasWorks>
 <RollUp id='default'>
  <ReturnType>Return Type:</ReturnType>
  <Administration>Administration</Administration>
  <SiteUrl>Site URL:</SiteUrl>
  <LevelsSearch>Levels Searched:</LevelsSearch>
  <Schemas>Schema(s):</Schemas>
  <AvailableLists>Available List(s):</AvailableLists>
  <CurrentLists>Current List(s):</CurrentLists>
  <CloseAdministration>Close Administration</CloseAdministration>
  <Status>Status:</Status>
  <ReturnSitesList>Return Sites &amp; Lists</ReturnSitesList>
  <Selective>Selective</Selective>
  <LineofSite>Line of Site</LineofSite>
  <UtilizeAllSChemas>Utilize All Schemas:</UtilizeAllSChemas>
  <SaveSelection>Save Selection</SaveSelection>
  <SelectAllSiteLists>Select All Sites &amp; Lists</SelectAllSiteLists>
  <RemoveAllSiteLists>Remove All Sites &amp; Lists</RemoveAllSiteLists>
  <AddList>Add List</AddList>
  <RemoveList>Remove List</RemoveList>
  <SelectSearchCriteria>Select Search Criteria</SelectSearchCriteria>
  <Search>Search</Search>
  <AddItem>Add Item</AddItem>
  <NoItemsFound>No Items Found - Please Check Your Lists, Filter, or Search Criteria</NoItemsFound>
  <ExecuteSearch>Please Execute a Search to See Results</ExecuteSearch>
  <ShowAdmin>Show Admin</ShowAdmin>
  <ShowVersion>Show Version</ShowVersion>
  <Action>Actions</Action>
  <ThisProcess>This Process Is Exceeding Its Time Limitations</ThisProcess>
  <ChartType>Chart Type:</ChartType>
  <Charts>Charts</Charts>
  <ThreeDPie>3D Pie</ThreeDPie>
  <TwoDPie>2D Pie</TwoDPie>
  <ThreeDMultiLevelPie>3D Multi-Level Pie</ThreeDMultiLevelPie>
  <TwoDHorChart>2D Hor. Chart</TwoDHorChart>
  <ThreeDHorChart>3D Hor. Chart</ThreeDHorChart>
  <TwoDVerChart>2D Ver. Chart</TwoDVerChart>
  <ThreeDVerChart>3D Ver. Chart</ThreeDVerChart>
  <Gannt>Gannt</Gannt>
  <IncorrectSettings>Incorrect Settings in Chart Properties. Please Check Your Settings and Try Again.</IncorrectSettings>
 </RollUp>
</CorasWorks>

Note that the XML nodes must all appear on a single line, in the exact order as they are displayed above. You can not omit nodes or reorder them.

The CorasWorks node supports multiple RollUp nodes, allowing for the same web part to be used on multiple sites. When the web part loads, the language of the site that the web part is hosted in will automatically be used, provided an ID attribute for the site’s RollUp node has been defined, otherwise, the RollUp node with an attribute of 'default' will be used.

To localize the web part for multiple languages, repeat these tags (and the content in between) for each language. However, instead of using ‘default’ after the web part ID, use one of the 4-digit LCIDs provided below. Copy the rest of the LCIDXML text and place it between these tags for each desired language, making the appropriate translations for each language.

The following list shows the LCID for each language:
LCID Language
1025 Arabic
2052 Chinese - Simplified
1028 Chinese - Traditional
1029 Czech
1030 Danish
1043 Dutch
1033 English
1035 Finnish
1036 French
1031 German
1032 Greek
1037 Hebrew
1038 Hungarian
1040 Italian
1041 Japanese
1042 Korean
1044 Norwegian
1045 Polish
2070 Portuguese
1046 Portuguese – Brazilian
1049 Russian
1034 Spanish
1053 Swedish
1054 Thai
1055 Turkish

 

ListType (String) [? Flash]

This property allows you to alter the generic schema that will be used by the web part. Currently "Announcements", "Contacts", "Documents", "Events", "Links", and "Tasks" are supported. Once this is changed the generic schema that is stored in the DLL will be reset to utilize this property. By default "Tasks" is utilized as the chart properties are designed to support automatically this list type. This will be overridden if a new List Schema has been added to the DWP.
Use: <ListType xmlns='webpart_namespace'>List Type</ListType>
Example: <ListType xmlns='CorasWSC.Chart.Display'>Tasks</ListType>

SearchAbove1Site (boolean)

This property allows you to start the collection of list items for roll-up display one level above the site identified in the Site URL field. This applies to Line of Site roll-ups only.

ShowCorasWorks (Boolean) - Search Command :corasworks:

This property allows the "Powered By CorasWorks" text to be hidden or shown at the top of the web part display. If this property is set to true, the user will see the "Powered By CorasWorks" text. If this property is set to false, the user will not see this text. This property can be changed from true to false or from false to true by executing the proper search command.

Use: <ShowCorasWorks xmlns='webpart_namespace'>true/false</ShowCorasWorks>
Example: <ShowCorasWorks xmlns='CorasWSC.Chart.Display'>true</ShowCorasWorks>

ShowSearch (Boolean) - Search Command :search: [? Flash]

This property allows the List Return Search Bar to be hidden or shown. If this property is set to true, the user will see the List Return Search Bar. If this property is set to false, the user will not be able to view or use the List Return Search Bar. This property can be changed from true to false by executing the proper search command. Once the property is set in the search command, you can only return it to its original state by editing the properties here.

Use: <ShowSearch xmlns='webpart_namespace'>true/false</ShowSearch>
Example: <ShowSearch xmlns='CorasWSC.Chart.Display'>true</ShowSearch>

UseLike (Boolean)

This Property toggles whether, after a cell consumer connection has been established, the filter used will do so with a LIKE phrase or a direct "=" phrase. By default, LIKE is used so that those lists which contain choice or lookup fields will be relatively searched within.
Use: <UseLike xmlns='webpart_namespace'>true/false</UseLike>
Example: <UseLike xmlns='CorasWSC.Chart.Display'>true</UseLike>