說明 > 列印與發行 > PTC APP 發行疑難排解
  
PTC APP 發行疑難排解
建立 PTC APP 快照
使用 PTC APP 列印或發行 PDF 時，您可能需要針對發行程序進行疑難排解。此疑難排解流程需要 PTC APP 快照壓縮檔案。您需要使用下列項目之一建立 PTC APP 快照檔案：
• set appsnapshot ACL 指令。
• 將 f=convert 發行請求傳送至 Arbortext PE 伺服器 時的 app-snapshot=yes 文件轉換參數。該請求會將快照檔案放在交易封存中。如需有關交易封存的詳細資訊，請參照 Configuration Guide for Arbortext Publishing Engine。
PTC APP 快照壓縮檔包含下列項目：
• manifest.xml - 包含有關快照檔案內容之資訊的 XML 文件。
• inputDoc.xml - 將進行了一些修改的文件傳送至 PTC APP。會對其進行簡維，且其圖形參照會指向 doc-graphics 目錄。
• doc-graphics - 包含由 inputDoc.xml 參照之圖形副本的目錄。
• appsnap.log - 產生 PTC APP 快照的事件記錄。如果快照未完成，appsnap.log 將包含其他資訊。
• dynamic.dtd 或 dynamic.xsd - (選用) 可能需要 XML 文件類型定義 (DTD) 檔案或 XML 架構 (XSD) 檔案才能讀取 inputDoc.xml。快照可能包含這些檔案中的其中一個 (如果需要檔案才能讀取 inputDoc.xml)。例如，DITA 文件會使用動態 DTD。
PTC APP 快照不包含文件類型、樣式表、PTC APP 組態檔案或者 application 或 custom 目錄中的內容。您可以使用工具 > 儲存應用程式產生包含這些項目的壓縮檔。
執行快照工具
產生 PTC APP 快照壓縮檔案之後，您可以使用執行 ALD 快照工具來對 PTC APP 快照檔案執行發行流程。您可以使用 hints.xml 檔案來覆寫發行文件期間 PTC APP 所使用的某些參數。PTC APP 快照檔案不包含 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 APP 範本檔案。指定 0 可加以隱抑。會將檔案放置在與從快照產生的 PDF 相同的目錄中。
editstylesheet
指定要在發行之前開啟輸入文件時使用之樣式表的絕對路徑。
stylesheet
指定要在發行期間傳遞至 PTC APP 之樣式表的絕對路徑。
APPConfigFile
指定要在發行期間傳遞至 PTC APP 之 PTC APP 組態檔案的絕對路徑。
在快照執行期間追蹤活動
如果您在執行快照工具時遇到問題，可以使用診斷程式。從您的程式群組捷徑中啟動 PTC Arbortext 診斷工具。然後將 ACL 全域變數 appsnapx::debug 設定為 2。發出指令行上或 custom\init 之指令集中的指令 set debug==extwin。之後再次執行快照工具並檢查診斷視窗。如需有關診斷視窗的更多資訊，請參照 Configuration Guide for Arbortext Publishing Engine PDF 中的取得追蹤資訊。
建議在「技術支援」的監督之下使用快照對 PTC APP 發行進行疑難排解。