Share via

3.1.4.1 CreatePageLayout

  • Article

This operation is used to create a new page layout within the specified site collection.

 <wsdl:operation name="CreatePageLayout">
     <wsdl:input message="tns:CreatePageLayoutSoapIn" />
     <wsdl:output message="tns:CreatePageLayoutSoapOut" />
 </wsdl:operation>

The protocol client initiates the operation by sending a CreatePageLayoutSoapIn request message to the protocol server, as specified in section 3.1.4.1.1.1.

The protocol server MUST attempt to create a new page layout with the specified file name within the specified site collection, and associate it with the specified associated content type identifier.

  • The protocol server MUST respect the specified file name but MAY<11> override the file name extension if one was specified.

  • If title or description values are present in the input, the protocol server MUST set the corresponding page layout properties accordingly.

  • If the specified site collection does not exist, the specified page layout name is already in use by a page layout in the site collection, or the specified content type identifier does not match the identifier of an existing content type, the protocol server MUST return a SOAP fault.

When the operation finishes execution, the protocol server MUST send a CreatePageLayoutSoapOut message that contains a CreatePageLayoutResult element set to the absolute URL of the newly created page layout, as specified in section 3.1.4.1.1.2 and section 3.1.4.1.2.2.