传输清单架构

这些元素构成了 Web 发布和联机打印排序向导传输清单中使用的 XML 架构。

为传输清单定义了以下元素。

cancelledpage

指定在用户单击“取消 ”按钮 关闭向导之前显示的服务器端 HTML 页面。

语法

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

属性

属性 描述
href 必填。 当用户单击“取消 ”按钮时要显示的服务器端 HTML 页面的 URL。

 

元素信息

Parent 元素 子元素
uploadinfo 没有

 

failurepage

指定上传未成功时显示的服务器端 HTML 页面。

语法

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

属性

属性 描述
href 必填。 如果上传未成功,则显示服务器端 HTML 页面的 URL。

 

元素信息

Parent 元素 子元素
uploadinfo 没有。 允许文本。

 

喜欢

指示向导在给定 URL 的 收藏夹 菜单中创建收藏夹网站条目。 如果未指定此元素,则将在其位置使用 htmlui 元素。

语法

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

属性

属性 描述
评论 必填。 与 收藏夹 条目关联的注释。
href 必填。 收藏夹 条目的 URL。
名字 必填。 收藏夹 菜单中显示的 URL 的名称。

 

元素信息

Parent 元素 子元素
uploadinfo 没有。 允许文本。

 

文件

描述要复制的单个文件。 多个 文件 元素可以包含在单个 文件列表 节点下。

语法

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

属性

属性 描述
contenttype 自选。 文件的 MIME 类型。
目的地 必填。 文件上传后建议的路径。 此路径相对于上传站点的目标 URL。 上传网站可以根据需要修改此值。
外延 自选。 文件的文件扩展名。
id 必填。 文件的数字索引。
大小 自选。 文件的大小(以字节为单位)。
必填。 文件的完整文件系统路径。

 

元素信息

Parent 元素 子元素
filelist 元数据发布调整大小

 

filelist

描述要复制的文件的元素的容器。 多个 文件列表 元素可以包含在单个 transfermanifest 节点下。

语法

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

属性

属性 描述
usesfolders 未实现。

 

元素信息

Parent 元素 子元素
transfermanifest 文件

 

文件夹

描述存储文件的文件夹。 多个 文件夹 元素可以包含在单个 文件夹列表 节点下。

语法

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

属性

属性 描述
目的地 必填。 上传文件夹后,该文件夹的建议路径。 此路径相对于上传站点的目标 URL。 上传网站可以根据需要修改此值。

 

元素信息

Parent 元素 子元素
folderlist 没有

 

folderlist

描述要复制的文件的元素的容器。 多个 文件夹列表 元素可以包含在单个 transfermanifest 节点下。

语法

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

属性

没有。

元素信息

Parent 元素 子元素
transfermanifest 文件夹

 

formdata

描述可能随文件一起传输的可选 HTML 编码表单数据。 如果服务选择将文件上传为多部分文章,则服务会添加此元素。 表单数据以及 post 元素中的信息用于创建帖子标头。

多个 formdata 元素可以包含在单个 uploadinfo 节点下。

语法

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

属性

属性 描述
名字 必填。 定义与上传的此部分关联的表单数据名称。

 

元素信息

Parent 元素 子元素
uploadinfo 没有

 

htmlui

关闭向导时要显示的服务器端 HTML 页面的 URL。 如果缺少 收藏夹 元素并且指定了上传网站的友好名称,则此元素将在 收藏夹 菜单中创建收藏夹网页条目。

语法

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

属性

属性 描述
href 必填。 关闭向导时要显示的服务器端 HTML 页面的 URL。

 

元素信息

Parent 元素 子元素
uploadinfo 没有。 允许文本。

 

imageproperty

指定与文件相关的图像属性。 多个 映像属性 元素可以包含在单个 元数据 节点下。

语法

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

属性

属性 描述
id 必填。 特定属性的 ID。

 

元素信息

Parent 元素 子元素
元数据 没有。 允许文本。

 

元数据

用于定义特定文件的元数据的元素和文本的容器。 多个 元数据 元素可以包含在单个 文件 节点下。

语法

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

属性

没有。

元素信息

Parent 元素 子元素
文件 imageproperty

 

netplace

定义在上传完成后 “我的网络位置” 中创建的网络位置的目标。 可以通过 IPublishingWizard::Initialize 方法阻止创建网络位置。

语法

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

属性

属性 描述
评论 必填。 当光标位于该图标上时,为网络位置图标显示的注释。
href 必填。 网络位置条目的 URL。
名字 必填。 “我的网络位置” 文件夹中显示的网络位置图标的名称。

 

元素信息

Parent 元素 子元素
uploadinfo 没有。 允许文本。

 

发布

应向其发布文件的 URL。 当传输作为多部分发布完成时,服务会添加此元素,并使用 formdata生成 post 标头。 如果服务选择使用万维网分布式创作和版本控制(WebDAV)执行文件传输,则不应添加此元素。 多个 元素可以包含在单个 文件 节点下。

语法

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

属性

属性 描述
文件名 自选。 已发布文件的文件名。
href 必填。 目标文件夹的 URL。
名字 必填。 定义与帖子的此部分关联的表单数据名称。

 

元素信息

Parent 元素 子元素
文件 formdata

 

调整

将图像文件的缩放和重新压缩定义为 JPEG 格式。 如果源文件已采用 JPEG 格式且小于或等于指定的宽度和高度,则不会调整其大小。 如果源文件不是 JPEG 文件,则会转换该文件。 可以通过 IPublishingWizard::Initialize 方法阻止文件的缩放、重新压缩和转换。 多个 调整大小 元素可以包含在单个 文件 节点下。

语法

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

属性

属性 描述
cx 必填。 上传后图像的宽度(以像素为单位)。 如果此值为 0,则从 cy 值计算 cx 以保留相对维度。
cy 必填。 上传后图像的高度(以像素为单位)。 如果此值为 0,则从 cx 值计算 cy 以保留相对维度。
质量 必填。 JPEG 质量值,介于 0 到 100 之间,100 是最高的质量。

 

元素信息

Parent 元素 子元素
文件 没有。

 

successpage

指定上传成功时显示的服务器端 HTML 页面。

语法

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

属性

属性 描述
href 必填。 如果上传成功,则显示服务器端 HTML 页面的 URL。

 

元素信息

Parent 元素 子元素
uploadinfo 没有。 允许文本。

 

目标

以通用命名约定(UNC)格式或 WebDAV 服务器指定的目标文件夹。 如果传输使用 WebDAV 或文件系统协议,该服务将添加此目标以指定目标文件夹。 如果服务选择将文件传输作为多部分发布,则不应添加此元素。

语法

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

属性

属性 描述
href 必填。 目标文件夹的 URL。 使用 WebDAV 的 https:// 窗体或用于 UNC 的 \\server\share 窗体。

 

元素信息

Parent 元素 子元素
uploadinfo 没有。 允许文本。

 

transfermanifest

传输清单文件的父节点。

语法

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

属性

没有。

元素信息

Parent 元素 子元素
没有 filelistfolderlistuploadinfo

 

uploadinfo

用于提供事务中使用的上传站点中信息的元素的容器。 多个 uploadinfo 元素可以包含在单个 transfermanifest 节点下。

语法

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

属性

属性 描述
friendlyname 必填。 向导中显示的网站的友好名称。

 

元素信息

Parent 元素 子元素
transfermanifest 已取消的页failurepage收藏夹htmluinetplacesuccesspage目标