傳輸指令清單架構
這些項目組成 Web 發佈和在線列印排序精靈傳輸指令清單中使用的 XML 架構。
下列元素是針對傳輸指令清單所定義。
- 已取消的頁面
- 失敗頁面
- 我的最愛
- 檔案
- filelist
- 資料夾
- folderlist
- formdata
- htmlui
- imageproperty
- 元數據
- netplace
- 文章
- 重設大小
- successpage
- 目標
- transfermanifest
- uploadinfo
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 元素的資訊,可用來建立 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 元素可以包含在單一 元數據 節點之下。
語法
<imageproperty
id = "string"
>
<!-- child elements -->
</imageproperty>
屬性
屬性 | 描述 |
---|---|
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 標頭。 如果服務選擇使用 World Wide Web Distributed Authoring and Versioning (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 元素 | 子專案 |
---|---|
沒有 | filelist、 folderlistuploadinfo |
uploadinfo
用於提供交易所用上傳網站信息的元素容器。 多個 uploadinfo 元素可以包含在單一 transfermanifest 節點下。
語法
<uploadinfo
friendlyname = "string"
>
<!-- child elements -->
</uploadinfo>
屬性
屬性 | 描述 |
---|---|
friendlyname | 必填。 精靈中顯示的網站易記名稱。 |
元素資訊
Parent 元素 | 子專案 |
---|---|
transfermanifest | cancelledpage、failurepage、favorite、htmlui、netplace、successpage、target |