Comentarios

Requirements Portal permite añadir comentarios en sus proyectos de requisitos. Un comentario es una nota añadida por un usuario que se asigna a un requisito, especificación, sección, actividad de V&V o bloque específicos, y a la que pueden responder otros usuarios. Los comentarios fomentan la colaboración entre usuarios sin modificar los propios datos compartidos, ya que el espacio de trabajo almacena los comentarios de forma independiente de esos datos. Puede mencionar a una o varias personas o grupos en el comentario. También se puede asignar un comentario a un miembro del espacio de trabajo.

Los comentarios se publican, responden y gestionan directamente en la tabla de requisitos y en el árbol del proyecto mediante una ventana contextual de comentarios. Los comentarios también se muestran en el panel Comments and Tasks, situado a la derecha, que sirve más como herramienta de navegación y vista general que como interfaz operativa. Utilice el control  de la esquina superior derecha para mostrar u ocultar el panel Comments and Tasks.

Añadir un comentario

Se puede acceder al modo de inserción de comentarios de una de las siguientes maneras:

• Haga clic en el botón  de la parte superior del panel Comments and Tasks y, a continuación, utilice el cursor de inserción que aparece () para seleccionar una fila de requisito en la tabla o una especificación, sección, actividad de V&V o bloque en el árbol del proyecto situado a la izquierda para añadir un comentario ().

• Haga clic en el botón  de la fila del requisito y seleccione el comando Comment en el menú que aparece ().

• Haga clic con el botón derecho en la entrada de la especificación, sección, actividad de V&V o bloque en el árbol del proyecto situado a la izquierda y seleccione el comando Comment en el menú contextual ().

En todos los casos, se mostrará una ventana de comentarios en la que podrá definir el comentario en el contexto de la entidad elegida. Escriba su comentario en el campo correspondiente. Puede mencionar a una o varias personas o grupos en el comentario. Escriba el carácter @ en el campo de comentario para acceder rápidamente a una lista de miembros del espacio de trabajo. También se puede asignar un comentario a un miembro. Para obtener más información sobre estas funciones adicionales, consulte la sección Trabajar con la ventana contextual de comentarios.

Una vez introducido el comentario, añadidas las menciones y realizada la asignación si es necesario, haga clic en el botón  situado debajo. El comentario se guardará y aparecerá tanto en la ventana contextual de comentarios como en el panel Comments and Tasks. Se mostrará un marcador de comentario () en la columna Identifier de los requisitos que tengan comentarios.

La siguiente secuencia de imágenes muestra cómo añadir un comentario de ejemplo a un requisito, mencionar a un miembro del equipo y asignarle una tarea (consulte los detalles a continuación).

Trabajar con la ventana contextual de comentarios

Los siguientes puntos se refieren al uso de los comentarios y de la ventana contextual de comentarios de la interfaz:

• Se puede acceder a la ventana de comentarios haciendo clic en la entrada del comentario en el panel Comments and Tasks.

  

• La ventana se puede mover libremente haciendo clic en su barra superior y arrastrándola.

• Utilice los botones de la esquina superior izquierda de la ventana de comentarios para pasar secuencialmente al comentario anterior y al siguiente, respectivamente.

  También puede utilizar Shift+Left Arrow y Shift+Right Arrow para pasar al comentario anterior y al siguiente, respectivamente.

• Una vez añadido un comentario inicial, al acceder a la ventana de comentarios, esta estará lista para introducir una respuesta. Escriba el texto en el campo correspondiente y, a continuación, haga clic en el botón para guardarlo. Para salir sin responder, pulse Esc.

• Puede mencionar a una persona o grupo en un comentario. Introduzca el carácter @ para acceder a una lista emergente de todos los miembros del equipo del espacio de trabajo. También puede buscar un grupo o una persona (en este último caso, por su nombre o correo electrónico) escribiendo @ seguido de uno o varios caracteres: se mostrará una lista de grupos, miembros del equipo y personas ajenas al equipo (pero pertenecientes a su organización) que coincidan con la búsqueda para que pueda elegir. Puede hacer clic en una entrada para añadirla o utilizar las teclas Up Arrow / Down Arrow y pulsar Enter para añadirla.

  Las personas mencionadas que sean miembros del equipo o que pertenezcan a un grupo mencionado recibirán una notificación del comentario por correo electrónico.

  

  Puede mencionar a cualquier persona o grupo en un comentario. Introduzca el carácter @ para acceder a una lista de todos los miembros y grupos del espacio de trabajo.

  

  También puede introducir @ y empezar a escribir para buscar un grupo o una persona. La lista dinámica incluye miembros del espacio de trabajo, otras personas de su organización y grupos definidos para el espacio de trabajo.

  

  Al responder a un comentario, también puede asignar una tarea a la persona recién mencionada.

  

  Las personas o grupos seleccionados aparecerán mencionados en el texto del comentario (por su nombre, siempre que sea posible).

   

• Puede asignar una tarea a una persona que se haya mencionado. Para ello, active la opción Assign a Task to: de forma predeterminada, se selecciona a la primera persona mencionada o, si no se incluye ninguna mención, a usted mismo (Me). También puede utilizar el menú desplegable para elegir a otro miembro del espacio de trabajo al que asignar la tarea. La persona asignada se muestra en la entrada del panel Comments and Tasks mediante la imagen o letra de su perfil de usuario, junto con una referencia a la tarea asociada. La asignación de la tarea se puede cambiar o eliminar al editar el comentario.

  

  Cuando un comentario tiene una tarea asociada, el borde superior de su ventana incluye:

  • un icono (imagen/letra) que indica el miembro al que se ha asignado la tarea del comentario. Seleccione el icono para reasignar la tarea a otro miembro del espacio de trabajo desde la lista desplegable.

  • la referencia alfanumérica de la tarea, compuesta por el identificador de la entidad con un número de tarea como sufijo. Haga clic en la referencia para ir a la entrada de esa tarea en la página Tareas del espacio de trabajo.

    Desde la página Tasks del espacio de trabajo, también puede ver y cambiar la prioridad de la tarea (Medium de forma predeterminada).

  • el estado de actividad actual de la tarea (To Do, In Progress, Resolved), que se puede cambiar desde el menú desplegable asociado ().

  

• Se puede añadir una tarea a un comentario existente mediante la opción Convert to Task disponible en el menú  de la ventana. Inicialmente, la nueva tarea se le asigna a usted y puede reasignarla a otro miembro del espacio de trabajo seleccionando su entrada en la lista desplegable que se abre desde el avatar de la persona asignada (arriba a la izquierda).

  

• La ventana de comentarios también admite archivos de imagen o capturas de pantalla pegados desde el portapapeles de Windows. Puede pegar la captura de pantalla (o el archivo de imagen copiado) en el campo de comentario antes o después de las notas de texto y las menciones a usuarios. La imagen se muestra en el cuerpo de la ventana de comentarios; haga clic en ella para abrirla y verla a tamaño completo. La entrada del comentario publicado en el panel Comment and Tasks incluirá una nota includes images relacionada.

  

• Un comentario solo se puede editar o eliminar desde la ventana de comentarios, mediante los comandos Edit y Delete , respectivamente. Estos están disponibles en el menú asociado al control . Tenga en cuenta que estos comandos solo estarán disponibles para los comentarios que haya escrito usted: no puede editar ni eliminar los comentarios de otros usuarios. Si edita un comentario existente, realice los cambios y, a continuación, haga clic en el botón  para guardarlos. Para salir sin aplicar ningún cambio, pulse Esc.

  Si elimina un comentario, tenga en cuenta que también se eliminarán todas las respuestas asociadas.

  

• Al acceder a la ventana de comentarios, solo se muestran el comentario inicial y el más reciente del hilo. Para ver todos los comentarios del hilo, haga clic en el control disponible entre estas entradas. Utilice la barra de desplazamiento para recorrer todos los comentarios.

  

• Un comentario se puede marcar como resuelto (o volver a activar) mediante el control situado en la parte superior de la ventana de comentarios. Si el comentario tiene una tarea asignada, su estado actual se puede cambiar a Resolved (u otro nivel) desde el menú desplegable de estado. Los comentarios resueltos no se muestran en el panel Comments and Tasks de forma predeterminada, pero se pueden mostrar mediante la opción para mostrar u ocultar marcadores; consulte la siguiente sección para obtener más información.

  

Trabajar con el panel Comentarios

Los siguientes puntos se refieren al trabajo con los comentarios y el panel Comments and Tasks de la interfaz:

• El panel Comments and Tasks ofrece una vista general y una herramienta de navegación por los comentarios del proyecto, en lugar de una interfaz para publicar, editar y responder. Estas funciones se realizan exclusivamente desde la ventana contextual de comentarios.

• El panel Comments and Tasks también se puede abrir haciendo clic en un marcador de comentario en el área de visualización principal. Esto también abrirá la ventana contextual de comentarios.

• Utilice el control situado en la parte superior derecha del panel para mostrar los marcadores de comentarios en la tabla de requisitos () u ocultarlos ().

  

  

   

• En la parte superior del panel Comments and Tasks hay controles que permiten acceder a los filtros de hilos para determinar qué se muestra en el panel. Básicamente, se pueden definir dos niveles de filtrado. El primer nivel, o nivel principal, permite controlar qué comentarios de usuarios se muestran.

  

  Las opciones de filtrado del panel limitan las entradas de comentarios a:

  • Tasks only – solo aquellos comentarios que se hayan asignado como tareas de usuario, que a su vez están disponibles en el flujo de la página Tareas.

  • Assigned to – solo los comentarios asignados a los usuarios seleccionados en la lista siguiente. Al seleccionar la casilla de un usuario, el panel (y el documento mostrado) incluirá únicamente los comentarios que tengan tareas asignadas a ese usuario. Tenga en cuenta que el usuario que ha iniciado sesión aparece en la parte superior de la lista, independientemente de las asignaciones de tareas de comentarios.

  El segundo nivel de filtrado, que se aplica junto con el método de filtrado principal, ofrece dos opciones que permiten ocultar todos los comentarios o tareas resueltos (Unresolved only activado) y/o mostrar únicamente los comentarios del contexto seleccionado actualmente (es decir, carpeta, especificación, sección, actividad de V&V o bloque), en lugar de los de todo el proyecto (Current context only activado).

  

• Haga clic en la entrada Notification Settings (en la parte inferior de la ventana de opciones anterior) para acceder a una ventana en la que podrá configurar para qué comentarios del proyecto recibirá notificaciones por correo electrónico. Elija si desea recibir notificaciones de todos los hilos de comentarios, de ninguno o solo de aquellos en los que participa (que haya iniciado, a los que haya respondido o en los que se le haya mencionado).

  

• En cuanto al orden de los hilos de comentarios en el panel, también hay dos niveles. En primer lugar, los comentarios se ordenan según las entidades a las que pertenecen, siguiendo el mismo orden que la estructura del proyecto en el árbol de la izquierda. En segundo lugar, dentro de cada entidad, los comentarios se ordenan por su fecha de creación, en orden descendente.

• Al hacer clic en la entrada de un hilo de comentarios en el panel, ese comentario se abrirá en la ventana contextual de comentarios. La entrada del comentario en el panel Comments and Tasks también se resaltará en azul. Si hace clic en un comentario que no pertenece a la entidad que se está visualizando, se le dirigirá a la entidad a la que pertenece.

  

• Cada entrada de comentario del panel proporciona un resumen de la información clave relacionada con ese comentario, como se muestra en el ejemplo siguiente.