Instrucciones de la herramienta: Revisiones de requisitos utilizando Rational RequisitePro
En esta guía de la herramienta se describe cómo utilizar Rational RequisitePro® para facilitar revisiones de requisitos.
Herramienta: Rational RequisitePro
Descripción principal

Visión general

RequisitePro facilita la revisión de requisitos en un entorno de equipo de proyecto. Se puede organizar y acceder a toda la documentación del proyecto desde una única ubicación y, a continuación, los miembros del equipo pueden compartir comentarios sobre requisitos específicos o aspectos más amplios del proyecto a través de discusiones en línea. Todos los elementos de discusión se almacenan en la base de datos de proyecto para su posterior revisión. Para revisar documentos de requisitos, un autor puede proteger, temporalmente, un documento durante la revisión. Más tarde, las revisiones se fusionan en el proyecto y se ponen a disposición de todos los miembros del equipo.

Pasos de la herramienta

Los procedimientos y conceptos de revisión de requisitos siguientes se presentan con más detalle.

  1. Acceder a documentos de requisitos de una única ubicación
  2. Registrar cambios de requisitos en documentos
  3. Desarrollar un diálogo de equipo de proyecto
  4. Proteger documentos de requisitos para su revisión

1. Acceder a documentos de requisitos

A medida que se crean o importan documentos de requisitos a RequisitePro, se van integrando en el proyecto de gestión de requisitos. Cada documento se asocia a la base de datos de proyecto, que permite el acceso rápido y centralizado a todos los usuarios. Todos los documentos de requisitos del proyecto se pueden abrir desde un único recuadro de diálogo, y también se pueden añadir documentos que no sean de requisitos como, por ejemplo, un glosario, al proyecto de RequisitePro a fin de que el equipo de proyecto pueda acceder fácilmente a estos. Además, la información de requisitos está disponible a través de varias interfaces, incluidas Microsoft® Word, vistas y RequisiteWeb.

Para crear un documento de requisitos:

  1. En el Explorador, seleccione el paquete en el que desea situar el nuevo documento y, a continuación, pulse Archivo > Nuevo > Documento. Se muestra el recuadro de diálogo Propiedades del documento.
  2. En la pestaña General, escriba un nombre y una descripción para el documento. En la lista Tipo de documento, seleccione el tipo de documento en el que desea basar el nuevo documento.
  3. Pulse Aceptar.

Puede abrir uno o más documentos de requisitos desde el Explorador de modelos realizando una de las acciones siguientes:

  • Efectúe una doble pulsación en el documento.
  • Pulse el botón derecho del ratón sobre el documento y seleccione Abrir.

Para importar un documento de Word que contenga texto de requisito:

  1. Pulse Archivo > Importar. Se muestra el asistente para la importación.
  2. Seleccione la opción de documento de Microsoft Word y, a continuación, escriba la vía de acceso y el nombre del documento de Word que desea importar, o bien, pulse Examinar y navegue al documento que desea.
  3. Pulse Siguiente para avanzar en el asistente. Al seleccionar la opción Requisitos y documento, RequisitePro analiza, automáticamente, los requisitos y los marca en el documento importado. Puede analizar los requisitos en base a palabras clave, delimitadores de texto o estilos de párrafo de Word.
  4. Se muestra el recuadro de diálogo Propiedades del documento. Escriba un nombre de documento y una descripción, y seleccione un tipo de documento de la lista. A continuación, pulse Aceptar.

Para obtener más información

icono de publicación de ayuda Consulte los temas de la Ayuda en línea de RequisitePro que tratan sobre:

  • Creación de documentos de requisitos (Índice: documentos > creación)
  • Apertura de documentos (Índice: documentos > apertura)
  • Importación de requisitos de un documento de Word (Índice: importación > requisitos de un documento de Word)

2. Registrar cambios de requisitos en documentos

Cuando modifica el texto de un requisito en un documento, debe describir el motivo del cambio. RequisitePro registra y supervisa la información de revisión, proporcionando un registro del historial de los cambios de requisitos.

Para registrar un cambio de requisito en un documento:

  1. Modifique el texto de requisito.
  2. Pulse en cualquier lugar del texto de requisito y, a continuación, pulse RequisitePro > Requisito > Anotar cambio. Se muestra el recuadro de diálogo Descripción de cambio.
  3. En el recuadro Descripción de cambio, escriba el motivo del cambio.
  4. Pulse Aceptar para cerrar el recuadro de diálogo.

La información de cambio de requisitos se pone a disposición de los miembros del proyecto. Pulse RequisitePro > Propiedades del requisito y, a continuación, pulse la pestaña Revisión. RequisitePro genera un número de revisión para el requisito, indica la fecha y la hora en la que se ha realizado el cambio, lista al autor de la revisión y proporciona una descripción del cambio.

Para obtener más información

icono de publicación de ayuda Consulte los temas de la ayuda en línea de RequisitePro que tratan sobre:

  • Visión general de la revisiones (Índice: revisiones > visión general)
  • Creación y modificación de la información de revisión de requisitos (Índice: revisiones > requisitos)

3. Desarrollar un diálogo de equipo de proyecto

RequisitePro facilita la revisión y la comunicación del equipo con grupos de discusión, simplificando así que los usuarios discutan sobre los requisitos. Con grupos de discusión, los usuarios pueden crear y distribuir rápidamente temas de discusión como, por ejemplo, comentarios, problemas e, incluso, avisos de cambio, con respecto a un requisito o a cualquier aspecto de un proyecto. La distribución se puede realizar a un equipo equipo completo, o bien, se puede limitar a un grupo específico de usuarios. Si se habilita el correo electrónico para el proyecto, se puede elaborar respuestas en RequisitePro o RequisiteWeb o con cualquier aplicación de correo electrónico de SMTP. RequisitePro notifica a los usuarios de los nuevos mensajes y almacena las hebras de discusión junto con los requisitos asociados con el objeto de que todo el equipo pueda consultarlos con facilidad.

Los grupos de discusión ayudan a que los equipos capturen los motivos principales para tomar decisiones y proponer cambios. Los grupos de discusión permiten que los usuarios lleven a cabo lo siguiente:

  • Crear discusiones y asociarlas a un único requisito, un conjunto de requisito o un proyecto completo.
  • Distribuir automáticamente un mensaje de correo electrónico (si está habilitado) al público de discusión seleccionado.
  • Ver una representación gráfica de las hebras de discusión en un formato de árbol jerárquico en el que se muestran comentarios y respuestas.
  • Ejecutar consultas y discusiones.
  • Modificar los atributos de una discusión (prioridad, estado).
  • Imprimir discusiones.

Para crear una discusión:

  1. Abra el recuadro de diálogo Discusión realizando una de las acciones siguientes:
    • En el Explorador, seleccione un requisito y pulse Requisito > Discusiones.
    • En una vista, seleccione uno o más requisitos y pulse Requisito > Discusiones.
    • En un documento de Word, pulse en cualquier lugar de un requisito y, a continuación, pulse RequisitePro > Requisito > Discusiones.
  2. Pulse Crear.
  3. En el recuadro de diálogo Propiedades de la discusión, pulse las pestañas General, Atributos, Participantes y Requisitos para definir la discusión y añadir participantes. Se ofrece la opción de asociar la discusión con requisitos.
  4. Pulse Aceptar y, a continuación, Cerrar.

Para ver y responder a una discusión:

  1. Pulse Proyecto > Ver discusiones, o bien, pulse el icono de la discusión resaltada icono de discusión de la barra de herramientas (que indica que se ha creado un nuevo mensaje de discusión).
  2. En la lista de discusiones, pulse una discusión. Se muestra un indicador para expandir y contraer a la parte izquierda de las discusiones con respuesta.
  3. Pulse un elemento para leerlo.
  4. Para responder al elemento de discusión seleccionado, pulse Responder.
  5. En el recuadro de diálogo Respuesta de discusión, escriba la respuesta.
  6. Pulse Aceptar.

Para obtener más información

icono de publicación de ayuda Consulte los temas de la Ayuda en línea de RequisitePro que tratan sobre:

  • Creación de discusiones (Índice: discusiones > creación)
  • Lectura de discusiones (Índice: discusiones > visualización)
  • Respuesta a discusiones (Índice: discusiones > respuesta a)
  • Configuración del correo electrónico para discusiones (Índice: correo electrónico > discusiones, establecimiento de proyectos para)

4. Proteger documentos de requisitos para su revisión

Gracias a la característica "autoría fuera de línea" de RequisitePro, se ha mejorado el proceso de revisión, puesto que permite que los autores "extraigan" un documento del proyecto y lo revisen en Microsoft Word. Una copia de sólo lectura del documento permanece en RequisitePro; está protegido de modo que otros miembros del equipo no lo puedan modificar hasta que se haya completado la revisión. El documento fuera de línea, que es, simplemente, un documento de Word, se puede distribuir a los coautores para su revisión. El documento resultante se puede volver a poner en línea y completar el ciclo de revisión.

Mientras el documento está fuera de línea, el usuario que ha situado el documento fuera de línea puede utilizar Word para marcar (crear), quitar la marca y suprimir requisitos del documento. El usuario puede direccionar el documento a otros miembros del equipo para revisiones similares. (Se recomienda mantener sólo una copia del documento fuera de línea y pasar dicha copia a cada miembro del equipo por turnos). Los demás usuarios pueden ver el documento en RequisitePro, pero no editarlo.

Cuando se devuelve el documento, RequisitePro lleva a cabo lo siguiente:

  • Crea requisitos del texto marcado.
  • Actualiza la base de datos con los cambios que se han realizado en los requisitos existentes, que pueden incluir supresiones, modificaciones y adiciones. Si se suprimen requisitos, se pregunta al propietario de la sesión fuera de línea antes de registrar las supresiones.
  • Rechaza cualquier cambio en los requisitos para los que el usuario no dispone de permiso de edición. En este caso, el documento completo vuelve a su estado en línea original.

Para situar un documento de requisitos fuera de línea:

  1. Pulse Herramientas > Documentos fuera de línea.
  2. Pulse el documento que desea situar fuera de línea. (Utilice una acción de selección múltiple para seleccionar varios documentos).
  3. Pulse Situar fuera de línea. Se muestra el recuadro de diálogo Información de Situar fuera de línea.
  4. Escriba un motivo para situar el documento fuera de línea y la vía de acceso del directorio en el que desea almacenar el documento (o bien, pulse Examinar para localizar el directorio).
  5. Si va a situar varios documentos fuera de línea, seleccione el recuadro de selección Aplicar a todos para aplicar las entradas Motivo y Ubicación a todos los documentos. Deseleccione este recuadro de selección para tratar cada documento de modo individual.
  6. Pulse Aceptar.

Para volver a colocar los documentos en línea:

  1. Pulse Herramientas > Documentos fuera de línea.
  2. En la lista Documentos fuera de línea, seleccione el documento que desea volver a colocar en línea.
  3. Pulse Colocar en línea.
  4. En el recuadro Descripción de los cambios, escriba una descripción de los cambios que ha realizado en el documento seleccionado actualmente cuando se encontraba fuera de línea. Si va a volver a colocar varios documentos en línea y los cambios se aplican a todos los documentos subsiguientes, seleccione el recuadro de selección Aplicar a todos.
  5. Pulse Aceptar. Pulse para aceptar el documento actualizado.

Para obtener más información

icono de publicación de ayuda Consulte los temas de la Ayuda en línea de RequisitePro que tratan sobre:

  • Cómo situar documentos fuera de línea (Índice: autoría fuera de línea > cómo situar documentos fuera de línea)
  • Cómo volver a colocar en línea documentos que están fuera de línea (Índice: autoría fuera de línea > cómo volver a colocar documentos en línea)