Comentarios

Requirements Portal admite comentarios dentro de sus proyectos de requisitos. Un comentario es una nota añadida por un usuario que se asigna a un requisito específico y a la que otros usuarios pueden responder. Los comentarios fomentan la colaboración entre usuarios sin alterar los datos compartidos en sí, porque los comentarios son almacenados por el Workspace de forma independiente de esos datos. Puede mencionar a una o más personas o grupos en el comentario. Un comentario también puede asignarse a un miembro del Workspace.

Los comentarios se publican, responden y administran directamente dentro de la tabla de requisitos mediante una ventana contextual de comentarios. Los comentarios también se presentan en el panel Comments and Tasks, que se muestra en el lado derecho y proporciona más bien una vista general/instrumento de navegación, en lugar de la interfaz operativa. Use el control  de la parte superior derecha para alternar la visualización del panel Comments and Tasks.

Colocación de un comentario

Se puede entrar en el modo de colocación de comentarios de una de las siguientes maneras:

• Haga clic en el botón  en la parte superior del panel Comments and Tasks y luego use el cursor de colocación resultante () para seleccionar una línea de requisito para comentar.

• Haga clic en el botón  en la línea del requisito y seleccione el comando Comentar en el menú que aparece.

En cada caso, se mostrará una ventana de comentarios con la que podrá definir el comentario en contexto con el requisito elegido. Escriba su comentario en el campo proporcionado. Puede mencionar a una o más 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 Workspace. Un comentario también puede asignarse a un miembro. Para obtener más información sobre estas funciones adicionales, consulte la sección Trabajo con la ventana contextual de comentarios.

Con el comentario introducido, las menciones añadidas y la asignación realizada si es necesario, haga clic en el botón  de abajo. El comentario se confirmará y aparecerá tanto en la ventana contextual de comentarios como en el panel Comments and Tasks.

La siguiente secuencia de imágenes muestra la adición de un comentario de ejemplo a un requisito, junto con la adición de una mención a un miembro del equipo y la asignación de una tarea a dicho miembro (consulte más abajo para ver los detalles).

Trabajo con la ventana contextual de comentarios

Los siguientes puntos se refieren al trabajo con comentarios y a 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 puede moverse libremente haciendo clic y arrastrando su barra superior.

• Use los botones en la parte superior izquierda de la ventana de comentarios para desplazarse secuencialmente al comentario anterior y al siguiente, respectivamente.

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

• Una vez realizado un comentario inicial, la ventana de comentarios, al acceder a ella, estará lista para introducir una respuesta. Escriba su texto en el campo proporcionado y luego haga clic en el botón para confirmar. Para salir sin responder, pulse Esc.

• Puede mencionar a una persona o grupo dentro de un comentario. Introduzca el carácter @ para acceder a una ventana emergente que enumera a todos los miembros del equipo del Workspace. Como alternativa, busque el grupo o la persona (esta última por su nombre o correo electrónico) escribiendo @ seguido de uno o más caracteres; se mostrará una lista de grupos coincidentes, miembros del equipo y personas fuera del equipo (pero dentro de su organización) entre los que podrá elegir. Puede hacer clic en una entrada para añadirla o usar las teclas Up Arrow / Down Arrow y pulsar Enter para añadirla.

  Una persona mencionada que sea miembro del equipo o miembro de un grupo mencionado recibirá un correo electrónico de notificación del comentario.

  

  Puede mencionar a cualquier persona o grupo dentro de un comentario. Introduzca el carácter @ para acceder a un listado de todos los miembros y grupos del Workspace.

  

  Como alternativa, introduzca @ y comience a escribir para buscar un grupo o una persona. El listado dinámico incluye miembros del Workspace, otras personas de su organización y grupos definidos para el Workspace.

  

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

  

  La persona, personas o grupos necesarios aparecerán mencionados en el texto del comentario (por su nombre cuando sea posible).

   

• Puede asignar una tarea a una persona que haya sido mencionada. Active la opción Assign a Task to según corresponda; de forma predeterminada, se asigna a la primera persona mencionada o, si no se incluye ninguna mención, a usted mismo (Me). Como alternativa, use el menú desplegable para elegir otro miembro del Workspace al que asignar la tarea. La persona asignada se muestra en la entrada del panel Comments and Tasks como su imagen/letra de perfil de usuario, con una referencia de tarea asociada. La asignación de la tarea puede cambiarse o eliminarse al editar el comentario.

  

  Cuando una tarea está asociada a un comentario, 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 Workspace desde la lista desplegable.

  • la referencia alfanumérica de la tarea, compuesta por el identificador del requisito con un sufijo de número de tarea. Haga clic en la referencia para realizar una referencia cruzada a esa entrada de tarea en la página Tasks page del Workspace.

    Desde la página Tasks del Workspace, 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 puede cambiarse desde el menú desplegable asociado ().

  

• Se puede añadir una tarea a un comentario existente usando la opción Convert to Task disponible en el menú  de la ventana. La nueva tarea se le asigna inicialmente a usted y puede cambiarse a otro miembro del Workspace seleccionando su entrada en la lista desplegable abierta desde el avatar del asignado (arriba a la izquierda).

  

• La ventana de comentarios también aceptará un archivo de imagen o una captura de pantalla copiada 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 cualquier nota de texto y mención de usuario. Los gráficos de la imagen se muestran en el cuerpo de la ventana de comentarios; haga clic en la imagen para abrirla y verla a tamaño completo. La entrada del comentario colocado en el panel Comment and Tasks incluirá una nota relacionada includes images.

  

• Un comentario puede editarse o eliminarse, únicamente a través de la ventana de comentarios, usando 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 un comentario que haya realizado usted mismo; no puede editar ni eliminar un comentario hecho por otro usuario. Si edita un comentario existente, realice sus cambios y luego haga clic en el botón  para confirmarlos. 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.

  

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

  

• Un comentario puede resolverse (o volver a activarse) alternando el control en la parte superior de la ventana de comentarios. Cuando el comentario tiene una tarea asignada, su estado actual puede cambiarse 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 pueden hacerse visibles mediante su opción de mostrar/ocultar marcadores; consulte la siguiente sección para obtener más información.

  

Trabajar con el panel de comentarios

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

• El panel Comments and Tasks facilita una herramienta de vista general/navegación para los comentarios en todo el proyecto, en lugar de ser la interfaz operativa para publicar, editar y responder. Esa funcionalidad se deja exclusivamente a la ventana contextual de comentarios.

• En la parte superior del panel Comments and Tasks hay controles que proporcionan acceso a los controles de filtrado de hilos, para que pueda determinar qué se presenta en el panel. Básicamente pueden definirse dos niveles de filtrado. El primero, o nivel principal, le permite controlar qué comentarios de usuario se muestran.

  

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

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

  • Assigned to – solo comentarios asignados a las selecciones de usuario que se enumeran a continuación. Cuando se selecciona la casilla de un usuario, el panel (y el documento mostrado) incluirá solo aquellos comentarios que tengan tareas asignadas a ese usuario. Tenga en cuenta que el usuario que ha iniciado sesión actualmente se incluye en la parte superior de la lista, independientemente de cualquier asignación de tareas de comentario.

  El nivel secundario de filtrado, que se aplica junto con el método de filtrado principal, ofrece dos opciones que le permiten ocultar todos los comentarios o tareas resueltos (Unresolved only habilitado) y/o mostrar solo comentarios para el contexto actualmente seleccionado (es decir, carpeta, especificación o sección) en lugar de todo el proyecto (Current context only habilitado).

  

• Haga clic en la entrada Notification Settings (en la parte inferior de la ventana de opciones anterior) para acceder a una ventana con la que configurar qué comentarios del proyecto le enviarán notificaciones por correo electrónico. Elija recibir notificaciones para todos los hilos de comentarios, para ningún hilo de comentarios o solo para aquellos en los que participa (los que inició, respondió o en los que ha sido mencionado).

  

• En cuanto al orden de los hilos de comentarios en el panel, nuevamente, hay dos niveles. En primer lugar, los comentarios se ordenan por la especificación en la que se encuentran, y esto sigue el mismo orden que la estructura Requirements en el árbol del proyecto de la izquierda. En segundo lugar, para cada requisito, los comentarios se ordenan por fecha de creación, en orden descendente.

• Al hacer clic en una entrada de hilo de comentario 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 resalta en azul. Si hace clic en un comentario que no se encuentra en la especificación que se está viendo actualmente, se le llevará a esa especificación correspondiente.

  

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