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	Guia de procesos Implementar tareas de desarrollo Referencia de campos Revisar referencia de campo de reuniones (CMMI) Referencia de campo de títulos, identificadores, descripciones e historial Referencia de campo de asignaciones y flujo de trabajo Vincular elementos de trabajo y controles y restricciones de vinculación Controles y referencia de campo de 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 de Asignado a , elija 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 de Solicitada por , elija el nombre del miembro del equipo que llamó a la reunión.

   • En la lista de Tipo de reunión , elija el tipo de reunión utilizada para la revisión.

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

2. En la pestaña de descripción , 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 de minutos , proporcione tanto detalle como desee para describir los resultados, la descripció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 de COMENTARIOS , escriba la información diversa sobre la revisión que no se capturan correctamente en otra parte.

5. En la pestaña de *** ALUMNOS ASISTENTES *** , elija el nombre de cada asistente del miembro del equipo que sea un necesario, opcional, o real de revisión.

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

6. En la pestaña de TODOS LOS VÍNCULOS , vincule la revisión a uno o más elementos de trabajo, tales como requisitos o tareas.

7. En la pestaña de 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. Elija 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 Linking Work Items (CMMI).

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

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

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

   

2. En la lista de Tipo de vínculo , elija Relacionado u otro tipo de vínculo que represente la relación que desea seguir.

3. En la lista de Tipo de elemento de trabajo , elija 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. Elija 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. Elija Guardar elemento de trabajo.

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

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

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

   

2. En la lista de Tipo de vínculo , elija Relacionado u otro tipo de vínculo que represente la relación que desea seguir según el tipo de elemento de trabajo al que está estableciendo vínculos.

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.

   • Elija Examinar para especificar elementos de trabajo de una lista.

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

     

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

     Elija Buscar, active la casilla situada junto a cada elemento de trabajo que desee vincular al problema, y después elija Aceptar.

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

4. Elija Aceptar.

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

5. Elija 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. Elija Detalles, minutos, o pestaña de 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 Revisar referencia de campo de reuniones (CMMI) y Referencia de campo de títulos, identificadores, descripciones e historial.

2. Elija 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.

   • Elija o presione CTRL+V para pegar un archivo que haya copiado.

   • Elija Agregar, elija Examinar, y, en el cuadro de diálogo de Datos adjuntos , escriba o busque el nombre del archivo que desea adjuntar.

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

2. Elija Guardar elemento de trabajo.

Para agregar un hipervínculo a una revisión

1. En la pestaña de Todos los vínculos , elija Vincular a.

   

2. En la lista de Tipo de vínculo , elija 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. Elija Aceptar.

6. Elija 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 de Estado , elija 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. Elija 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

Revisar referencia de campo de reuniones (CMMI)

Plantilla de proceso para CMMI para Visual Studio ALM

Referencia de campos de elementos de trabajo para Visual Studio ALM

Otros recursos

Elementos de trabajo y flujo de trabajo (CMMI)