After the shared and personal properties for a web part are modified using the task pane, you can capture the current state of the web part as a .dwp file by selecting Export from the web part menu. You can also add elements to the .dwp file to specify additional property values, overriding the default property settings implemented in the web part code.
To export a DWP file from a WSS site:
1. Open the site and select Export from the web part menu. You will be prompted for a location where you want to save the exported web part.
2. Click the Save button and then save the DWP file to the identified location.
Editing a DWP file is not difficult. Simply open the file in Windows Notepad, modify the settings, and then save your changes. Since the DWP file is an XML file, you can edit it with any XML-compatible editor.
Whenever you edit a DWP file, make sure you are using the correct XML namespace for the web part. The XML namespaces for the CorasWorks web parts are listed in this help file under the CorasWorks XML Namespaces topic. That topic also includes a listing of all the available DWP properties that you can modify for each CorasWorks web part.
Below are the contents of a sample DWP file for a Contacts Roll-Up Advanced web part. To modify the default behavior of this web part, simply modify the value of the XML node for the property you want to change. If the property is not listed, you can add it to the XML.
<?xml version="1.0" encoding="utf-8"?>
<WebPart xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/WebPart/v2">
<Title>Contact Roll-Up Advanced</Title>
<FrameType>Default</FrameType>
<Description>This Web Part will rollup all Contact Lists into a Tree-View form. From here users can manage, filter, and search Contact list items.</Description>
<IsIncluded>true</IsIncluded>
<ZoneID>Left</ZoneID>
<PartOrder>3</PartOrder>
<FrameState>Normal</FrameState>
<Height />
<Width />
<AllowRemove>false</AllowRemove>
<AllowZoneChange>true</AllowZoneChange>
<AllowMinimize>true</AllowMinimize>
<IsVisible>true</IsVisible>
<DetailLink />
<HelpLink>http://central.workplace.corasworks.net/support/WebPartHelp/CWSCARST.aspx</HelpLink>
<Dir>Default</Dir>
<PartImageSmall />
<MissingAssembly>This Web Part has failed to load due to a missing software file. Please contact CorasWorks (http://www.corasworks.net) and provide them with the name of the Web Part [Contact Roll-Up Adv] and the URL in your browser.</MissingAssembly>
<PartImageLarge>_WPR_/contact.gif</PartImageLarge>
<IsIncludedFilter />
<Assembly>CorasWSC.Contact.RollUp.Adv, Version=51.0.26.1, Culture=neutral, PublicKeyToken=a66eaee6d3fbdabb</Assembly>
<TypeName>CorasWSC.Contact.RollUp.Adv</TypeName>
<ShowAdmin xmlns="CorasWSC.Contact.RollUp">false</ShowAdmin>
</WebPart>
Below, we have added a new property to the DWP file called ReturnType and have set the value to los. Now any new web part that is instantiated from this DWP file will have the Return Type of Line of Site instead of the default of Selective. Note the namespace (the xmlns tag) used must match the correct namespace for the web part being modified. In this case, it is CorasWSC.Contact.RollUp. For a list of CorasWorks namespaces, see CorasWorks XML Namespaces.
<?xml version="1.0" encoding="utf-8"?>
<WebPart xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/WebPart/v2">
<Title>Contact Roll-Up Advanced</Title>
<FrameType>Default</FrameType>
<Description>This Web Part will rollup all Contact Lists into a Tree-View form. From here users can manage, filter, and search Contact list items.</Description>
<IsIncluded>true</IsIncluded>
<ZoneID>Left</ZoneID>
<PartOrder>3</PartOrder>
<FrameState>Normal</FrameState>
<Height />
<Width />
<AllowRemove>false</AllowRemove>
<AllowZoneChange>true</AllowZoneChange>
<AllowMinimize>true</AllowMinimize>
<IsVisible>true</IsVisible>
<DetailLink />
<HelpLink>http://central.workplace.corasworks.net/support/WebPartHelp/CWSCARST.aspx</HelpLink>
<Dir>Default</Dir>
<PartImageSmall />
<MissingAssembly>This Web Part has failed to load due to a missing software file. Please contact CorasWorks (http://www.corasworks.net) and provide them with the name of the Web Part [Contact Roll-Up Adv] and the URL in your browser.</MissingAssembly>
<PartImageLarge>_WPR_/contact.gif</PartImageLarge>
<IsIncludedFilter />
<Assembly>CorasWSC.Contact.RollUp.Adv, Version=51.0.26.1, Culture=neutral, PublicKeyToken=a66eaee6d3fbdabb</Assembly>
<TypeName>CorasWSC.Contact.RollUp.Adv</TypeName>
<ReturnType xmlns="CorasWSC.Contact.RollUp">los</ReturnType>
</WebPart>
When you have finished editing the DWP file, save your changes and then use the sites Import feature to import the DWP file into a WSS site. Detailed procedures for doing this are provided below.
In order to use the DWP files you have modified, you must import them into a WSS site.
NOTE: The assembly for the web part must be available in the server's Global Assembly Cache (GAC) for the web part to work.
To upload a DWP file, follow these steps:
1. From either the Modify Shared Page or Modify My Page menu, select Add Web Parts and then Import.
2. In the web parts tool part pane, enter the path to the DWP file. Optionally, you can click the Browse button and navigate to the DWP file.
3. Click the Upload button. The DWP file will be uploaded and a new web part will now be displayed under the Uploaded Web Part heading.
The web part can now be used by dragging it from the Uploaded Web Part area to a web part zone.
You can make modifications directly to a web part's DWP properties using FrontPage's code view. Note that when you modify DWP properties using FrontPage, the modifications only apply to the current instance for the web part. Any new web parts added to the page will not be affected by your modifications.
Follow these steps to modify the DWP properties using FrontPage:
1. Open the desired page in FrontPage 2003. The easiest way to do this is to use Internet Explorer and navigate to the page and then click the Edit with Office FrontPage toolbar button, located in the Internet Explorer toolbar.
2. You may be prompted for you login credentials. If you do not have permission to modify the page, you will not be able to open it successfully using FrontPage.
3. Once the page loads, click on top of the web part that you want to modify.
4. Switch to FrontPage's Code view for the page. You should now see the web part's DWP properties.
5. Follow the instructions listed under the Edit DWP section (below) and change the web part’s settings.
6. When you are finished modifying the DWP properties, use FrontPage to save the web page back to the server.
Whenever you edit a DWP file, make sure you are using the correct XML namespace for the web part. The XML namespaces for the CorasWorks web parts are listed in this help file in the CorasWorks XML Namespaces topic. This topic also includes a listing of all the available DWP properties that you can modify for each CorasWorks web part.
Below are the contents of a sample web part's DWP properties for a Contacts Roll-Up Advanced web part. To modify the default behavior of this web part, simply modify the value of the XML node for the property you want to change. If the property is not listed, add it to the XML.
<WpNs1:Adv runat="server" WebPart="true" __WebPartId="{7BADAD93-769F-4470-BE83-DAD12B65252F}" >
<WebPart xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/WebPart/v2">
<Title>Contact Roll-Up Advanced</Title>
<FrameType>Default</FrameType>
<Description>This Web Part will rollup all Contact Lists into a Tree-View form. From here users can manage, filter, and search Contact list items.</Description>
<IsIncluded>true</IsIncluded>
<PartOrder>3</PartOrder>
<FrameState>Normal</FrameState>
<Height />
<Width />
<AllowRemove>false</AllowRemove>
<AllowZoneChange>true</AllowZoneChange>
<AllowMinimize>true</AllowMinimize>
<IsVisible>true</IsVisible>
<DetailLink />
<HelpLink>http://central.workplace.corasworks.net/support/WebPartHelp/CWSCARST.aspx</HelpLink>
<Dir>Default</Dir>
<PartImageSmall />
<MissingAssembly>This Web Part has failed to load due to a missing software file. Please contact CorasWorks (http://www.corasworks.net) and provide them with the name of the Web Part [Contact Roll-Up Adv] and the URL in your browser.</MissingAssembly>
<PartImageLarge>_WPR_/contact.gif</PartImageLarge>
<IsIncludedFilter />
<ExportControlledProperties>false</ExportControlledProperties>
<ConnectionID>00000000-0000-0000-0000-000000000000</ConnectionID>
<ShowAdmin xmlns="CorasWSC.Contact.RollUp">false</ShowAdmin>
</WebPart>
</WpNs1:Adv>
Below, we have added a new property called ReturnType and have set the value to los. Note the namespace (the xmlns tag) used must match the correct namespace for the web part being modified. In this case it is CorasWSC.Contact.RollUp. For a list of CorasWorks namespaces, please see CorasWorks XML Namespaces.
<WpNs1:Adv runat="server" WebPart="true" __WebPartId="{7BADAD93-769F-4470-BE83-DAD12B65252F}" >
<WebPart xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/WebPart/v2">
<Title>Contact Roll-Up Advanced</Title>
<FrameType>Default</FrameType>
<Description>This Web Part will rollup all Contact Lists into a Tree-View form. From here users can manage, filter, and search Contact list items.</Description>
<IsIncluded>true</IsIncluded>
<PartOrder>3</PartOrder>
<FrameState>Normal</FrameState>
<Height />
<Width />
<AllowRemove>false</AllowRemove>
<AllowZoneChange>true</AllowZoneChange>
<AllowMinimize>true</AllowMinimize>
<IsVisible>true</IsVisible>
<DetailLink />
<HelpLink>http://central.workplace.corasworks.net/support/WebPartHelp/CWSCARST.aspx</HelpLink>
<Dir>Default</Dir>
<PartImageSmall />
<MissingAssembly>This Web Part has failed to load due to a missing software file. Please contact CorasWorks (http://www.corasworks.net) and provide them with the name of the Web Part [Contact Roll-Up Adv] and the URL in your browser.</MissingAssembly>
<PartImageLarge>_WPR_/contact.gif</PartImageLarge>
<IsIncludedFilter />
<ExportControlledProperties>false</ExportControlledProperties>
<ConnectionID>00000000-0000-0000-0000-000000000000</ConnectionID>
<ShowAdmin xmlns="CorasWSC.Contact.RollUp">false</ShowAdmin>
<ReturnType xmlns="CorasWSC.Contact.RollUp">los</ReturnType>
</WebPart>
</WpNs1:Adv>
Back to Top