說明 > 列印與發行 > PTC ALD 發行疑難排解
  
PTC ALD 發行疑難排解
建立 PTC ALD 快照
使用 PTC ALD 列印或發行 PDF 時,您可能需要針對發行程序進行疑難排解。此疑難排解流程需要 PTC ALD 快照壓縮檔案。您需要使用下列項目之一建立 PTC ALD 快照檔案:
set appsnapshot ACL 指令。
f=convert 發行請求傳送至 Arbortext PE 伺服器 時的 app-snapshot=yes 文件轉換參數。該請求會將快照檔案放在交易封存中。如需有關交易封存的詳細資訊,請參照 Configuration Guide for Arbortext Publishing Engine
PTC ALD 快照壓縮檔包含下列項目:
manifest.xml - 包含有關快照檔案內容之資訊的 XML 文件。
inputDoc.xml - 將進行了一些修改的文件傳送至 PTC ALD。會對其進行簡維,且其圖形參照會指向 doc-graphics 目錄。
doc-graphics - 包含由 inputDoc.xml 參照之圖形副本的目錄。
appsnap.log - 產生 PTC ALD 快照的事件記錄。如果快照未完成,appsnap.log 將包含其他資訊。
dynamic.dtddynamic.xsd - (選用) 可能需要 XML 文件類型定義 (DTD) 檔案或 XML 架構 (XSD) 檔案才能讀取 inputDoc.xml。快照可能包含這些檔案中的其中一個 (如果需要檔案才能讀取 inputDoc.xml)。例如,DITA 文件會使用動態 DTD。
PTC ALD 快照不包含文件類型、樣式表、PTC ALD 組態檔案或者 applicationcustom 目錄中的內容。您可以使用工具 > 儲存應用程式產生包含這些項目的壓縮檔。
執行快照工具
產生 PTC ALD 快照壓縮檔案之後,您可以使用執行 ALD 快照工具來對 PTC ALD 快照檔案執行發行流程。您可以使用 hints.xml 檔案來覆寫發行文件期間 PTC ALD 所使用的某些參數。PTC ALD 快照檔案不包含 hints.xml 檔案。您可以在執行 ALD 快照對話方塊中提供該檔案的路徑,或者在執行疑難排解流程之前直接將一個檔案插入快照封存。解壓縮快照壓縮檔案、將 hints.xml 檔案複製到解壓縮目錄,然後再次壓縮目錄。
欲提供 hints.xml 檔案,您必須建立一個。它是一種 XML 文件,提供要取代在建立快照時生效之某些發行參數的參數。此檔案採用下列格式:
<app:AppSnapshotHints xmlns:app="http://arbortext.ptc.com/AppSnapshot">
<Hint name="parameter-name" value="parameter-value"/>
<Hint name="parameter-name" value="parameter-value"/>
<Hint name="parameter-name" value="parameter-value" />
</app:AppSnapshotHints>
支援的提示名稱與值如下所示:
提示名稱
cropmarks
指定 1 可顯示裁剪標記。指定 0 可加以隱抑。
datemark
指定 1 可顯示日期標記。指定 0 可加以隱抑。
printRange
指定要列印或發行至 PDF 的頁面。您可以指定頁碼、頁面範圍或二者的組合,例如 3-5,9,21-33
regmarks
指定 1 可顯示註冊標記。指定 0 可加以隱抑。
APPChecksumPath
指定 1 可產生加總核對碼檔案。指定 0 可加以隱抑。會將檔案放置在與從快照產生的 PDF 相同的目錄中。
APPSavePath
指定 1 可儲存發行期間產生的 PTC ALD 範本檔案。指定 0 可加以隱抑。會將檔案放置在與從快照產生的 PDF 相同的目錄中。
editstylesheet
指定要在發行之前開啟輸入文件時使用之樣式表的絕對路徑。
stylesheet
指定要在發行期間傳遞至 PTC ALD 之樣式表的絕對路徑。
APPConfigFile
指定要在發行期間傳遞至 PTC ALDPTC ALD 組態檔案的絕對路徑。
在快照執行期間追蹤活動
如果您在執行快照工具時遇到問題,可以使用診斷程式。從您的程式群組捷徑中啟動 PTC Arbortext 診斷工具。然後將 ACL 全域變數 appsnapx::debug 設定為 2。發出指令行上或 custom\init 之指令集中的指令 set debug==extwin。之後再次執行快照工具並檢查診斷視窗。如需有關診斷視窗的更多資訊,請參照 Configuration Guide for Arbortext Publishing Engine PDF 中的取得追蹤資訊
建議在「技術支援」的監督之下使用快照對 PTC ALD 發行進行疑難排解。