Share via

3.1.4.4 ConvertWebPartFormat

  • Article

The ConvertWebPartFormat operation<20> converts a Web Part from persistence format to page markup, or vice-versa.<21>

propertyType.null: If the type can have a null value, then if this attribute is set to TRUE, it specifies that the value is null.

propertyContainerType: Specifies a set of properties from which to instantiate a Web Part.

propertyContainerType.property: Specifies one property of the Web Part.

propertyContainerType.ipersonalizable: Specifies a set of properties of the Web Part that can be customized by the user who views the Web Part.

propertyContainerType.ipersonalizable.property: Specifies one property that can be configured for each user.

A Web Part can exist in multiple forms. One is an implementation-specific standalone persistence format that can be used to save a Web Part as a single file, whether on the server or elsewhere. Another is the implementation-specific markup that is inserted into page markup to cause the server to render that Web Part when the user browses the page.

This operation is defined as follows:

 <wsdl:operation name="ConvertWebPartFormat" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
    <wsdl:input message="tns:ConvertWebPartFormatSoapIn" />
    <wsdl:output message="tns:ConvertWebPartFormatSoapOut" />
 </wsdl:operation>

The client sends a ConvertWebPartFormatSoapIn request message (section 3.1.4.4.1.1), and the server responds with a ConvertWebPartFormatSoapOut response message (section 3.1.4.4.1.2).