有效負載與資訊清單
有效負載 Zip 檔案
有效負載檔案是從 WVS 傳送到 Arbortext Publishing Engine 伺服器的 zip 檔案。有效負載包含將用來產生想要之輸出的內容與中繼資料。有效負載的內容是由所請求已發佈輸出的類型,以及請求是針對完整發佈工作還是增量發佈工作來決定。發佈可以從資訊結構、發佈結構或產品階層來啟動。
視發佈請求與結構類型,有效負載的檔案集中可能擁有下列任何檔案:
• manifest.xml
逐項列出在有效負載中找到的所有物件。其中的項目代表有效負載檔案內容的詳細目錄。資訊清單還包括其他資訊,例如發佈規格的 Windchill 路徑、伺服器主機名稱、建立日期、輸出類型以及根結構的 URI。
• PublishInfo.xml
逐項列出與用來建立有效負載之環境和系統相關的資訊。
◦ 有效負載版本
◦ Windchill 版本的系統輸出
◦ 發行版本切換
◦ 發佈工作規格,其中包括 WVS 發佈工作 ID。
◦ 基本服務結構資訊與屬性
在配套中,PublishInfo.xml 也包括配套版本、Arbortext Publishing Engine 版本與交易 ID。
包括在 PublishInfo.xml 中的服務結構屬性可在 publishinfo_attset.xml 中配置。
• windchill.type.name 目錄
一或多個包含結構內容的目錄,例如動態文件。名稱是根據 Windchill 類型形成。可以存在其中一或多個目錄。
• windchill.partlist.PartList 目錄
包含零件清單的目錄,這些零件清單以 partslist.xml 一般標示格式進行序列化。
• 自訂目錄
包含來自
Windchill 之自訂加工品的目錄。自訂加工品可以是非
Windchill 物件或不連結至發行結構、資訊結構或產品階層的物件。此目錄的建立、新增自訂加工品,以及將目錄新增至裝載,都是由
CustomArtifactProvider 擴展功能所控制的。如需詳細資訊,請參閱
發佈的進階自訂。
• Identifier.xml
是以 WVS 傳送之一般標示格式序列化為 XML 檔案的根服務結構。會產生 Identfier。此檔案是代表要處理之根結構的 XML 文件。
在束發佈中,結構按照 URI 來識別,這是固定值,不論語言如何。
• ProductInstances.xml
以序列化 XML 格式包含與產品階層相關聯之產品實例資訊 (如存在)。
ProductInstances.xml 中繼資料屬性可以在 publishable_attset.xml 中配置。
有效負載中物件的 ResourceMap 資訊中的內容元素包含角色屬性,該屬性用來指示檔案的角色。例如,檔案的角色 = "THUMBNAIL_SMALL" 表示檔案是物件的縮圖。
• reps
包含在各種 XML 加工品中指定之 ResourceMap 元素參考的表示。表示並未在有效負載資訊清單中逐項列出。
• pubspec.xml
包含用於從所選 WVS 發行規則進行發行的規格,它將被轉換為 XML 格式以供 Arbortext Publishing Engine 伺服器使用。當選取了發佈規則時,其規格會放置到 pubspec.xml 中,並由 WVS 傳送到 Arbortext Publishing Engine。
另一個 pubspec.xml 檔案存在於 Arbortext Publishing Engine 伺服器上,通常在 Service 應用程式中,其包含一組發行參數的預設值。如果 Arbortext Publishing Engine 伺服器上的檔案有設定預設值的話,在從 WVS 傳送的 pubspec.xml 中指定的參數值會重新定義此預設值。依預設,服務應用程式在下列位置擁有包含預設值的 pubspec.xml 檔案:
Arbortext-path\application\com.ptc.arbortext.service\lib\pubspec.xml
要變更伺服器上 pubspec.xml 中的預設值,請在進行變更之前儲存一份檔案的備份副本。
• OptionsDefinition.xml
指定傳遞至配套的結構。
如果已針對設定檔配置選項集,會包括選項定義。如需詳細資訊,請參閱
發佈中的適用性。
• referencedObjects.xml
包含未包括在有效負載中之參考物件的中繼資料。
您可以設定要包含在 referencedObjects_attset.xml 中的自訂屬性集。
• referencedParts.xml
包含在有效負載中參考之所有零件的中繼資料。
有效負載中物件的 ResourceMap 資訊中的內容元素包含角色屬性,該屬性用來指示檔案的角色。例如,檔案的角色 = "THUMBNAIL_SMALL" 表示檔案是物件的縮圖。
• relatedParts.xml
包含零件清單中由其他零件汰換或具有替代零件的零件之間的關係。
您可透過在 publishable_attset.xml 檔案中輸入的方式,指定要包括的屬性。項目需要指定要針對相關零件發佈之屬性的清單。
• classifications.xml
包含有效負載中使用的「零件」分類類別的名稱、屬性及其預設值。
分類子項屬性不是由
publishable_attset.xml 控制。您可以排除主要分類屬性本身,來排除所有與該分類關聯的屬性 (包括子項屬性)。如需詳細資訊,請參閱
在 Windchill 中分類零件。
• partThumbnails.zip
包含零件的縮圖圖形圖像。縮圖是在具有角色的配套中參考之每個零件的預設表示。
一個零件可以有多個縮圖,且每個縮圖由其角色來識別。thumbnailRole 發佈參數可以指定要包括在配套中的角色。
您也可以使用參數 PartResources 來指定要包括的縮圖。PartResources 提供更大的彈性,可讓您指定多個縮圖節點,以及應包括的 PVZ 元件。
這兩個參數可處理特殊 PVZ 值。針對 thumbnailRole,預設表示會壓縮成將作為零件縮圖使用的 PVZ 檔案。當值為角色時,會將符合指定角色的縮圖置於 partThumbnails.zip 檔案中。PartResources 與 PvzFilter 參數搭配使用時,您可以指定多個角色與 PVZ 元件。
設定這兩個縮圖參數之後,partThumbnails.zip 的內容將會是處理這兩個參數所獲得的產物。
• translation.xml
包含在發佈流程中找到的可本地化中繼資料字串。此檔案會複製到配套。針對有效負載的每種目標語言,檔案包含 Target 元素 (如在 xml:lang 中指定)。Target 元素包含每個特定 xml:lang 之每個可本地化屬性的 Value 元素。可本地化的屬性是在 localizable_attset.xml 中指定。
• ContentMap.xml
包含 URI 與配套中本機內容的對應。每個對應都包括 .meta 檔案的路徑、內容的路徑,以及內容的 URI。路徑相對於配套的根。
• relatedContexts.xml
包含與 Windchill 中的服務結構相關聯的產品階層資訊。檔案包含有關服務結構與一或多個產品階層結構之間關係的資訊。
|
產品階層檔案是個別檔案。此檔案從產品階層配套發佈。有效負載中物件的 ResourceMap 資訊中的內容元素包含角色屬性,該屬性用來指示檔案的角色。例如,檔案的角色 = "THUMBNAIL_SMALL" 表示檔案是物件的縮圖。
|
• SymptomTree.xml
將使用「症狀集」文件類型編寫的症狀值包含在一個樹狀結構中。在發佈流程中,每個網站針對每種語言只會產生一個 SymptomTree.xml 檔案。
症狀集僅在處於「已發行」狀態時,才會發佈。如果 Windchill 伺服器中有多個症狀集處於「已發行」狀態,則發佈配套將會失敗。症狀集的就緒狀態可由 wt.properties 檔案中的 com.ptc.arbortext.windchill.siscore.SKDSymptomsTreeReadyState 內容配置。此內容的預設值設定為「已發行」。
您可以配置一些要包含在資訊清單中及為翻譯、參考物件及發佈所傳送的 XLIFF 中的屬性。如需詳細資訊,請參閱
定義屬性集。