Комментирование
Краткий обзор
- Добавляйте контекстные комментарии, ответы и изображения для обсуждения проекта.
- Упоминайте участников совместной работы, назначайте или переназначайте задачи и обновляйте их статус.
- Просматривайте и фильтруйте ветки комментариев, завершайте обсуждения, редактируйте или удаляйте собственные комментарии.
Requirements Portal поддерживает комментирование в проектах требований. Комментарий — это добавленная пользователем заметка, привязанная к определенному требованию, спецификации, разделу, мероприятию по верификации и валидации (V&V) или блоку, на которую могут отвечать другие пользователи. Комментарии способствуют совместной работе пользователей, не изменяя сами общие данные, поскольку рабочее пространство хранит комментарии отдельно от этих данных. В комментарии можно упомянуть одного или нескольких пользователей либо группы. Комментарий также можно назначить участнику рабочего пространства.
Создавать комментарии, отвечать на них и управлять ими можно непосредственно в таблице требований и дереве проекта с помощью контекстного окна комментариев. Комментарии также отображаются на панели Comments and Tasks, расположенной справа и предназначенной скорее для обзора и навигации, чем для непосредственной работы с комментариями. Используйте элемент управления
в правом верхнем углу, чтобы показать или скрыть панель Comments and Tasks.
Добавление комментария
Перейти в режим добавления комментария можно одним из следующих способов:
-
Нажмите кнопку
в верхней части панели Comments and Tasks, а затем с помощью появившегося курсора размещения выберите строку требования в таблице либо спецификацию, раздел, мероприятие V&V или блок в дереве проекта слева, чтобы добавить комментарий
-
Нажмите кнопку
в строке требования и выберите команду Comment в появившемся меню
-
Щелкните правой кнопкой мыши по спецификации, разделу, мероприятию V&V или блоку в дереве проекта слева и выберите команду Comment в контекстном меню
В каждом случае откроется окно комментариев, в котором можно добавить комментарий к выбранному объекту. Введите комментарий в соответствующее поле. В комментарии можно упомянуть одного или нескольких пользователей либо группы. Введите символ @ в поле комментария, чтобы быстро открыть список участников рабочего пространства. Комментарий также можно назначить участнику. Подробнее об этих дополнительных возможностях см. в разделе Работа с контекстным окном комментариев.
После ввода комментария, добавления упоминаний и назначения при необходимости нажмите расположенную ниже кнопку
. Комментарий будет опубликован и появится как в контекстном окне комментариев, так и на панели Comments and Tasks. В столбце Identifier для требования с комментарием появится маркер комментария
Следующая последовательность изображений демонстрирует пример добавления комментария к требованию, упоминания участника команды и назначения ему задачи (подробности см. ниже).
Работа с контекстным окном комментариев
Ниже приведены особенности работы с комментариями и контекстным окном комментариев:
-
Окно комментариев можно открыть, нажав на комментарий на панели Comments and Tasks.
-
Окно можно свободно перемещать, перетаскивая его за верхнюю панель.
-
Используйте кнопки
в левом верхнем углу окна комментариев для последовательного перехода к предыдущему и следующему комментариям соответственно.
-
После добавления первого комментария при открытии окна комментариев оно будет готово для ввода ответа. Введите текст в соответствующее поле, затем нажмите кнопку
, чтобы опубликовать ответ. Чтобы выйти, не отправляя ответ, нажмите Esc. -
В комментарии можно упомянуть пользователя или группу. Введите символ
@, чтобы открыть всплывающий список всех участников команды рабочего пространства. Также можно найти группу или пользователя (по имени или адресу электронной почты), введя@и один или несколько символов. Появится список подходящих групп, участников команды и пользователей вне команды (но в пределах вашей организации), из которого можно выбрать нужный вариант. Чтобы добавить упоминание, нажмите на нужный пункт либо выберите его клавишамиUp Arrow/Down Arrowи нажмитеEnter. -
Упомянутому пользователю можно назначить задачу. Для этого установите флажок Assign a Task to: по умолчанию будет выбран первый упомянутый пользователь, а если упоминаний нет — вы сами (
Me). Также можно выбрать другого участника рабочего пространства в раскрывающемся меню. В записи на панели Comments and Tasks назначенный исполнитель отображается в виде изображения профиля или буквы вместе со ссылкой на связанную задачу. При редактировании комментария назначение задачи можно изменить или отменить.Если с комментарием связана задача, в верхней части его окна отображаются:
-
значок (изображение или буква), обозначающий участника, которому назначена задача комментария. Нажмите на значок, чтобы переназначить задачу другому участнику рабочего пространства, выбрав его из раскрывающегося списка.
-
буквенно-цифровой идентификатор задачи, состоящий из идентификатора объекта и суффикса с номером задачи. Нажмите на идентификатор, чтобы перейти к соответствующей записи задачи на странице задач рабочего пространства.
-
текущий статус задачи (To Do, In Progress, Resolved), который можно изменить в соответствующем раскрывающемся меню
-
-
Задачу можно добавить к существующему комментарию с помощью команды Convert to Task, доступной в меню
окна. Изначально новая задача назначается вам. Чтобы назначить её другому участнику рабочего пространства, выберите его в раскрывающемся списке, который открывается нажатием на аватар исполнителя (в левом верхнем углу).
-
В окно комментариев также можно вставить файл изображения или снимок экрана из буфера обмена Windows. Снимок экрана (или скопированный файл изображения) можно вставить в поле комментария до или после текстовых заметок и упоминаний пользователей. Изображение отображается в теле окна комментариев — нажмите на него, чтобы открыть в полном размере. Запись добавленного комментария на панели Comment and Tasks будет содержать соответствующую отметку includes images.
-
Комментарий можно изменить или удалить только через окно комментариев с помощью команд Edit и Delete соответственно. Они доступны в меню элемента управления
. Обратите внимание: эти команды доступны только для ваших собственных комментариев — изменить или удалить комментарий другого пользователя нельзя. При редактировании существующего комментария внесите изменения и нажмите кнопку
, чтобы сохранить их. Чтобы выйти без применения изменений, нажмите Esc.
-
При открытии окна комментариев отображаются только первый и последний комментарии ветки. Чтобы увидеть все комментарии ветки, нажмите на элемент управления между этими записями. Для просмотра всех комментариев используйте полосу прокрутки.
-
Комментарий можно отметить как решённый или снова сделать активным с помощью переключателя
в верхней части окна комментариев. Если у комментария есть назначенная задача, её текущий статус можно изменить на Resolved (или другой) в раскрывающемся меню статуса. По умолчанию решённые комментарии не отображаются на панели Comments and Tasks, но их можно отобразить с помощью параметра показа/скрытия маркеров. Подробнее см. в следующем разделе.
Работа с панелью комментариев
Ниже описаны особенности работы с комментариями и панелью Comments and Tasks интерфейса:
-
Панель Comments and Tasks служит для обзора комментариев проекта и навигации по ним, а не для их добавления, редактирования и отправки ответов. Эти действия выполняются исключительно в контекстном окне комментариев.
-
Панель Comments and Tasks также можно открыть, нажав на маркер комментария в основной области просмотра. При этом откроется и контекстное окно комментариев.
-
Используйте элемент управления в правом верхнем углу панели, чтобы отобразить маркеры комментариев в таблице требований или скрыть их
-
В верхней части панели Comments and Tasks находятся элементы управления фильтрацией веток комментариев, позволяющие задать, что будет отображаться на панели. По сути, можно настроить два уровня фильтрации. Первый, или основной, уровень позволяет выбрать, комментарии каких пользователей будут отображаться.
Параметры фильтрации панели позволяют отображать:
-
Tasks only — только комментарии, назначенные как задачи пользователей, которые также доступны в представлении страницы задач.
-
Assigned to — только комментарии с задачами, назначенными пользователям, выбранным в списке ниже. Если установлен флажок пользователя, на панели (и в отображаемом документе) будут показаны только комментарии с задачами, назначенными этому пользователю. Обратите внимание: текущий пользователь отображается в начале списка независимо от наличия назначенных ему задач комментариев.
Второй уровень фильтрации, применяемый совместно с основным, предлагает два параметра, позволяющих скрыть все решённые комментарии или задачи (включён Unresolved only) и/или показывать комментарии только для текущего выбранного контекста (папки, спецификации, раздела, мероприятия V&V или блока), а не для всего проекта (включён Current context only).
-
-
Нажмите Notification Settings (в нижней части описанного выше окна параметров), чтобы открыть окно настройки уведомлений по электронной почте о комментариях проекта. Можно получать уведомления обо всех ветках комментариев, не получать их вовсе или получать уведомления только о тех ветках, в которых вы участвуете (создали ветку, ответили в ней или были упомянуты).
-
Порядок расположения веток комментариев на панели также определяется на двух уровнях. Сначала комментарии упорядочиваются по объектам, к которым они относятся, в соответствии со структурой проекта в дереве слева. Затем внутри каждого объекта комментарии упорядочиваются по дате создания — по убыванию.
-
При нажатии на запись ветки комментариев на панели соответствующий комментарий открывается в контекстном окне комментариев. Запись комментария на панели Comments and Tasks также выделяется синим цветом. Если вы нажмёте на комментарий, относящийся не к тому объекту, который просматриваете сейчас, будет выполнен переход к объекту этого комментария.
-
Каждая запись комментария на панели содержит сводку основной информации о нём, как показано в примере ниже.

).
).
).







).





