Transfer Manifest Schema

These elements make up the XML schema used in the Web Publishing and Online Print Ordering wizards' transfer manifest.

The following elements are defined for the transfer manifest.

cancelledpage

Specifies the server-side HTML page to display before the wizard is closed when the user clicks the Cancel button.

Syntax



<cancelledpage
    href = "string"
>
<!-- child elements -->
</cancelledpage>					
					

Attributes

AttributeDescription
hrefRequired. The URL of the server-side HTML page to display when the user clicks the Cancel button.

 

Element Information

Parent ElementChild Elements
uploadinfoNone

 

failurepage

Specifies the server-side HTML page to display if the upload is not successful.

Syntax



<failurepage
    href = "string"
>
<!-- child elements -->
</failurepage>					
					

Attributes

AttributeDescription
hrefRequired. The URL of the server-side HTML page to display if the upload is not successful.

 

Element Information

Parent ElementChild Elements
uploadinfoNone. Text is allowed.

 

favorite

Instructs the wizard to create a favorite website entry in the Favorites menu for the given URL. If this element is not specified, then the htmlui element is used in its place.

Syntax



<favorite
    comment = "string"
    href = "string"
    name = "string"
>
<!-- child elements -->
</favorite>					
					

Attributes

AttributeDescription
commentRequired. The comment associated with the Favorites entry.
hrefRequired. The URL of the Favorites entry.
nameRequired. The name for the URL that appears in the Favorites menu.

 

Element Information

Parent ElementChild Elements
uploadinfoNone. Text is allowed.

 

file

Describes a single file to be copied. Multiple file elements may be contained under a single filelist node.

Syntax



<file
    contenttype = "string"
    destination = "string"
    extension = "string"
    id = "string"
    size = "string"
    source = "string"
>
<!-- child elements -->
</file>					
					

Attributes

AttributeDescription
contenttypeOptional. The MIME type of the file.
destinationRequired. A suggested path for the file once it is uploaded. This path is relative to the upload site's destination URL. The upload site can modify this value as necessary.
extensionOptional. The file name extension of the file.
idRequired. The numerical index of the file.
sizeOptional. The size of the file, in bytes.
sourceRequired. The full file system path for the file.

 

Element Information

Parent ElementChild Elements
filelistmetadata, post, resize

 

filelist

A container for elements describing the files to be copied. Multiple filelist elements may be contained under a single transfermanifest node.

Syntax



<filelist
    usesfolders = "1"
>
<!-- child elements -->
</filelist>					
					

Attributes

AttributeDescription
usesfoldersNot implemented.

 

Element Information

Parent ElementChild Elements
transfermanifestfile

 

folder

Describes a folder in which files are stored. Multiple folder elements may be contained under a single folderlist node.

Syntax



<folder
    destination = "string"
>
<!-- child elements -->
</folder>					
					

Attributes

AttributeDescription
destinationRequired. A suggested path for the folder once it is uploaded. This path is relative to the upload site's destination URL. The upload site can modify this value as necessary.

 

Element Information

Parent ElementChild Elements
folderlistNone

 

folderlist

A container for elements describing the files to be copied. Multiple folderlist elements may be contained under a single transfermanifest node.

Syntax



<folderlist>
<!-- child elements -->
</folderlist>					
					

Attributes

None.

Element Information

Parent ElementChild Elements
transfermanifestfolder

 

formdata

Describes optional HTML encoded form data that may be transferred with the files. This element is added by the service if it elects to upload the files as a multi-part post. The form data, together with information from the post element, is used to create the post header.

Multiple formdata elements may be contained under a single uploadinfo node.

Syntax



<formdata
    name = "string"
>
<!-- child elements -->
</formdata>					
					

Attributes

AttributeDescription
nameRequired. Defines the form data name associated with this section of the upload.

 

Element Information

Parent ElementChild Elements
uploadinfoNone

 

htmlui

The URL of the server-side HTML page to display when the wizard is closed. This element creates a favorite webpage entry in the Favorites menu if the favorite element is absent and the upload site's friendly name is specified.

Syntax



<htmlui
    href = "string"
>
<!-- child elements -->
</htmlui>					
					

Attributes

AttributeDescription
hrefRequired. The URL of the server-side HTML page to display when the wizard is closed.

 

Element Information

Parent ElementChild Elements
uploadinfoNone. Text is allowed.

 

imageproperty

Specifies an image property relating to the file. Multiple imageproperty elements may be contained under a single metadata node.

Syntax



<imageproperty
    id = "string"
>
<!-- child elements -->
</imageproperty>					
					

Attributes

AttributeDescription
idRequired. The ID of the particular property.

 

Element Information

Parent ElementChild Elements
metadataNone. Text is allowed.

 

metadata

A container for elements and text defining metadata for the particular file. Multiple metadata elements may be contained under a single file node.

Syntax



<metadata>
<!-- child elements -->
</metadata>					
					

Attributes

None.

Element Information

Parent ElementChild Elements
fileimageproperty

 

netplace

Defines the target for a network place that is created in My Network Places when the upload is complete. Creation of a network place can be prevented through the IPublishingWizard::Initialize method.

Syntax



<netplace
    comment = "string"
    href = "string"
    name = "string"
>
<!-- child elements -->
</netplace>					
					

Attributes

AttributeDescription
commentRequired. The comment displayed for the network place icon when the cursor rests on it.
hrefRequired. The URL of the network place entry.
nameRequired. The name for the network place icon that appears in the My Network Places folder.

 

Element Information

Parent ElementChild Elements
uploadinfoNone. Text is allowed.

 

post

URL to which the file should be posted. This element is added by the service when the transfer is done as a multi-part post and, with formdata, is used to build the post header. If the service chooses to perform the file transfer using World Wide Web Distributed Authoring and Versioning (WebDAV), it should not add this element. Multiple post elements may be contained under a single file node.

Syntax



<post
    filename = "string"
    href = "string"
    name = "string"
>
<!-- child elements -->
</post>					
					

Attributes

AttributeDescription
filenameOptional. The file name for the posted file.
hrefRequired. The URL of the destination folder.
nameRequired. Defines the form data name associated with this section of the post.

 

Element Information

Parent ElementChild Elements
fileformdata

 

resize

Defines the scaling and recompression of an image file into JPEG format. If the source file is already in JPEG format and is less than or equal to the specified width and height, it is not sized. If the source file is not a JPEG file, it is converted. Scaling, recompression, and conversion of the file can be prevented through the IPublishingWizard::Initialize method. Multiple resize elements may be contained under a single file node.

Syntax



<resize
    cx = "string"
    cy = "string"
    quality = "string"
>
<!-- child elements -->
</resize>					
					

Attributes

AttributeDescription
cxRequired. The width of the image, in pixels, after uploading. If this value is 0, then cx is calculated from the cy value to preserve relative dimensions.
cyRequired. The height of the image, in pixels, after uploading. If this value is 0, then cy is calculated from the cx value to preserve relative dimensions.
qualityRequired. The JPEG quality value, between 0 and 100, with 100 being the highest quality.

 

Element Information

Parent ElementChild Elements
fileNone.

 

successpage

Specifies the server-side HTML page to display if the upload is successful.

Syntax



<successpage
    href = "string"
>
<!-- child elements -->
</successpage>					
					

Attributes

AttributeDescription
hrefRequired. The URL of the server-side HTML page to display if the upload is successful.

 

Element Information

Parent ElementChild Elements
uploadinfoNone. Text is allowed.

 

target

A destination folder specified in Universal Naming Convention (UNC) format or as a WebDAV server. The service adds this target to specify a destination folder if the transfer uses a WebDAV or file system protocol. If the service chooses to perform the file transfer as a multi-part post, it should not add this element.

Syntax



<target
    href = "string"
>
<!-- child elements -->
</target>					
					

Attributes

AttributeDescription
hrefRequired. The URL of the destination folder. Use the http:// form for WebDAV or the \\server\share form for UNC.

 

Element Information

Parent ElementChild Elements
uploadinfoNone. Text is allowed.

 

transfermanifest

The parent node of the transfer manifest file.

Syntax



<transfermanifest>
<!-- child elements -->
</transfermanifest>					
					

Attributes

None.

Element Information

Parent ElementChild Elements
Nonefilelist, folderlist, uploadinfo

 

uploadinfo

A container for elements providing information from the upload site used in the transaction. Multiple uploadinfo elements may be contained under a single transfermanifest node.

Syntax



<uploadinfo
    friendlyname = "string"
>
<!-- child elements -->
</uploadinfo>					
					

Attributes

AttributeDescription
friendlynameRequired. A friendly name for the website which is displayed in the wizard.

 

Element Information

Parent ElementChild Elements
transfermanifestcancelledpage, failurepage, favorite, htmlui, netplace, successpage, target

 

 

 

Community Additions

ADD
Show:
© 2014 Microsoft