Fehlerbehebung bei der PTC APP Veröffentlichung
PTC APP Momentaufnahmen erstellen
Möglicherweise müssen Sie Fehler im Veröffentlichungsprozess beheben, wenn Sie den Befehl PTC APP zum Drucken oder Veröffentlichen von PDF-Dateien verwenden. Für diesen Fehlerbehebungsprozess ist eine Zip-Datei mit einer PTC APP Momentaufnahme erforderlich. Sie müssen die PTC APP Momentaufnahmedatei mit einer der folgenden Methoden erstellen:
• ACL-Befehl set appsnapshot
• Dokumentkonvertierungsparameter app-snapshot=yes, wenn Sie f=convert-Veröffentlichungsanforderungen an Arbortext PE Server senden. Durch diese Anfrage wird die Momentaufnahmedatei im Transaktionsarchiv gespeichert. Weitere Informationen zu Transaktionsarchiven finden Sie unter Configuration Guide for Arbortext Publishing Engine.
Die ZIP-Datei mit der PTC APP Momentaufnahme enthält Folgendes:
• manifest.xml – XML-Dokument mit Informationen über den Inhalt der Momentaufnahmedatei
• inputDoc.xml – Das an PTC APP gesendete Dokument mit einigen Änderungen. Es wird abgeflacht und seine Grafikreferenzen verweisen auf das Verzeichnis doc-graphics.
• doc-graphics – Ein Verzeichnis, das eine Kopie der Grafiken enthält, auf die inputDoc.xml verweist.
• appsnap.log – Ein Protokoll der Ereignisse ab dem Generieren der PTC APP Momentaufnahme. Wenn die Momentaufnahme nicht vollständig ist, enthält appsnap.log weitere Informationen.
• dynamic.dtd oder dynamic.xsd – (optional) Eine XML-Dokumenttypdefinitionsdatei (Document Type Definition, DTD) oder eine XML-Schemadatei (XSD), die zum Lesen von inputDoc.xml erforderlich sein kann. Die Momentaufnahme kann eine dieser Dateien enthalten, wenn diese zum Lesen der inputDoc.xml benötigt wird. Beispielsweise verwenden DITA-Dokumente eine dynamische DTD.
In der PTC APP Momentaufnahme sind der Dokumenttyp, die Formatvorlage, die PTC APP Konfigurationsdatei und der Inhalt der Verzeichnisse application und custom nicht enthalten. Über > können Sie eine Zip-Datei erzeugen, die diese Informationen enthält.
Momentaufnahme-Tool ausführen
Verwenden Sie, nachdem Sie die ZIP-Datei mit der
PTC APP Momentaufnahme erstellt haben, das Tool
ALD-Momentaufnahme ausführen, um den Prozess der Veröffentlichung auf die
PTC APP Momentaufnahmedatei anzuwenden. Sie können die Datei
hints.xml verwenden, um einige der Parameter zu überschreiben, die von
PTC APP beim Veröffentlichen des Dokuments verwendet werden. Die
PTC APP Momentaufnahmedatei enthält nicht die Datei
hints.xml. Sie können entweder einen Pfad zu dieser Datei im Dialogfenster
ALD-Momentaufnahme ausführen bereitstellen oder einen Pfad direkt in das Momentaufnahmearchiv einfügen, bevor Sie die Fehlerbehebung ausführen. Entzippen Sie die Zip-Datei mit der Momentaufnahme, kopieren Sie die Datei
hints.xml in das extrahierte Verzeichnis, und zippen Sie dann das Verzeichnis erneut.
Sie müssen die Datei hints.xml erstellen, um sie bereitzustellen. Es handelt sich dabei um ein XML-Dokument, das Parameter zum Überschreiben einiger der Veröffentlichungsparameter bereitstellt, die beim Erstellen der Momentaufnahme wirksam waren. Die Datei hat die folgende Form:
<app:AppSnapshotHints xmlns:app="http://arbortext.ptc.com/AppSnapshot">
<Hint name="Parametername" value="Parameterwert"/>
<Hint name="Parametername" value="Parameterwert"/>
<Hint name="Parametername" value="Parameterwert" />
</app:AppSnapshotHints>
Die folgenden Namen und Werte werden für die Hinweisdatei hints.xml unterstützt:
|
Hinweisname
|
Wert
|
|
cropmarks
|
Geben Sie 1 an, um Schnittmarken anzuzeigen. Geben Sie 0 an, um diese zu unterdrücken.
|
|
datemark
|
Geben Sie 1 an, um Datumsstempel anzuzeigen. Geben Sie 0 an, um diese zu unterdrücken.
|
|
printRange
|
Geben Sie die Seiten an, die als PDF-Datei gedruckt oder veröffentlicht werden sollen. Sie können Seitenzahlen, Seitenbereiche oder Kombinationen aus beidem angeben, z.B. 3-5,9,21-33.
|
|
regmarks
|
Geben Sie 1 an, um Registrierungsmarkierungen anzuzeigen. Geben Sie 0 an, um diese zu unterdrücken.
|
|
APPChecksumPath
|
Geben Sie 1 an, um eine Prüfsummendatei zu generieren. Geben Sie 0 an, um diese zu unterdrücken. Die Datei wird im gleichen Verzeichnis wie die PDF-Datei abgelegt, die aus der Momentaufnahme erzeugt wird.
|
|
APPSavePath
|
Geben Sie 1 an, um die PTC APP Vorlagendatei zu speichern, die während der Veröffentlichung generiert wird. Geben Sie 0 an, um diese zu unterdrücken. Die Datei wird im gleichen Verzeichnis wie die PDF-Datei abgelegt, die aus der Momentaufnahme erzeugt wird.
|
|
editstylesheet
|
Geben Sie den absoluten Pfad zu einer Formatvorlage an, die Sie beim Öffnen des Eingabedokuments vor dem Veröffentlichen verwenden.
|
|
stylesheet
|
Geben Sie den absoluten Pfad zu einer Formatvorlage an, die während der Veröffentlichung an PTC APP übergeben werden soll.
|
|
APPConfigFile
|
Geben Sie den absoluten Pfad zu einer PTC APP Konfigurationsdatei an, die während der Veröffentlichung an PTC APP übergeben werden soll.
|
Aktivität während der Ausführung der Momentaufnahme verfolgen
Wenn beim Ausführen des Momentaufnahme-Tools Probleme auftreten, können Sie das Diagnoseprogramm verwenden. Starten Sie das PTC ArbortextDiagnose-Tool über die Verknüpfungen Ihrer Programmgruppen. Stellen Sie dann die globale ACL-Variable appsnapx::debug auf 2 ein. Geben Sie den Befehl set debug==extwin in der Befehlszeile oder über ein Skript in custom\init ein. Führen Sie anschließend das Momentaufnahme-Tool erneut aus, und prüfen Sie das Diagnosefenster. Weitere Informationen zum Diagnosefenster finden Sie unter Getting Trace Information in der Configuration Guide for Arbortext Publishing EnginePDF-Ausgabe.
Es wird empfohlen, die Fehlerbehebung für die PTC APP Veröffentlichung über Momentaufnahmen unter Aufsicht des technischen Supports vorzunehmen.