Servigistics InService 發佈與載入 > 使用發佈與載入 > 執行 PxTAL
  
執行 PxTAL
Px 配套支援
配套相容性
TAL 支援 Servigistics InService 6.5 與 7.1 配套。版本根據配套中的發佈資訊進行識別。
* 
您必須載入 6.5 或 7.1 配套。您無法載入不同的類型。
配套限制
以下是配套資料的一些限制：
• 在 Servigistics InService 配套中的檔案名稱中，請勿使用 "#" 字元。
如果檔案名稱包含此字元，轉換及載入流程將會失敗，並出現下列錯誤：
[ERROR,ProcessActionHandler] Failed node: fetchApplicableFilesForPartsList within flow:getRegistryFromIMANSubFlow_PD , reason #path to a partslist item(The system cannot find the file specified) java.io.FileNotFoundException:#path to a partslist item(The system cannot find the file specified)
• 在 APEX 內容值中，請勿使用分隔號 ( | ) 字元，除非用它來表示邏輯 OR。
Px 配套內容
Px 配套包含下表所示的資料夾和檔案：
名稱
檔案/資料夾
描述
com.ptc.arbortext.windchill.partlist.PartList
資料夾
包含參考自 *-DMPmap.xml 的零件清單。資料夾名稱通常是在 SIM/SP 中建立資料所依據的類型名稱。
com.ptc.ptcnet.DynamicDocument
資料夾
包含參考自 *-DMPmap.xml 的動態文件。通常，內容特定於 DITA XML、一般 XML、PDF 或圖像。資料夾名稱通常是在 SIM/SP 中建立資料所依據的類型名稱。
reps
資料夾
包含 *_Hierarchy.xml 的相關聯圖像。
*_Hierarchy.xml
檔案
產品階層檔案提供產品結構的階層資訊。
*_Hierarchy.xml.meta
檔案
產品階層中繼資料檔案
*-DMPmap.xml
檔案
通常提供目錄的資訊結構 (IS) 或出版品結構 (PS) 檔案。資料亦會顯示在階層結構中。
*-DMPmap.xml.meta
檔案
IS 或 PS 隨附中繼資料檔案
OptionsDefinition.xml
檔案
選項與選擇定義及其與前後關聯 (PH 或 IS) 之關聯的清單。
partThumbnails.zip
檔案
與零件相關聯的圖像。
ProductInstances.xml
檔案
為前後關聯對應提供序號的產品實例檔案。此檔案將多個值包含在單一檔案中。
publishInfo.xml
檔案
與發佈配套相關的中繼資料資訊。它通常表示配套 ID、發佈日期、地區設定、配套序列以及可指出是完整配套還是增量配套的旗標。
檔案包含參數 Bundle-source 以識別配套擁有者。如果此內容不存在，TAL 預設為使用配套來源之 Rootobjects 中的內容 orgName。
配套是完整配套還是增量配套取決於下列內容：
• JobSpecification/@increment
• JobSpecification/@incremental
完整配套將有值如 increment="0" 或 incremental="false"。增量配套將有值如 increment="1" 或 incremental="true"。
配套語言由 JobSpecification 元素下的 Language 參數來識別：
<JobSpecification
…………………………..
<Parameter token="com.ptc.arbortext.
wvs/Language">
<Value>ja</Value>
</Parameter>
<Parameter token="Language">
<Value>ja</Value>
</Parameter>
……………….
</JobSpecification>
ReadyForTAL
檔案
指示 TAL 之配套已就緒的零位元標記檔案。如果此檔案不存在，將不會處理配套。
referencedObjects.xml
檔案
表示參考自不同物件的各種物件。
在一般 IS 配套中，這包含其透過 relatedContext.xml 連接至的前後關聯 URI (作為目標屬性)。與 ServiceInformation 屬性的相關產品詳細資訊一樣，有關 URI 以及相關物件的詳細資訊也在此檔案中。
referencedParts.xml
檔案
提供參考自零件清單之所有零件詳細資訊的零件特定檔案。
relatedContexts.xml
檔案
指示與配套 (通常 IS 或 PS) 相關聯的前後關聯。
relatedParts.xml
檔案
提供有關零件關係，例如全域替代、汰換及交叉參照的資訊。
translation.xml
檔案
提供不同企業物件，例如 PH、IS、PS、PL、IEXML、PDFM、圖形和零件中使用的本地化屬性的本地化值。
excludedObjects.xml
檔案
提供要從先前已發佈內容中刪除的內容 URI。
ModelItemPartObjects.xml
檔案
用來建立來源 IEXML 與零或多個相關 IEXML 物件之連結的泛用 IE 加工品。
contentMap.xml
檔案
向實體檔案對應提供 URI 的對應檔案。也需保留加總核對碼、中繼加總核對碼與收集日期的值，以確定是否需要載入資料。
資訊結構與發佈結構
*-DMPMap.xml 檔案表示 IS 或 PS 檔案。本節將說明這些實體的組成。使用的術語來自 SIM/SP 中使用的語言。例如，IsRoot 是以 …|com.ptc.sis.IsRoot 為結尾的 wt.part.WTPart 可變類型。
資訊結構包含下列節點：
• 節點 <topicref>
◦ IsRoot
◦ IsGroup
◦ ContentRef (即內容持有者)
• 從父節點到子項的使用關係連結
• 針對上述任意節點的服務生失效
• 這些節點的所選表示
結構可能會參考圖形、XML 文件或零件清單。它也可從這些參考物件中取得中繼資料。
發佈結構包含下列節點：
• 節點 (包括產生的勾點) <topicref>
◦ PsRoot
◦ PsSection
◦ PsToc
◦ PsIndex
◦ ContentRef
• 從父節點到子項的使用關係連結
• 針對上述任意節點的服務生失效
結構可能會參考 XML 文件或零件清單。它也可從這些參考物件中取得中繼資料。
其中一個結構的一般節點如下所示：
<topicref id="..."
href="uri of node"
copy-to="relative path of Information Element (IE)"
format="dita|pdf|xml|…"
...>
在沒有任何資訊元素變更的增量配套中，copy-to 屬性不存在。
資訊元素
所有資訊元素都會構成主要內容及其中繼資料。Px 配套支援下列不同類型的內容。
Partslist 元件
• Partlist 本身
• 圖像 GDD (圖形動態文件) 或其後發佈 GDD
◦ 主要內容，
◦ 其表示
◦ 其附件
• PartListItem
◦ 零件
• 從父節點到子項的使用關係連結
• 針對以上任意項的服務生失效
XML 文件組成
• 主要 DD (動態文件)
◦ 其中繼資料
◦ 其主要內容
• 參考圖像
◦ 主要內容
◦ 其表示
◦ 其附件
• 發佈流程期間解決的 XML 內容
◦ Xinclude
◦ DITA 主題參照
◦ DITA conref、conkeyref 等
外部 XML 文件的交叉參照不是實體的組成部份。
圖形內容
• 主要 GDD (圖形動態文件)
◦ 其中繼資料
◦ 其主要內容
◦ 其表示
◦ 其附件
零件
• 零件
◦ 中繼資料 (主物件與實例)
◦ 相關零件
◦ 針對零件的服務生失效
◦ 縮圖
目前已萃取並發佈零件，但發佈時不會將其視為實體，而是零件清單的一部份。發佈目前包括相關零件。
服務生失效標示
服務生失效不是實體，而是與多個實體相關聯的資訊。它表示有關不同 IE 物件的篩選資訊。它會顯示為其所針對的任何物件內的中繼資料。例如：
<Metadata ...
<Property token="ServiceEffectivity">
<Value>(OR (AND (PRODUCT '0000016602') (INSTANCE 'SUV_WE_EV4_SN001'
'SUV_WE_EV4_SN002')) (AND (PRODUCT '0000016610') (INSTANCE
'SUV_WE_EE_SN002' 'SUV_WE_EE_SN001')) (AND (PRODUCT '0000016611')
(INSTANCE 'SUV_WF_EV6T_SN001' 'SUV_WF_EV6T_SN002')) (AND (PRODUCT
'0000016617') (INSTANCE )))</Value>
</Property>
...
</Metadata>
束類型
在 Servigistics InService 中，有兩種類型的 Px 配套。配套的類型根據 publishInfo.xml 檔案進行識別。
受支援的類型如下：
• PH 配套
此類型的配套附帶有關統一產品階層與相關產品實例的資訊。通常此配套有下列類型的資料：
◦ 產品階層 (PH) (*Hierarchy.xml)
◦ 產品實例 (PI) (ProductInstances.xml)
◦ 選項與選擇 (OptionsDefinitions.xml)
◦ PublishInfo.xml
• IS 或 PS 配套
這些類型的配套附帶有關資訊結構 (IS) 或發佈結構 (PS) 的資訊。通常此配套有下列類型的資料：
◦ relatedContext.xml
◦ IS
◦ 資訊元素 (IEXML、PDFM、圖形、零件清單) - 通常透過 IS 連接
◦ 泛用資訊元素
◦ 與零件清單相關聯的零件
◦ 零件關係
◦ 零件相關文件
◦ 選項和選擇項
◦ 症狀樹
◦ PublishInfo.xml
• 非產品配套
此配套類似於 IS 配套，但不含 relatedContext.xml 檔案。這表示配套不會與任何產品前後關聯相關聯。通常這些類型的配套與 publishInfo.xml 檔案中定義的類別相關聯。
識別配套的前後關聯與類別
前後關聯資訊會指出與項目相關聯的產品前後關聯。在 Servigistics InService 中，前後關聯可用來儲存、篩選並在系統中尋找各種項目。通常 IS 或 PS 配套與某個前後關聯相關聯。請注意，PH 配套不與任何前後關聯相關聯，因為此類型的配套本身就是前後關聯。在 Servigistics InService 中，PH 配套將載入到每個區段
在 Px 配套中，存在用來識別與配套相關聯之前後關聯的 relatedContext.xml 檔案。請注意，配套可能指一或多個前後關聯。以下是 relatedContext.xml 檔案的一部份。src 屬性是指 IS 或 PS。target 屬性是指前後關聯資訊。
例如：
配套類別位於 PublishInfo.xml 檔案中。例如：
配套標記檔案
標記檔案是在配套中建立的特殊零位元組檔案，用來標記不同的處理狀態。可能存在下列標記檔案：
• ReadyForTAL
此檔案由配套擁有者產生。如果存在此檔案，則表示配套已完全產生，可由 TAL 處理。
• PrepTAL
透過轉換與載入任務中一次性載入多個配套時，會建立此檔案。
• TransformInProgress_Collection 或 TransformInProgress_BundleID
此檔案的名稱取決於是否已啟用內容共用。如果未啟用內容共用，其名稱為 TransformInProgress_Collection。如果已啟用內容共用，其名稱為 TransformInProgress_BundleID。該檔案會轉換流程中建立。
• TransformFailed_Collection 或 TransformFailed_BundleID
此檔案的名稱取決於是否已啟用內容共用。如果未啟用內容共用，其名稱為 TransformFailed_Collection。如果已啟用內容共用，其名稱為 TransformFailed_BundleID。此檔案由轉換任務在開始執行時建立。如果轉換任務成功，會刪除此檔案。
• TransformCompleted_Collection 或 TransformCompleted_BundleID
此檔案的名稱取決於是否已啟用內容共用。如果未啟用內容共用，其名稱為 TransformCompleted_Collection。如果已啟用內容共用，其名稱為 TransformCompleted_BundleID。此檔案由轉換任務在開始執行時建立。此檔案於成功完成集合轉換任務時建立。
• tal_completed
完成轉換任務時，會建立此檔案。
• tal_failed
轉換任務失敗時，會建立此檔案。
從配套中排除物件
如果您要從配套中特別排除某些物件，則需要在配套中包括 excludedObjects.xml 檔案。此檔案中存在一系列 Object 標籤，可用來提供不想隨配套載入之物件的 id 與 uri。
此檔案的範例如下︰
<?xml version="1.0" encoding="UTF-8"?>
<ExcludedObjects>
<Object id="PartListItem_8153223"
uri="x-wc://com.ptc.arbortext.windchill.partlist.PartListItem:8153223"/>
<Object id="PartListItem_8153222"
uri="x-wc://com.ptc.arbortext.windchill.partlist.PartListItem:8153222"/>
<Object id="WTPartMaster_8118901"
uri="x-wc://f5e0179d8f894049:wt.part.WTPartMaster:0069313461"/>
<Object id="WTPartMaster_8118955"
uri="x-wc://134e815ca9117606:wt.part.WTPartMaster:0069313463"/>
<Object id="WTPartMaster_8118947"
uri="x-wc://ce2ace730699a033:wt.part.WTPartMaster:0069313462"/>
<Object id="EPMDocumentMaster_8143009"
uri="x-wc://file=0000020874.png"/>
</ExcludedObjects>