Revisar (CMMI)

En este tema, puede obtener información sobre cómo rellenar los detalles de un elemento de trabajo de revisión. Un equipo puede utilizar el elemento de trabajo de revisión para documentar los resultados de una revisión del diseño o del código. Los miembros del equipo pueden capturar los detalles de cómo el diseño o el código satisface las normas en las áreas de exactitud del nombre, relevancia del código, extensibilidad, complejidad del código, complejidad algorítmica y seguridad del código. Para obtener más información, vea Implementar tareas de desarrollo.

Para obtener información sobre cómo crear este tipo de elemento de trabajo, vea Elementos de trabajo y flujo de trabajo (CMMI).

En este tema	Temas relacionados
Definir una revisión Vincular una revisión a un requisito, una tarea u otro elemento de trabajo Agregar detalles, datos adjuntos o hipervínculos a una revisión Cambiar el estado de una revisión	Guía de procesos Implementar tareas de desarrollo Referencia de campos Campos de las reuniones de revisión (CMMI) Título, Id., Descripción e Historial (CMM) Áreas e iteraciones Asignaciones, flujo de trabajo y planeamiento (CMMI) Vincular elementos de trabajo (CMMI) Datos adjuntos

Permisos necesarios

Para ver una revisión, debe ser miembro del grupo de seguridad Readers o tener el permiso Ver los elementos de trabajo en este nodo establecido en Permitir. Para modificar una revisión, debe ser miembro del grupo Contributors o tener los permisos Editar elementos de trabajo en este nodo establecidos en Permitir. Para obtener más información, vea Administrar permisos.

Definir una revisión

El formulario de elemento de trabajo para una revisión almacena los datos en los campos y pestañas que muestran las ilustraciones siguientes:

   

Al definir una revisión, debe definirse el Título en la sección superior del formulario de elemento de trabajo y el Propósito en la pestaña Detalles. Puede dejar todos los demás campos en blanco o aceptar sus valores predeterminados.

Para definir una revisión única

1. En la sección superior del formulario de elemento de trabajo, especifique uno o más de los siguientes tipos de información:

   • En Título (Obligatorio), escriba una descripción corta que distinga esta revisión de otros elementos de trabajo de revisión.

     Los buenos títulos identifican la sección de código o el área de diseño que se revisó.

   • En la lista Tipo de reunión, haga clic en el tipo de reunión que de utilizó para la revisión.

     Los valores válidos son Reunión o Sin conexión.

   • En la lista Asignado a, haga clic en el nombre del miembro del equipo responsable de resolver la revisión.

     Nota

     Solamente puede asignar elementos de trabajo a los miembros del grupo Contributors.

     Si deja el caso sin revisar, se le asignará automáticamente.

   • En la lista Estado, deje el valor predeterminado, Activo.

   • En la sección Facilitadores, haga clic en el nombre del miembro del equipo que convocó la reunión y escriba la fecha de la reunión.

2. En la pestaña Detalles, proporcione tanto detalle como desee para describir el área de código o diseño que se revisó, además de los criterios que se aplicaron en la revisión.

3. En la pestaña Minutos, proporcione tanto detalle como desee para describir los resultados, la discusión, los criterios y las decisiones resultantes de la reunión de revisión.

   Esta información podría incluir lo que se revisó, los criterios que se aplicaron y los problemas que se identificaron.

4. En la pestaña Comentarios, escriba la información diversa, sobre la revisión, que no se capture de la manera adecuada en ningún otro lugar.

5. En la pestaña Asistentes, haga clic en el nombre de cada miembro del equipo que sea un asistente necesario, opcional o real a la revisión.

   Estos miembros del equipo son miembros del consejo de revisión.

6. En la pestaña Todos los vínculos, vincule la revisión a uno o más elementos de trabajo diferentes, tales como requisitos o tareas.

7. En la pestaña Datos adjuntos, adjunte especificaciones, imágenes u otros archivos que proporcionen más detalles sobre la revisión que se va a realizar.

   Para obtener más información, vea las siguientes secciones en este tema:

   • Vincular una revisión a un requisito, una tarea u otro elemento de trabajo

   • Agregar detalles, datos adjuntos o hipervínculos a una revisión

8. Haga clic en Guardar elemento de trabajo.

   Nota

   Después de guardar la revisión, aparecerá el identificador en el título debajo de la barra de herramientas del elemento de trabajo.

Vincular una revisión a un requisito, una tarea u otro elemento de trabajo

Utilice la pestaña Vínculos para crear vínculos a tipos específicos de elementos de trabajo y para tipos específicos de vínculos. Para obtener más información, vea Vincular elementos de trabajo (CMMI).

Para crear y vincular una tarea, un requisito u otro elemento de trabajo a una revisión

1. Abra el formulario para el elemento de trabajo de revisión, haga clic en la pestaña Todos los vínculos y, a continuación, haga clic en Nuevo.

   Se abre el cuadro de diálogo Agregar nuevo elemento de trabajo vinculado.

   

2. En la lista Tipo de vínculo, haga clic en Relacionado u otro tipo de vínculo que represente la relación de la que desee realizar un seguimiento.

3. En la lista Tipo de elemento de trabajo, haga clic en el tipo de elemento de trabajo que desea crear.

4. En Título, escriba una descripción breve pero específica.

5. (Opcional) Escriba información adicional en Comentario.

6. Haga clic en Aceptar.

   Se abre un formulario correspondiente al tipo de elemento de trabajo especificado con la información proporcionada.

7. Especifique los campos restantes según se describe en los siguientes temas:

   • Requisito (CMMI)

   • Solicitud de cambio (CMMI)

   • Tarea (CMMI)

   • Error (CMMI)

   • Caso de prueba (Agile)

   • Problema (CMMI)

8. Haga clic en Guardar elemento de trabajo.

Para vincular uno o más elementos de trabajo existentes a una revisión

1. Abra el formulario para el elemento de trabajo de revisión, haga clic en la pestaña Todos los vínculos y, a continuación, haga clic en Vincular a.

   Se abrirá el cuadro de diálogo Agregar vínculo a Revisión.

   

2. En la lista Tipo de vínculo, haga clic en Relacionado o en otro tipo de vínculo que represente la relación cuyo seguimiento se desea realizar según el tipo de elemento de trabajo con que se establece el vínculo.

3. Realice una de las acciones siguientes:

   • En Identificadores de elementos de trabajo, escriba los identificadores de los elementos de trabajo que desea buscar. Separe los identificadores con comas o espacios.

   • Haga clic en Examinar para especificar elementos de trabajo en una lista.

     Aparece el cuadro de diálogo Elegir elementos de trabajo vinculados.

     

     En la lista Consulta guardada, haga clic en una consulta que contenga los elementos de trabajo que desea agregar. Por ejemplo, puede hacer clic en Elementos de trabajo abiertos, Errores activos o Tareas activas.

     Haga clic en Buscar, active la casilla situada al lado de cada elemento de trabajo que desee vincular al problema y, a continuación, haga clic en Aceptar.

   • (Opcional) Escriba una descripción de los elementos a los que está estableciendo vínculos.

4. Haga clic en Aceptar.

   Para obtener más información, vea Buscar elementos de trabajo para vincular o importar.

5. Haga clic en Guardar elemento de trabajo.

   Nota

   Se actualizan la revisión y los elementos de trabajo a los que estableció vínculos.

Agregar detalles, datos adjuntos o hipervínculos a una revisión

A medida que haya más información disponible, puede agregar información a una revisión de las maneras siguientes:

• Información de tipo en los cuadros de las pestañas Detalles, Minutos o Comentarios.

• Adjunte un archivo.

  Por ejemplo, puede adjuntar un subproceso de correo electrónico, un documento, una imagen, un archivo de registro u otro tipo de archivo.

• Agregue un hipervínculo a un sitio web o a un archivo que esté almacenado en un servidor o sitio web.

Para agregar detalles a una revisión

1. Haga clic en la pestaña Detalles, Minutos o Comentarios y escriba información en los cuadros.

   Puede aplicar formato a la información para dar énfasis o capturar una lista con viñetas.

   Nota

   Cada vez que un miembro del equipo actualiza el elemento de trabajo, en el historial de este se muestra la fecha del cambio, el nombre del miembro del equipo que lo realizó y los campos que han cambiado.

   Para obtener más información, vea Campos de las reuniones de revisión (CMMI) y Títulos, Identificadores, Descripciones e Historial (Agile).

2. Haga clic en Guardar elemento de trabajo.

Para agregar datos adjuntos a una revisión

1. En la pestaña Datos adjuntos, realice una de las siguientes acciones:

   • Arrastre un archivo al área de datos adjuntos.

   • Haga clic en o presione CTRL+V para pegar un archivo que se haya copiado.

   • Haga clic en Agregar, en Examinar y, en el cuadro de diálogo Datos adjuntos, escriba o busque el nombre del archivo que desee asociar.

     (Opcional) Escriba información adicional sobre los datos adjuntos en el cuadro Comentario. Haga clic en Aceptar para cerrar el cuadro de diálogo Datos adjuntos.

2. Haga clic en Guardar elemento de trabajo.

Para agregar un hipervínculo a una revisión

1. En la pestaña Todos los vínculos, haga clic en Vincular a.

   

2. En la lista Tipo de vínculo, haga clic en Hipervínculo.

3. En el cuadro Dirección, lleve a cabo una de las acciones siguientes:

   • Si el destino es un sitio web, escriba la dirección URL o bien cópiela del explorador de Internet y péguela en el cuadro Dirección.

   • Si el destino es una ubicación del servidor, escriba su dirección UNC.

4. (Opcional) Escriba información adicional sobre el hipervínculo en el cuadro Comentario.

5. Haga clic en Aceptar.

6. Haga clic en Guardar elemento de trabajo.

Cambiar el estado de una revisión

Si la revisión descubre que el diseño o el código no necesitan ningún cambio, se puede cerrar el elemento de trabajo de revisión. Si el diseño o el código necesitan cambios principales o secundarios, el elemento de trabajo de revisión activo se asigna a un desarrollador de software para que lo resuelva. Si solo se necesitan cambios secundarios, el desarrollador de software puede cerrar el elemento de trabajo de revisión. Si se necesitan cambios principales, se solicita una segunda revisión y solo se cierra el elemento de trabajo de revisión si la segunda revisión se supera correctamente.

Los miembros del equipo pueden utilizar los siguientes estados para realizar el seguimiento del progreso de las revisiones:

• Activo

• Resuelto

• Cerrado

Puede crear una revisión en el estado Activo.

Para obtener más información sobre los campos de datos que puede utilizar para realizar el seguimiento de los estados de los elementos de trabajo, vea Asignaciones, flujo de trabajo y planeamiento (CMMI).

Para cambiar el estado de una revisión

1. Abra el elemento de trabajo de revisión.

2. En la lista Estado, haga clic en Resuelto o Cerrado.

   • Si cambia el estado de Activo a Resuelto, el campo Motivo cambiará automáticamente a Aceptado con cambios secundarios.

   • Si cambia el estado de Resuelto a Cerrado, el campo Motivo cambia a Cambios secundarios completados.

3. Haga clic en Guardar elemento de trabajo.

Progresión habitual del flujo de trabajo: Un miembro del equipo crea una revisión en el estado Activo con el motivo predeterminado, Nuevo. Un miembro del equipo cambia el estado de la revisión de Activo a Resuelto cuando el consejo de revisión determina que el código es aceptable si se realizan modificaciones secundarias. Un miembro del equipo cambia el estado de Resuelto a Cerrado una vez realizadas las modificaciones necesarias. Transiciones atípicas: Un miembro del equipo cambia el estado de Activo a Cerrado con el motivo predeterminado, Aceptado (como está). El consejo de revisión determina que es necesario hacer cambios principales en el código y cambia el estado de Resuelto a Activo. Un miembro del equipo determina que la revisión se cerró por error y cambia el estado de Cerrado a Activo.

Diagrama de estado de revisión

Activo (Nuevo)

Un elemento de trabajo de revisión activo documenta los resultados de una revisión de diseño o revisión. Los asistentes a la reunión de revisión determinan cuáles deben ser los pasos siguientes. El elemento de trabajo de revisión se cierra si no es necesario ningún cambio. Si se necesita algún cambio, permanece activo y se asigna al desarrollador de software adecuado. El desarrollador de software resuelve el elemento de trabajo de revisión una vez completados los cambios.

De Activo a Resuelto

Un miembro del equipo puede resolver una revisión activa por las razones de la tabla siguiente:

Motivo	Cuándo utilizarlo	Acciones adicionales que se deben realizar
Aceptado con cambios secundarios	Cuando el desarrollador de software haya completado los cambios identificados en el diseño o en el código.	Ninguno.
Aceptado con cambios principales	Cuando el desarrollador de software haya completado los cambios identificados en el diseño o en el código.	Reactive el elemento de trabajo de revisión.

Los campos de datos siguientes se capturan cuando un miembro del equipo resuelve una revisión activa:

• Resuelto por: nombre del miembro del equipo que resolvió la revisión.

• Fecha de resolución: fecha y hora en que se resolvió la revisión, tal como se graba mediante el reloj del servidor.

• Fecha de cambio de estado: fecha y hora en que se cambió el estado de la revisión.

De Activo a Cerrado

Un miembro del equipo puede cerrar una revisión activa cuando el consejo de revisión decida, por cualquier razón, que no se necesita ningún cambio. El campo Motivo se establece automáticamente en Aceptado (como está).

Los campos de datos siguientes se capturan cuando un miembro del equipo cierra una revisión activa:

• Cerrado por: nombre del miembro del equipo que cerró la revisión.

• Fecha de cierre: fecha y hora en que se cerró la revisión, tal como se graba mediante el reloj del servidor.

• Fecha de cambio de estado: fecha y hora en que se cambió el estado de la revisión.

Resuelto

Un elemento de trabajo de revisión resuelto indica que se han completado los cambios necesarios, ya sea secundarios o principales. Si los cambios eran principales, se requiere una segunda revisión antes de poder cerrar el elemento de trabajo de revisión. Si la segunda revisión revela cambios adicionales, el elemento de trabajo de revisión se reactiva.

De Resuelto a Cerrado

Un miembro del equipo puede cerrar una revisión resuelta por los motivos que aparecen en la tabla siguiente:

Motivo	Cuándo utilizarlo	Acciones adicionales que se deben realizar
Cambios secundarios completados	Cuando se han identificado, realizado y comprobado los cambios secundarios.	Asigne la revisión al propietario del producto.

Los campos de datos siguientes se capturan automáticamente cuando un miembro del equipo cierra una revisión resuelta:

• Cerrado por: nombre del miembro del equipo que cerró la revisión.

• Fecha de cierre: fecha y hora en que se cerró la revisión, tal como se graba mediante el reloj del servidor.

• Fecha de cambio de estado: fecha y hora en que se cambió el estado de la revisión.

De Resuelto a Activo

Puede reactivar una revisión resuelta por los motivos que aparecen en la tabla siguiente:

Motivo	Cuándo utilizarlo	Acciones adicionales que se deben realizar
Cambios principales completados	Cuando se requiera una segunda revisión para determinar si queda algún problema.	Convoque otra reunión de revisión para comprobar el código que cambió.

Los siguientes datos se capturan automáticamente cuando un miembro del equipo reactiva una revisión resuelta:

• Activado por: nombre del miembro del equipo que reactivó la revisión.

• Fecha de activación: fecha y hora en que se reactivó la revisión, tal como se graba mediante el reloj del servidor.

• Fecha de cambio de estado: fecha y hora en que se cambió el estado de la revisión.

Cerrado

En una revisión cerrada ya no se trabaja, pero se puede reactivar si vuelve al ámbito. Normalmente, los responsables de reactivar una revisión cerrada son un analista de negocios o un administrador de programas.

De Cerrado a Activo

Un elemento de trabajo de revisión cerrado indica que la revisión ha finalizado y se han completado los cambios necesarios. Puede reactivar una revisión cerrada si se cerró accidentalmente. La razón para la reactivación se establece en Cerrado por error.

Los siguientes datos se capturan automáticamente cuando un miembro del equipo reactiva una revisión cerrada:

• Activado por: nombre del miembro del equipo que reactivó la revisión.

• Fecha de activación: fecha y hora en que se reactivó la revisión, tal como se graba mediante el reloj del servidor.

• Fecha de cambio de estado: fecha y hora en que se cambió el estado de la revisión.

Vea también

Conceptos

MSF for CMMI Process Improvement v5.0

Otros recursos

Campos de las reuniones de revisión (CMMI)

Tarea (CMMI)

Elementos de trabajo y flujo de trabajo (CMMI)