Generación de documentos con Rational DOORS como un origen de datos

Tras acabar de crear la plantilla de informa y llenarla con puntos de datos, puede generar un informe en varios formatos.

Antes de empezar

Si obtiene una vista previa de datos desde la aplicación Launcher, se utilizan la línea base y la vista predeterminadas para recuperar los datos.

Puede extraer Object Linking and Embedding (OLE) de un origen de datos de Rational DOORS. Consulte Objetos OLE.

Generación de un documento utilizando el de complemento

Si tiene el complemento de Rational DOORS instalado, puede generar documentos directamente desde la interfaz de usuario de Rational DOORS.

Acerca de esta tarea

  • Cuando se inicia una generación de documentos local desde el complemento de Rational Publishing Engine a través de la interfaz de usuario o la línea de mandatos, se consume una licencia en el sistema. La licencia se extrae cuando se inicia la generación de documentos remota. A continuación, la licencia se incorpora después de que se haya completado la generación de documentos.
  • Cuando se inicia una generación de documentos remota desde el complemento de Rational Publishing Engine a través de la interfaz de usuario o la línea de mandatos, se consume una licencia en el servidor. La licencia se extrae cuando se inicia la generación de documentos remota. A continuación, la licencia se incorpora después de que se haya completado la generación de documentos.
Nota: No puede acceder a las interfaces de usuario de Document Studio o Launcher mientras utiliza el complemento de Rational Publishing Engine para publicar un documento.

Procedimiento

Desde la vista Base de datos o la vista Módulo, pulse Publish.
  • Cuando se pulsa Publish desde la vista Base de datos, se le pedirán las configuraciones de plantilla y de especificación de documento como la haría pulsando Especificación de documento > Generar > Configurar y generar documento in Rational Publishing Engine.
  • Al pulsar Publish desde la vista Módulo, puede seleccionar una nueva especificación de documento y añadirle plantillas, o puede seleccionar una especificación de documento existente a la que ya se le han añadido plantillas. A continuación, si la plantilla utiliza un origen de datos Rational DOORS, Rational Publishing Engine configura el origen de datos automáticamente con la información del Módulo abierto para generar el documento. Si alguna de la información de configuración existente de la especificación de documento no coincide con la información del Módulo abierto, la información existente se sobrescribe con la información del Módulo abierto. Finalizar está habilitado cuando, al menos, está seleccionada una plantilla y un formato de salida.
    Importante: Para la generación de documentos local, Rational Publishing Engine se puede conectar a un cliente de Rational DOORS en ejecución, sin embargo, para la generación de documentos remota, dicha opción no está disponible. Si está publicando utilizando el motor de generación remota desde la vista Base de datos o Módulo, debe especificar credenciales de autenticación en la especificación de documento, antes de generar el documento, de forma que el servicio Rational Publishing Engine puede crear una instancia de un nuevo cliente de Rational DOORS de modalidad autónoma para obtener los datos de informe.

Generación de un documento utilizando el asistente de generación de documentos de Rational Publishing Engine

Puede utilizar el asistente de generación de documentos para configurar los requisitos de informe.

Procedimiento

  1. Ya sea en la aplicación Document Studio o Launcher, abra el asistente de generación de documentos pulsando Especificación de documento > Generar > Configurar y generar documento.
  2. En la sección Plantillas, se muestran las plantillas ya indicadas en la especificación de documento. Para añadir una plantilla:
    1. Seleccione la ubicación de las plantillas que deben añadirse:
      • De la biblioteca central: para seleccionar plantillas almacenadas en el Creador de documentos
      • De archivo local o remoto: para seleccionar un plantilla local o remota, puede especificar un URL a una plantilla o pulsar Examinar para seleccionar una.
    2. Seleccione una o varias plantillas para añadirlas.
      • Si ha seleccionado De la biblioteca central y ha seleccionado plantillas del Creador de documentos, pulse Añadir seleccionados para añadir las plantillas a la especificación de documento.
      • Si ha seleccionado De archivo local o remoto y ha especificado un URL a una plantilla individual, pulse Añadir URL para añadir la plantilla a la especificación de documento.
      • Si ha seleccionado De archivo local o remoto y ha pulsado Examinar para añadir plantillas, cuando pulse Abrir, las plantillas se añadirán a la especificación de documento.
    3. Opcional: Repita el proceso para añadir plantillas adicionales de otras ubicaciones.
    4. Opcional: Reordene las plantillas en la especificación de documento seleccionando una plantilla y pulsando Arriba o Abajo.
    5. Pulse Siguiente. Después de añadir una plantilla, los orígenes de datos y variables que se especifican en la plantilla también se añadirán al asistente.
  3. En la sección Orígenes de datos, configure cada origen de datos.
    Nota:
    • Si existe un valor predeterminado para un origen de datos o ya se ha especificado un valor de URI predeterminado, el origen de datos se muestra como configurado y el valor predeterminado se utiliza en la salida, a menos que se seleccione otro valor.
    • Si va más allá de la sección Orígenes de datos y, a continuación, pulsa Atrás para realizar cambios adicionales en un origen de datos, la sección siempre se abrirá en el primer origen de datos de la lista.
    1. Base de datos: especifique el nombre de la base de datos a la que conectarse. De forma predeterminada, se utiliza -data 36677@localhost. Si no se especifica -data, se añade automáticamente. Si no se especifica ningún valor, Rational Publishing Engine recupera el valor predeterminado del registro siempre que sea posible.
    2. Vía de acceso a doors.exe: especifique la vía de acceso completa a doors.exe. Si la vía de acceso no es válida o no es accesible, el asistente la corregirá automáticamente si es posible. Ejemplo: C:\Archivos de programa\IBM\Rational\DOORS\versión\bin\doors.exe
    3. URI de móduloVista, y Línea base: Puede escribir estos valores o pulsar Descubrir para utilizar un asistente para seleccionar en una lista de valores. Si elige utilizar el asistente de descubrimiento, pulse Siguiente y complete uno de los pasos siguientes:
      • Pulse Siguiente para seleccionar valores para el URI de módulo, la Vista y la Línea base. Si pulsa Siguiente, en la ventana Seleccionar una vista de la base DOORS, podrá seleccionar entre listas de módulos, vistas y líneas base. A continuación, pulse Finalizar.
      • Especifique un URI de módulo. Tras especificar un URI de módulo, se habilitará Finalizar y podrá pulsarlo para utilizar los valores predeterminados de vista y línea base. Para utilizar una vista y línea base diferentes de las predeterminadas, especifique los valores de Vista y Línea base que deben utilizarse en su lugar y pulse Finalizar.
        Nota: si edita manualmente el valor de URI de módulo y especifica un valor incorrecto, puede impedir la generación de la salida. Si proporciona un valor incorrecto o nulo para Vista o Línea base, la salida se genera a partir de la vista estándar de la versión de módulo actual. La salida se genera, pero los datos pueden no ser correctos.
    4. Nombre de usuario: especifique el nombre de cuenta de Rational DOORS.
    5. Contraseña: especifique la contraseña de la cuenta de Rational DOORS.
    6. Elija si va a utilizar la opción Utilizar instancia de DOORS en ejecución durante la generación de documentos:
      • Si se espera que Rational DOORS se ejecute desde la ubicación especificada en el campo Vía de acceso a doors.exe cuando genere un documento desde esta especificación de documento, seleccione la opción Utilizar una instancia de DOORS en ejecución durante la generación del documento. El tiempo de proceso puede ser menor cuando se utiliza la instancia de Rational DOORS en ejecución.
      • Si no se espera que Rational DOORS se ejecute desde la ubicación especificada en el campo Vía de acceso a doors.exe cuando genere un documento desde esta especificación de documento, deseleccione la opción Utilizar una instancia de DOORS en ejecución durante la generación del documento para iniciar una instancia nueva.
        Nota: si se utiliza la aplicación Servicios remotos, ésta siempre reescribe las propiedades doors_home y new_instance. Una vez cargada la especificación de documento, Rational Publishing Engine reescribe las propiedades para que coincidan con la configuración del servidor.

    Cuando se sustituyen valores incorrectos por Rational Publishing Engine en el asistente, los valores también se actualizan en la vista Propiedades para el origen de datos y en los valores de distintivo de tiempo de ejecución.

  4. En la sección Variables, configure cada variable.
    Nota:
    • Si existe un valor predeterminado para una variable, ésta se muestra como configurada y el valor predeterminado se utiliza en la salida, a menos que se seleccione otro valor.
    • Si va más allá de la sección Variables y, a continuación, pulsa Atrás para realizar cambios adicionales en una variable, la sección siempre se abrirá en la primera variable de la lista.
    1. En el menú desplegable, seleccione una de las opciones siguientes:
      • Configuración manual: para especificar cualquier valor para la variable porque no existe ninguna otra información de configuración para esta variable en la capa de configuración
      • De la capa de configuración: para seleccionar un valor de los metadatos de configuración que se han especificado para la variable en la plantilla
    2. Especifique o seleccione un valor para la configuración.
    3. Pulse Siguiente.
  5. En la sección Salida, seleccione los tipos de salida que deben generarse:
    • Microsoft Word
    • PDF
    • HTML
    • XSL-FO
    1. Opcional: En Ubicación donde guardar, pulse Examinar para seleccionar una vía de acceso para guardar el archivo de cada tipo de salida. Puede editar la vía de acceso para convertirla en una vía de acceso relativa desde la especificación de documento. Si no se especifica una ubicación para guardar la salida, el archivo se genera en una ubicación temporal.
    2. Opcional: En Hoja de estilo, pulse Examinar para seleccionar una hoja de estilo que debe utilizarse para cada tipo de salida al generar la salida.
    3. Opcional: Sólo salida Microsoft Word: en Macro, especifique el nombre de la macro contenida en la hoja de estilo.
    4. Opcional: Para especificar metadatos adicionales o configurar otras propiedades de documento que no se incluyen en el asistente, pulse Editar propiedades de metadatos.
    5. Pulse Siguiente.
  6. Verifique que la plantilla y la información de salida de la ventana de resumen son correctas.
  7. Seleccione la acción que debe realizarse al pulsar Finalizar:
    • Ejecutar la generación del documento: genera los tipos de salida especificados.
    • Ejecutar la generación del documento y abandonar RPE: genera los tipos de salida especificados y cierra la aplicación Rational Publishing Engine una vez que el usuario ha abandonado la ventana de resultados.
    • Guardar y cerrar el asistente sin generar el documento: el asistente de generación de documentos se cierra y la aplicación Lanzador permanece abierta.
    Nota: Si utiliza el asistente de generación de documentos desde el complemento de Rational DOORS, seleccionar Guardar y cerrar este asistente sin generar el documento cierra el asistente y la aplicación Launcher.