其他功能 > 服務資訊管理 > Customizing Windchill Service Information Manager and Windchill Service Parts (自訂 Windchill Service Information Manager and Windchill Service Parts) > 自訂發行 > 瞭解發行流程
  
瞭解發行流程
必備知識
瞭解點對點發行流程是成功實行自訂的關鍵所在。達到此目標所需的技能組合通常包括:
熟悉使用 Arbortext Publishing Engine管理與組態,包括 Windchill PDMLinkPTC Server connection
熟悉使用 Arbortext Editor,以及使用 Arbortext Styler開發樣式表。
熟悉開發及部署 Arbortext Editor and Publishing Engine的特殊文件類型應用程式,以及如何使用 application 目錄。
熟悉開發 XSL 轉換樣式表。
熟悉使用 XPath 運算式。
熟悉使用 Windchill PDMLink 管理。
熟悉使用「Windchill 視覺化服務」(WVS) 與 Worker Agent 管理。
熟悉編寫 WVS 發行規則。
發行先決條件
需要先成功安裝、設定、組態及操作下列項目才能繼續實行自訂:
Arbortext Publishing Engine 必須在支援的 Windows 伺服器上進行安裝及配置。
安裝及配置 Arbortext Publishing Engine 的指示位於《Installing Arbortext Publishing Engine (安裝 Arbortext Publishing Engine)》(安裝 Arbortext Publishing Engine) 與《Configuring Arbortext Publishing Engine (配置 Arbortext Publishing Engine)》(配置 Arbortext Publishing Engine) 指南中,這些指南是「Arbortext Publishing Engine 說明中心」文件集的一部份。
必須在 Windchill 檔案 wvssis.properties 中配置 Arbortext Publishing Engine 伺服器的 Windchill WVS 連接。
Windchill 設定伺服器連接的指示在Configuring Windchill Service Information Manager and Windchill Service Parts (配置 Windchill Service Information Manager and Windchill Service Parts)中有所說明,這是可從「Windchill 說明中心」與「PTC 參考文件集」網站取得的 Windchill Service Information Manager 文件集的一部份,網址為:
www.ptc.com/en/support/refdoc
選擇「瀏覽文件」以存取連結。
Arbortext Publishing Engine 伺服器必須安裝及啟用 Service 應用程式 com.ptc.arbortext.service。依預設,其位於 Arbortext Publishing Engineapplication 目錄中。Service 應用程式管理準備發行之輸入 XML 文件的初始轉換。
Arbortext Publishing Engine 伺服器必須安裝及啟用一種文件類型才能處理發佈輸出。依預設,範例位於 Arbortext Publishing Engineapplication 目錄中。Technical Information DITA 文件類型應用程式 com.ptc.arbortext.techinfo 是使用 Arbortext Publishing Engine 發佈的此類文件類型的有效範例。
必須在 Arbortext Publishing Engine 伺服器上配置 WindchillPTC Server connection,才能允許 Arbortext Publishing Engine 伺服器從 Windchill 擷取物件。
設定 PTC Server connection 的指示位於《《Arbortext Content Management Guide》》(Arbortext Content Management 指南) 中,該指南是 Arbortext Publishing Engine 文件集的一部份。
必須在 Windchill PDMLink 上配置 SIS Worker,以便 WVS 可以管理從資訊結構、發行結構以及零件清單傳送至 Arbortext Publishing Engine 的發行請求。
設定 SIS Worker 的指示位於《Configuring Windchill Service Information Manager and Windchill Service Parts (配置 Windchill Service Information Manager and Windchill Service Parts)》(Windchill Service Information Manager 與 Service Parts 入門) 中,該指南是 Windchill Service Information Manager 文件集的一部份。
必須在 Windchill PDMLink 上設定 WVS 發行規則,以便使用者可以選擇發行規則,並且 WVS 可以將關聯發行參數傳送至 Arbortext Publishing Engine。發行規則必須擁有明確的名稱與描述,以便使用者可以區分它們。
設定發行規則的指示位於《Configuring Windchill Service Information Manager and Windchill Service Parts (配置 Windchill Service Information Manager and Windchill Service Parts)》(Windchill Service Information Manager 與 Service Parts 入門) 中,該指南是 Windchill Service Information Manager 文件集的一部份。
應在服務產品中定義發行結構、資訊結構或零件清單。一般 WVS 發行必須為可操作的,才能使用發行動作。
發佈動作已在「Windchill 說明中心」中說明。
特定輸出格式的已發行表示可以使用「發佈表示」選單動作項目、捷徑功能表或工具列按鈕來建立。使用者要指定發行名稱、描述,並且可能還要指定 WVS 發行規則。輸出類型與各種發行參數皆由 WVS 發行規則指定,如果是零件清單,也可由使用者選擇。
「發佈表示」可用於發佈 Arbortext Content Delivery 的束。束發行會產生一個呼叫束的檔案,它可作為 Arbortext Content Delivery 的輸入。束會放置在目的地目錄中的 Arbortext Publishing Engine 伺服器上,Arbortext Content Delivery 可在此找到它。束發佈程序不會將束傳回到 Windchill,但會傳回關於束發佈作業的資訊。
WVS 發佈規則檔案必須已經定義 SIS Worker 參數以控制發佈程序。參數與範例在服務 Worker 參數中有所說明。
服務資訊發行工作流程
來自服務產品結構的基本發行工作流程遵循此流程:
1. 當從發行結構、資訊結構或零件清單觸發發行動作時,數個檔案會在稱之為有效負載的檔案中產生、壓縮,並由 WVS 傳送至 Arbortext Publishing Engine 伺服器。檔案數目與類型專屬於所請求之發行工作的結構、其內容、指定的輸出及發行規格。
2. Windchill Service Information Manager 會從結構中建立一般化 XML 文件以傳送至 Arbortext Publishing Engine 伺服器。
您需要瞭解此一般化 XML 格式,才能成功將輸入 XML 文件轉換為符合您文件類型之結構的格式。XSLT 轉換樣式表會作為 Service 應用程式處理的一部份來提供。此 XSLT 樣式表是使用 WVS 發行規則中的其中一個參數指定的。
3. 「WVS 發行規則」規格會轉換為發行規格檔案,它會被傳送至有效負載中的 Arbortext Publishing Engine 伺服器。其參數會於發行流程期間套用。
4. 輸入 XML 文件參考的物件 (例如圖形) 會傳送至 Arbortext Publishing Engine 作為有效負載的一部份,或者可以使用 Windchill PDMLink 的「PTC Server connection」來進行擷取。選擇哪種方式由 SIS Worker 參數決定。
5. 輸入 XML 文件、發行規格與參考物件 (如有必要) 會全部壓縮至有效負載檔案中,同時還會包含一個描述有效負載內容的資訊清單 XML 檔案。
然後,會使用由 Service 應用程式處理的 f=acl 函數呼叫,將有效負載作為 HTTP 請求的 POST 類型傳送至 Arbortext Publishing Engine 伺服器以進行處理。
6. Service 應用程式中包含 XSLT 樣式表,可將一般化 XML 輸入文件轉換為表單,該表單預設符合範例分散式 DITA 文件類型、圖解零件清單或 Arbortext Content Delivery 束。
7. 必須在 Arbortext Publishing Engine 伺服器上安裝一種文件類型,它可以從 Service 應用程式取用過渡文件並產生發佈輸出或束。
Technical Information 範例專用 DITA 文件類型分配在 Arbortext Publishing Engine 伺服器上。依預設,它處理預設 Service 應用程式產生的內容與標示,並可根據發行規格產生輸出。
設計 Technical Information 應用程式是為了編寫及發行服務操作與零件的相關資訊,以作為有效文件類型範例。任何客戶文件類型都需要模仿內建於 Technical Information 應用程式中的功能與動作。
8. Arbortext Publishing Engine 伺服器收到有效負載之後,會將請求導引至 Arbortext Publishing Engine,然後由其子流程進行處理。
發行規格必須指定將一般化輸入 XML 文件轉換為符合指定文件類型之標示的 XSLT 轉換樣式表。XSLT 需要指定此輸出文件類型。
9. 發行結構、資訊結構或零件清單輸入 XML 會由 Service 應用程式轉換為對應結構。如果結構參考零件清單,則會將零件清單轉換為單獨的 XML 格式 (稱為「圖解零件定義」(IPD))。如果只輸入零件清單,則會將其放置在參考零件清單的包覆器發行結構 XML 檔案中,它會像實際由發行結構參考一樣進行轉換。
10. Arbortext Publishing Engine 子流程會將文件放在輸出文件類型的特定配管篩選器中,然後根據指定樣式表建立輸出的樣式,並發佈輸出 (使用根據 Arbortext Styler 樣式表指定的 APP)。
11. Arbortext Publishing Engine 伺服器會收集發佈輸出 (或者,如果產生錯誤訊息,則會收集錯誤訊息)、composer 記錄 (以 XML 與 HTML 格式)、識別輸出類型的資訊清單、流程 ID、交易 ID,以及 Arbortext Publishing Engine 伺服器名稱與 IP 位址,然後它會將這些檔案壓縮為回應檔案。回應 zip 會傳回到 SIS Worker。如果輸出是束,該束不會包含在回應檔案中,但會包含關於束的路徑的資訊。束仍會保留在目的地目錄中的 Arbortext Publishing Engine 伺服器上,等待 Arbortext Content Delivery 的進一步行動。
12. SIS Worker 會將傳回的回應 zip 檔案遞送至 WVS。
13. WVS 會提供包含「表示」標籤中表示之 zip 的連結。如果表示包括 PDF,您可以配置發佈後委派以擷取 PDF 並在 Windchill PDMLink 中將其入庫為表示。