Resolución de problemas de publicación de APP
Creación de una instantánea de APP
Es posible que sea necesario resolver problemas del proceso de publicación mediante APP para imprimir o publicar PDF. Este proceso de resolución de problemas requiere un fichero ZIP de instantánea APP. Es necesario crear el fichero de instantánea de APP mediante una de las siguientes opciones:
• El comando ACL set appsnapshot
• El parámetro de conversión de documentos app-snapshot=yes al enviar solicitudes de publicación f=convert al Servidor de Arbortext PE La solicitud coloca el fichero de instantánea en el archivo de transacción. Para obtener más información sobre los archivos de transacción, consulte Configuration Guide for Arbortext Publishing Engine.
En el fichero ZIP de la instantánea de APP se incluye lo siguiente:
• manifest.xml: un documento XML que contiene información sobre el contenido del fichero de instantánea.
• inputDoc.xml: documento enviado a APP con algunas modificaciones. Se aplana y sus referencias a gráficos apuntan al directorio doc-graphics.
• doc-graphics: un directorio que contiene una copia de los gráficos a los que se hace referencia en inputDoc.xml.
• appsnap.log: registro de eventos de la generación de la instantánea de APP. Si la instantánea no está completa, en el fichero appsnap.log se incluye información adicional.
• dynamic.dtd o dynamic.xsd: (opcional) es posible que sea necesario un fichero de definición de tipo de documento XML (DTD) o un fichero de esquema XML (XSD) para leer inputDoc.xml. La instantánea puede contener uno de estos ficheros si es necesario para leer el fichero inputDoc.xml. Por ejemplo, los documentos DITA utilizan un DTD dinámico.
En la instantánea de APP no se incluye el tipo de documento, la hoja de estilo, el fichero de configuración de APP ni el contenido de los directorios application o custom. Es posible generar un fichero ZIP que los contenga mediante > .
Ejecución de la herramienta de instantánea
Después de generar el fichero zip de instantánea de
APP, se utilizará la herramienta
Ejecutar instantánea ALD para ejecutar el proceso de publicación del fichero de instantánea de
APP. Se puede utilizar un fichero
hints.xml para reemplazar algunos de los parámetros que
APP utiliza durante la publicación del documento. En el fichero de instantánea de
APP no se incluye ningún fichero
hints.xml. Se puede proporcionar una ruta para acceder a él en el cuadro de diálogo
Ejecutar instantánea ALD o insertar una directamente en el archivo de instantánea antes de ejecutar el proceso de resolución de problemas. Descomprima el fichero ZIP de instantánea, copie el fichero
hints.xml en el directorio extraído y, después, vuelva a comprimir el directorio.
Para proporcionar el fichero hints.xml, se debe crear uno. Es un documento XML que proporciona parámetros para reemplazar algunos de los parámetros de publicación que estaban en vigor en el momento en que se creó la instantánea. El fichero tiene el siguiente formato:
<app:AppSnapshotHints xmlns:app="http://arbortext.ptc.com/AppSnapshot">
<Hint name="nombre-de-parámetro" value="valor-de-parámetro"/>
<Hint name="nombre-de-parámetro" value="valor-de-parámetro"/>
<Hint name="nombre-de-parámetro" value="valor-de-parámetro" />
</app:AppSnapshotHints>
Los nombres y valores de especificaciones admitidos son los siguientes:
|
Nombre de especificación
|
Valor
|
|
cropmarks
|
Especifique 1 para mostrar las marcas de recorte. Especifique 0 para suprimirlas.
|
|
datemark
|
Especifique 1 para mostrar las marcas de fecha. Especifique 0 para suprimirlas.
|
|
printRange
|
Especifique las páginas que se deben imprimir o publicar en PDF. Se pueden especificar números de página, rangos de páginas o combinaciones de ambos, por ejemplo, 3-5,9,21-33.
|
|
regmarks
|
Especifique 1 para mostrar las marcas de registro. Especifique 0 para suprimirlas.
|
|
APPChecksumPath
|
Especifique 1 para generar un fichero de suma de control. Especifique 0 para suprimirlo. El fichero se coloca en el mismo directorio que el PDF que se genera a partir de la instantánea.
|
|
APPSavePath
|
Especifique 1 para guardar el fichero de plantilla de APP que se genera durante la publicación. Especifique 0 para suprimirlos. El fichero se coloca en el mismo directorio que el PDF que se genera a partir de la instantánea.
|
|
editstylesheet
|
Especifique la ruta absoluta a la hoja de estilo que se debe utilizar para abrir el documento de entrada antes de la publicación.
|
|
stylesheet
|
Especifique la ruta absoluta a una hoja de estilo que se entregará a APP durante la publicación.
|
|
APPConfigFile
|
Especifique la ruta absoluta a un fichero de configuración de APP que se entregará a APP durante la publicación.
|
Actividad de seguimiento durante la ejecución de la instantánea
Si hay problemas al ejecutar la herramienta de la instantánea, se puede usar el programa de diagnóstico. Inicie la herramienta Arbortext Diagnósticos desde los accesos directos del grupo de programas. Después defina la variable global ACL appsnapx::debug en 2. Emita el comando set debug==extwin en la línea de comandos o desde un script de custom\init. Después, ejecute la herramienta de instantánea de nuevo y compruebe la ventana de diagnóstico. Para obtener más información sobre la ventana de diagnósticos, consulte el tema sobre la obtención de información de seguimiento en el PDF Configuration Guide for Arbortext Publishing Engine.
Se recomienda que la resolución de problemas de publicación de APP mediante instantáneas se realice con la supervisión del Soporte técnico.