Herramientas de diagnóstico

Para resolver problemas, puede utilizar las herramientas de diagnóstico disponibles en Rational Publishing Engine como, por ejemplo, la herramienta de verificación de plantillas, la vista Consola, la vista Problemas y los archivos de registro.

Herramienta de verificación de plantillas

Cuando se ejecuta la herramienta de verificación de plantillas, se proporcionará una lista de los problemas como, por ejemplo:
  • Orígenes de datos: Se pueden producir conflictos si se utiliza el mismo origen de datos en distintos elementos de configuración de origen de datos.
  • Elementos de configuración de origen de datos: Estos elementos tienen que estar configurados.
  • Elementos duplicados: Para elementos como tabla de tablas, tabla de contenido y tabla de figuras, solamente puede utilizarse uno de ellos en la plantilla.
  • Expresiones de script: Se comprueban las propiedades de las páginas maestras y del nombre de estilo para verificar que el nombre que se utiliza en el script corresponda a una propiedad.
  • Mayúsculas/Minúsculas: Se comprueban los nombres de variables, páginas maestras, orígenes de datos y estilos para verificar que coincida la escritura de mayúsculas y minúsculas.
  • Nombres de región: Se comprueban para verificar que sean exclusivos.

Consulte Comprobación de errores de plantillas si desea más información sobre cómo utilizar la herramienta de verificación de plantillas.

Vista previa de datos

Si especifica un origen de datos en la especificación de la plantilla o del documento, puede conseguir una vista previa de los datos incluidos cuando se generó el documento. Mediante la vista previa de datos, puede determinar si los problemas con la salida proceden del proveedor de datos o de la estructura de la plantilla.

Consulte Visualización previa de datos desde la Vista de origen de datos o Visualización previa de los datos desde la vista Especificación de documento si desea más información.

Vista Consola

La vista Consola proporciona resúmenes breves de los procesos de Rational Publishing Engine a medida que se van produciendo. Por ejemplo, cuando se inicia Rational Publishing Engine Document Studio, la vista consola podría visualizar mensajes informativos parecidos a los siguientes:

CRRPE0321I Licencia de RPE - Se ha confirmado la licencia, y es válida durante 300 días más.
CRRPE0282I Se ha iniciado Document Studio.

Cuando se generan los documentos, el proceso de elementos y datos de plantilla procedentes del origen de datos se produce en dos hebras. La primera hebra es una hebra de entrada que lee los datos y la segunda hebra es una hebra de salida que procesa los datos. El proceso de estas hebras se entremezcla en la vista Consola porque las hebras de entrada y salida se procesan simultáneamente.
  • Se han procesado x elementos de entrada: La primera hebra genera los mandatos para la generación del documento
  • Se procesan los mandatos de publicación x. Aún quedan por procesar los mandatos de publicación x: La segunda hebra publica los mandatos que ha generado la hebra de entrada
x representa el número d e mandatos que se están procesando. Un mandato consta de tres partes de un elemento de plantilla y de datos del origen de datos: un mandato para empezar a procesar el elemento, un mandato para el contenido del elemento y un mandato para finalizar el proceso del elemento. Por tanto, el número de mandatos siempre es de tres veces más de la cantidad de elementos que haya en la plantilla.

Las cantidades de elementos de entrada y de mandatos de publicación aumenta y disminuye durante la generación de documentos porque Rational Publishing Engine se ha diseñado para que lea tantos datos como pueda procesar a la vez. La hebra de entrada genera los mandatos más rápido de lo que la hebra de salida puede publicarlos. Cuando la primera hebra genera una determinada cantidad de mandatos, la hebra de entrada se detiene hasta que la hebra de salida continúa con la publicación de los mandatos. Por tanto, aunque es posible que espere que las cifras solamente disminuyan mientras va progresando la generación de documentos, la fluctuación de las cifras es una evidencia de que Rational Publishing Engine está llevando a cabo más de un proceso a la vez.

Para abrir la vista Consola, pulse Ventana > Mostrar vista > Consola.

Consulte Ejemplo: Cambio del distintivo de límite de caracteres de la vista Consola si desea información sobre cómo ajustar el número de caracteres que se visualizan. Consulte Personalización de los registros de consola si desea información sobre personalizaciones como, por ejemplo, el cambio de formato de los mensajes que se visualizan.

Vista Problemas

La vista Problemas proporciona una lista de los errores de Rational Publishing Engine a medida que se van produciendo.

Para abrir la vista Problemas, pulse Ventana > Mostrar vista > Problemas.

Para obtener más información sobre un error, pulse el botón derecho del ratón en el error y seleccione Propiedades. Las propiedades de un error le proporcionan más información como, por ejemplo, en qué elemento se produce el error, que le ayudará a la hora de resolver el problema.

Archivos de registro

Rational Publishing Engine tiene dos métodos para visualizar la información de procesos en los archivos de registro, que puede utilizar para identificar problemas. El primer método es mediante los archivos de registro de la interfaz de usuario. Los problemas que se detecten durante el diseño de plantillas y las especificaciones de documentos aparecerán en los archivos de registro de la interfaz de usuario. El segundo método es a través de los registros principales. Los problemas que se detenten durante la generación de documentos a partir de plantillas y de especificaciones de documentos se listarán en los archivos de registro principales. El personal de soporte de IBM® puede utilizar los archivos de registro de procesos principales y de interfaz de usuario para ayudarle a resolver problemas.
Nota: La variable del sistema RPE_HOME debe haberse definido para leer la configuración de registro.

Archivos de registro principales

Los archivos de registro almacenan un historial del motor principal relacionado con problemas que se producen durante la generación de documentos a partir de plantillas y de especificaciones de documentos. Puede ver información adicional en los archivos de registro principales cuando haya establecido la preferencia de la modalidad de depuración en Yes. Consulte Establecimiento de las preferencias del motor.

Los archivos de registros se pueden hallar en los directorios de archivos temporales del espacio de trabajo predeterminado para Document Studio y Lanzador. Por ejemplo: TEMP\RPE\rpe.log

Consulte Personalización de archivos de registro si desea información sobre personalizaciones como, por ejemplo, el cambio de ubicación del archivo de registro.

Archivos de registro de la interfaz de usuario

Los archivos de registro almacenan un historial de problemas relacionados con la interfaz de usuario mientras se utiliza Rational Publishing Engine Document Studio y Lanzador de Rational Publishing Engine.
Los archivos de registro se pueden hallar en los datos de aplicación los directorios de espacio de trabajo predeterminados para Document Studio y Lanzador. Ejemplos:
  • APPDATA\IBM\Rational\RPE_fecha\Launcher\workspace\.metadata\.log
  • APPDATA\IBM\Rational\RPE_fecha\Studio\workspace\.metadata\.log