Comentando

O Requirements Portal oferece suporte a comentários dentro dos seus projetos de requisitos. Um comentário é uma nota adicionada pelo usuário, atribuída a um requisito específico, e à qual outros usuários podem responder. Os comentários promovem a colaboração entre usuários sem alterar os próprios dados compartilhados, porque os comentários são armazenados pelo Workspace de forma independente desses dados. Você pode mencionar uma ou mais pessoas ou grupos no comentário. Um comentário também pode ser atribuído a um membro do Workspace.

Os comentários são publicados, respondidos e gerenciados diretamente na tabela de requisitos usando uma janela de comentários contextual. Os comentários também são apresentados no painel Comments and Tasks, exibido no lado direito, que oferece mais uma visão geral/instrumento de navegação do que a interface operacional. Use o controle  no canto superior direito para alternar a exibição do painel Comments and Tasks.

Inserindo um Comentário

O modo de inserção de comentários pode ser acionado de uma das seguintes formas:

• Clique no botão   na parte superior do painel Comments and Tasks e, em seguida, use o cursor de inserção resultante () para selecionar uma linha de requisito para comentar.

• Clique no botão  na linha do requisito e selecione o comando Comment no menu exibido.

Em ambos os casos, será apresentada uma janela de comentários para definir o comentário no contexto do requisito escolhido. Digite seu comentário no campo fornecido. Você pode mencionar uma ou mais pessoas ou grupos no comentário. Digite o caractere @ no campo de comentário para acessar rapidamente uma lista de membros do Workspace. Um comentário também pode ser atribuído a um membro. Para mais informações sobre esses recursos adicionais, consulte a seção Working with the Contextual Commenting Window.

Com o comentário inserido, as menções adicionadas e a atribuição feita, se necessário, clique no botão   abaixo. O comentário será confirmado e aparecerá tanto na janela de comentários contextual quanto no painel Comments and Tasks.

A sequência de imagens a seguir mostra a adição de um comentário de exemplo a um requisito, junto com a adição de uma menção a um membro da equipe e a atribuição de uma tarefa a ele (veja abaixo os detalhes).

Trabalhando com a Janela de Comentários Contextual

Os pontos a seguir se referem ao trabalho com comentários e à janela de comentários contextual da interface:

• A janela de comentários pode ser acessada clicando na entrada do comentário no painel Comments and Tasks.

  

• A janela pode ser movida livremente clicando e arrastando sua barra superior.

• Use os botões no canto superior esquerdo da janela de comentários para alternar sequencialmente para os comentários anterior e seguinte, respectivamente.

  Você também pode usar Shift+Left Arrow e Shift+Right Arrow para alternar para os comentários anterior e seguinte, respectivamente.

• Depois que um comentário inicial for feito, a janela de comentários, quando acessada, estará pronta para a inserção de uma resposta. Digite seu texto no campo fornecido e depois clique no botão para confirmar. Para sair sem responder, pressione Esc.

• Você pode mencionar uma pessoa ou grupo em um comentário. Insira o caractere @ para acessar uma janela pop-up com todos os membros da equipe do Workspace. Como alternativa, pesquise o grupo ou a pessoa (esta última pelo nome ou e-mail) digitando @ seguido de um ou mais caracteres — será apresentada uma lista de grupos correspondentes, membros da equipe e pessoas fora da equipe (mas dentro da sua organização) para você escolher. Você pode clicar em uma entrada para adicioná-la ou usar as teclas Up Arrow / Down Arrow e pressionar Enter para adicionar.

  Uma pessoa mencionada que seja membro da equipe ou membro de um grupo mencionado receberá um e-mail de notificação do comentário.

  

  Você pode mencionar qualquer pessoa ou grupo em um comentário. Insira o caractere @ para acessar uma lista de todos os membros e grupos do Workspace.

  

  Como alternativa, insira @ e comece a digitar para procurar um grupo ou pessoa. A lista dinâmica inclui membros do Workspace, outras pessoas da sua organização e grupos definidos para o Workspace.

  

  Ao responder a um comentário, você também pode atribuir uma tarefa à pessoa recém-mencionada.

  

  A pessoa, pessoas ou grupos necessários aparecerão mencionados no texto do comentário (pelo nome, sempre que possível).

   

• Você pode atribuir uma tarefa a uma pessoa que tenha sido mencionada. Ative a opção Assign a Task to conforme necessário — por padrão, ela aponta para a primeira pessoa mencionada ou, se nenhuma menção for incluída, para você (Me). Como alternativa, use o menu suspenso para escolher um membro diferente do Workspace ao qual atribuir a tarefa. A pessoa atribuída é mostrada na entrada do painel Comments and Tasks como sua imagem/letra de perfil de usuário, com uma referência de tarefa associada. A atribuição da tarefa pode ser alterada ou removida ao editar o comentário.

  

  Quando uma tarefa está associada a um comentário, a borda superior da janela inclui:

  • um ícone (imagem/letra) indicando o membro ao qual a tarefa do comentário foi atribuída. Selecione o ícone para reatribuir a tarefa a outro membro do Workspace na lista suspensa.

  • a referência alfanumérica da tarefa, composta pelo identificador do requisito com um sufixo de número de tarefa. Clique na referência para fazer cross-probe até essa entrada de tarefa na página Tasks do Workspace.

    Na página Tasks do Workspace, você também pode ver e alterar a prioridade da tarefa (Medium por padrão).

  • o status de atividade atual da tarefa (To Do, In Progress, Resolved), que pode ser alterado no menu suspenso associado ().

  

• Uma tarefa pode ser adicionada a um comentário existente usando a opção Convert to Task disponível no menu  da janela. A nova tarefa é inicialmente atribuída a você e pode ser alterada para outro membro do Workspace selecionando sua entrada na lista suspensa aberta a partir do avatar do responsável (canto superior esquerdo).

  

• A janela de comentários também aceita um arquivo de imagem ou uma captura de tela copiada da área de transferência do Windows. Você pode colar a captura de tela (ou o arquivo de imagem copiado) no campo de comentário antes ou depois de quaisquer notas de texto e menções a usuários. Os gráficos da imagem são exibidos no corpo da janela de comentários — clique na imagem para abri-la e visualizá-la em tamanho real. A entrada do comentário inserido no painel Comment and Tasks incluirá uma observação includes images relacionada.

  

• Um comentário pode ser editado ou excluído, somente pela janela de comentários, usando os comandos Edit e Delete , respectivamente. Eles estão disponíveis no menu associado ao controle . Observe que esses comandos só estarão disponíveis para um comentário que você mesmo tenha feito — você não pode editar nem remover um comentário feito por outro usuário. Se você editar um comentário existente, faça suas alterações e depois clique no botão  para confirmar. Para sair sem aplicar nenhuma alteração, pressione Esc.

  Se você excluir um comentário, esteja ciente de que todas as respostas associadas também serão excluídas.

  

• Quando a janela de comentários é acessada, apenas os comentários inicial e mais recente da thread são apresentados. Para ver todos os comentários da thread, clique no controle disponível entre essas entradas. Use a barra de rolagem para navegar por todos os comentários.

  

• Um comentário pode ser resolvido (ou reativado) alternando o controle na parte superior da janela de comentários. Quando o comentário tiver uma tarefa atribuída, seu status atual poderá ser alterado para Resolved (ou outro nível) no menu suspenso de status. Comentários resolvidos não são exibidos no painel Comments and Tasks por padrão, mas podem ser mostrados por meio da opção de exibir/ocultar pins — consulte a próxima seção para mais informações.

  

Trabalhando com o Painel de Comentários

Os pontos a seguir se referem ao trabalho com comentários e ao painel Comments and Tasks da interface:

• O painel Comments and Tasks funciona como uma ferramenta de visão geral/navegação para comentários em todo o projeto, em vez de ser a interface operacional para publicar, editar e responder. Essa funcionalidade fica exclusivamente a cargo da janela contextual de comentários.

• Na parte superior do painel Comments and Tasks há controles que fornecem acesso aos controles de filtragem de tópicos, para que você possa determinar o que é apresentado no painel. Essencialmente, dois níveis de filtragem podem ser definidos. O primeiro, ou nível primário, permite controlar quais comentários de usuários são exibidos.

  

  As opções de filtro do painel restringem as entradas de comentários a:

  • Tasks only – apenas os comentários que foram atribuídos como Tarefas do usuário, que por sua vez estão disponíveis no fluxo da página Tasks.

  • Assigned to – apenas comentários atribuídos às seleções de usuários listadas abaixo. Quando a caixa de seleção de um usuário é marcada, o painel (e o documento exibido) incluirá apenas os comentários que tenham tarefas atribuídas a esse usuário. Observe que o usuário atualmente conectado é incluído no topo da lista, independentemente de quaisquer atribuições de tarefas de comentários.

  O nível secundário de filtragem, que é aplicado em conjunto com o método de filtragem primário, oferece duas opções que permitem ocultar todos os comentários ou tarefas resolvidos (Unresolved only ativado) e/ou mostrar apenas os comentários do contexto selecionado no momento (isto é, pasta, especificação ou seção), em vez do projeto inteiro (Current context only ativado).

  

• Clique na entrada Notification Settings (na parte inferior da janela de opções acima) para acessar uma janela na qual você pode configurar para quais comentários do projeto receberá notificações por e-mail. Escolha receber notificações para todos os tópicos de comentários, para nenhum tópico de comentários ou apenas para aqueles nos quais você está envolvido (você iniciou, respondeu ou foi mencionado).

  

• Quanto à ordenação dos tópicos de comentários no painel, novamente há dois níveis. Primeiro, os comentários são ordenados pela especificação em que estão, e isso segue a mesma ordenação da estrutura Requirements na árvore do projeto à esquerda. Em segundo lugar, para cada requisito, os comentários são ordenados pela data de criação — em ordem decrescente.

• Ao clicar em uma entrada de tópico de comentário no painel, esse comentário será aberto na janela contextual de comentários. A entrada do comentário no painel Comments and Tasks também é destacada em azul. Se você clicar em um comentário que não esteja na especificação visualizada no momento, será levado até essa especificação onde ele se encontra.

  

• Cada entrada de comentário no painel fornece um resumo das principais informações relacionadas a esse comentário, conforme mostrado no exemplo abaixo.