Комментирование

Requirements Portal поддерживает комментирование внутри проектов требований. Комментарий — это добавленная пользователем заметка, назначенная конкретному требованию; на нее могут отвечать другие пользователи. Комментарии способствуют совместной работе пользователей, не изменяя сами общие данные, поскольку комментарии хранятся в Workspace независимо от этих данных. В комментарии можно упомянуть одного или нескольких людей либо групп. Комментарий также может быть назначен участнику Workspace.

Комментарии публикуются, на них отвечают и управляют ими непосредственно в таблице требований с помощью контекстного окна комментариев. Комментарии также отображаются на панели Comments and Tasks, которая расположена справа и служит скорее для обзора/навигации, чем как рабочий интерфейс. Используйте элемент управления  в правом верхнем углу, чтобы переключать отображение панели Comments and Tasks.

Размещение комментария

В режим размещения комментария можно перейти одним из следующих способов:

• Нажмите кнопку в верхней части панели Comments and Tasks, затем используйте появившийся курсор размещения (), чтобы выбрать строку требования для комментирования.

• Нажмите кнопку  в строке требования и выберите команду Comment в появившемся меню.

В обоих случаях откроется окно комментария, в котором можно задать комментарий в контексте выбранного требования. Введите комментарий в предусмотренное поле. В комментарии можно упомянуть одного или нескольких людей либо групп. Введите символ @ в поле комментария, чтобы быстро получить доступ к списку участников Workspace. Комментарий также может быть назначен участнику. Дополнительные сведения об этих возможностях см. в разделе Работа с контекстным окном комментариев.

После ввода комментария, добавления упоминаний и, при необходимости, назначения нажмите расположенную ниже кнопку  . Комментарий будет сохранен и появится как в контекстном окне комментариев, так и на панели Comments and Tasks.

На следующей последовательности изображений показано добавление примера комментария к требованию, а также добавление упоминания участника команды и назначение ему задачи (подробности см. ниже).

Работа с контекстным окном комментариев

Следующие пункты относятся к работе с комментариями и контекстным окном комментариев интерфейса:

• Окно комментариев можно открыть, щелкнув запись комментария на панели Comments and Tasks.

  

• Окно можно свободно перемещать, щелкая и перетаскивая его верхнюю панель.

• Используйте кнопки в левом верхнем углу окна комментариев, чтобы последовательно переходить соответственно к предыдущим и следующим комментариям.

  Также можно использовать Shift+Left Arrow и Shift+Right Arrow для перехода соответственно к предыдущему и следующему комментариям.

• После создания исходного комментария окно комментариев при открытии будет готово для ввода ответа. Введите текст в предусмотренное поле, затем нажмите кнопку , чтобы сохранить его. Чтобы выйти без ответа, нажмите Esc.

• В комментарии можно упомянуть человека или группу. Введите символ @, чтобы открыть всплывающий список всех участников команды Workspace. Либо выполните поиск группы или человека (для человека — по имени или адресу электронной почты), введя @ и один или несколько символов — будет показан список подходящих групп, участников команды и людей вне команды (но в пределах вашей организации), из которого можно сделать выбор. Можно либо щелкнуть запись, чтобы добавить ее, либо использовать клавиши Up Arrow / Down Arrow и нажать Enter , чтобы добавить.

  Упомянутый человек, который является либо участником команды, либо участником упомянутой группы, получит уведомление о комментарии по электронной почте.

  

  В комментарии можно упомянуть любого человека или группу. Введите символ @, чтобы получить доступ к списку всех участников и групп Workspace.

  

  Либо введите @ и начните печатать для поиска группы или человека. Динамический список включает участников Workspace, других людей в вашей организации и группы, определенные для Workspace.

  

  При ответе на комментарий вы также можете назначить задачу вновь упомянутому человеку.

  

  Нужный человек, люди или группы будут отображены как упоминания в тексте комментария (по возможности — по имени).

   

• Вы можете назначить задачу человеку, который был упомянут. Для этого включите параметр Assign a Task to — по умолчанию будет выбран первый упомянутый человек или, если упоминаний нет, вы сами (Me). Либо используйте раскрывающееся меню, чтобы выбрать другого участника Workspace для назначения задачи. Назначенный человек отображается в записи на панели Comments and Tasks в виде изображения/буквы его профиля пользователя вместе со связанной ссылкой на задачу. Назначение задачи можно изменить или удалить при редактировании комментария.

  

  Если с комментарием связана задача, верхняя граница ее окна включает:

  • значок (изображение/букву), указывающий участника, которому назначена задача комментария. Выберите значок, чтобы переназначить задачу другому участнику Workspace из раскрывающегося списка.

  • буквенно-цифровую ссылку задачи, состоящую из идентификатора требования с суффиксом номера задачи. Щелкните ссылку, чтобы перейти к соответствующей записи задачи на странице Workspace Tasks page.

    На странице Workspace Tasks вы также можете просматривать и изменять приоритет задачи (по умолчанию Medium).

  • текущий статус активности задачи (To Do, In Progress, Resolved), который можно изменить в связанном раскрывающемся меню ().

  

• Задачу можно добавить к существующему комментарию с помощью параметра Convert to Task, доступного из меню  окна. Изначально новая задача назначается вам, но это можно изменить, выбрав другого участника Workspace из раскрывающегося списка, открываемого из аватара исполнителя (вверху слева).

  

• Окно комментариев также принимает файл изображения или снимок экрана, вставленный из буфера обмена Windows. Вы можете вставить снимок экрана (или скопированный файл изображения) в поле комментария до или после любых текстовых заметок и упоминаний пользователей. Графические изображения отображаются в теле окна комментариев — щелкните изображение, чтобы открыть его для просмотра в полном размере. Запись размещенного комментария на панели Comment and Tasks будет включать соответствующую заметку includes images.

  

• Комментарий можно редактировать или удалять только через окно комментариев с помощью команд Edit и Delete соответственно. Они доступны из меню, связанного с элементом управления . Обратите внимание, что эти команды доступны только для комментария, который создали вы сами — вы не можете редактировать или удалять комментарий, сделанный другим пользователем. Если вы редактируете существующий комментарий, внесите изменения, затем нажмите кнопку , чтобы сохранить их. Чтобы выйти без применения изменений, нажмите Esc.

  Если вы удаляете комментарий, имейте в виду, что все связанные ответы также будут удалены.

  

• При открытии окна комментариев отображаются только начальный и последний комментарии в цепочке. Чтобы увидеть все комментарии в цепочке, нажмите доступный элемент управления между этими записями. Используйте полосу прокрутки для просмотра всех комментариев.

  

• Комментарий можно закрыть (или снова сделать активным), переключив элемент управления в верхней части окна комментирования. Если к комментарию назначена задача, ее текущий статус можно изменить на Resolved (или другой уровень) в раскрывающемся меню статуса. Закрытые комментарии по умолчанию не отображаются на панели Comments and Tasks, но их можно показать с помощью параметра отображения/скрытия меток — подробнее см. в следующем разделе.

  

Работа с панелью Comments

Следующие пункты относятся к работе с комментариями и панелью Comments and Tasks интерфейса:

• Панель Comments and Tasks предоставляет средство обзора/навигации по комментариям в рамках проекта, а не рабочий интерфейс для публикации, редактирования и ответов. Эта функциональность доступна только в контекстном окне комментирования.

• В верхней части панели Comments and Tasks расположены элементы управления, предоставляющие доступ к настройкам фильтрации цепочек комментариев, чтобы вы могли определить, что будет показано на панели. По сути можно задать два уровня фильтрации. Первый, или основной, уровень позволяет управлять тем, какие пользовательские комментарии отображаются.

  

  Параметры фильтра панели ограничивают список комментариев следующим образом:

  • Tasks only – только теми комментариями, которым назначены пользовательские задачи, которые, в свою очередь, доступны в потоке страницы Tasks.

  • Assigned to – только комментариями, назначенными пользователям, выбранным в приведенном ниже списке. Если установлен флажок пользователя, на панели (и в отображаемом документе) будут показаны только те комментарии, к которым назначены задачи для этого пользователя. Обратите внимание, что текущий вошедший в систему пользователь всегда включается в верхнюю часть списка, независимо от назначений задач комментариев.

  Второй уровень фильтрации, применяемый совместно с основным методом фильтрации, предлагает два параметра, которые позволяют скрыть все закрытые комментарии или задачи (Unresolved only включено) и/или показывать только комментарии для текущего выбранного контекста (то есть папки, спецификации или раздела), а не для всего проекта (Current context only включено).

  

• Щелкните запись Notification Settings (в нижней части приведенного выше окна параметров), чтобы открыть окно, в котором можно настроить, по каким комментариям проекта вы будете получать уведомления по электронной почте. Можно выбрать получение уведомлений для всех цепочек комментариев, ни для одной цепочки или только для тех, в которых вы участвуете (которые вы создали, на которые ответили или в которых вас упомянули).

  

• Что касается порядка цепочек комментариев на панели, здесь также есть два уровня. Во-первых, комментарии упорядочиваются по спецификации, в которой они находятся, и этот порядок соответствует структуре Requirements в дереве проекта слева. Во-вторых, для каждого требования комментарии упорядочиваются по дате создания — в порядке убывания.

• При щелчке по записи цепочки комментариев на панели этот комментарий открывается в контекстном окне комментирования. Запись этого комментария на панели Comments and Tasks также подсвечивается синим цветом. Если щелкнуть комментарий, который находится не в просматриваемой в данный момент спецификации, вы будете перенаправлены к соответствующей спецификации.

  

• Каждая запись комментария на панели содержит сводку ключевой информации, относящейся к этому комментарию, как показано в примере ниже.