Fazer Comentários Sobre Artefatos

Um comentário é um item de discussão textual associado a um artefato ou a um elemento em um artefato. Eles podem ser utilizados para fornecer feedback da equipe durante o desenvolvimento de um artefato. Os comentários são exibidos na seçãoComentários de uma barra lateral do artefato, na seção Comentários Recentes da barra lateral da página do projeto, e em Comentários Recentes para Mim no Console do Usuário.
Por Que e Quando Desempenhar Esta Tarefa

Você pode comentar sobre um artefato como um todo (utilizando comentários no nível do artefato) e sobre elementos específicos do artefato. Em documentos, você pode comentar sobre o documento inteiro (utilizando comentários no nível do documento), um parágrafo ou um item de uma lista com marcadores do documento. Eles ficam visíveis a todos os membros da equipe que possuem acesso ao artefato.

Ao criar um comentário, é possível direcioná-lo para um ou mais usuários, quando então será exibido em seus painéis. Se o seu servidor tiver notificações de e-mail configuradas, você obterá um e-mail quando forem direcionados comentários para você.

Um comentário e suas respostas são mantidos como um grupo na seção de comentários. Respostas a um comentário são indentadas sob seu comentário de nível superior. O número próximo do ícone de comentários em uma barra de ferramentas de artefatos exibe o número total de comentários no artefato. Clique no ícone para realçar os comentários no artefato ou inclua um novo comentário. Também é possível visualizar os totais dos comentários na página de projeto Artefato ao visualizar a lista de artefatos com detalhes. Você pode incluir um comentário lá sem abrir o artefato.

Ao selecionar um comentário em um artefato, seu elemento associado é selecionado no editor. Ao selecionar um elemento em um editor de artefato, seu comentário associado é selecionado na barra lateral.

Os comentários feitos em artefatos integrados ou reutilizáveis só podem ser vistos no contexto em que foram feitos. Por exemplo, se você integrar um esboço em um documento, os comentários feitos no esboço integrado no documento não poderão ser vistos ao visualizar o esboço em seu próprio editor.

A tabela a seguir descreve tarefas adicionais para gerenciamento de comentários.

Tabela 1. Controles e Tarefas Associadas na seção Comentários da Barra Lateral
Tarefa Ícone Etapas
Expandir/reduzir um comentário.   Clique na parte de cabeçalho do comentário de nível superior. O texto do comentário e suas respostas serão mostrados ou ocultados.
Expandir ou reduzir comentários. Clique nos ícones Expandir tudo e Reduzir tudo para mostrar ou ocultar o texto e as respostas de todos os comentários na seção Comentários.
Incluir ou responder a um comentário em um artefato.

Para criar um comentário que se aplique a um artefato inteiro, na seção Comentários da barra lateral, clique no ícone Comentário e clique em Criar um Novo Comentário para o Artefato. Também é possível clicar no ícone Comentários no cabeçalho do artefato e selecionar Incluir Comentário no Artefato.

Para criar um comentário associado a um elemento, selecione um elemento no editor e clique no ícone Incluir comentário acima do elemento. Um comentário também pode ser incluído em um elemento selecionado clicando-se no ícone Comentário na barra lateral. Se não houver nenhum comentário selecionado, você poderá clicar na opção para Criar um Novo Comentário para <elemento>.

Para incluir um comentário em um documento ou requisito, clique com o botão direito do mouse em um parágrafo ou item marcador e clique em Incluir comentário.

Para criar uma resposta, selecione um comentário e clique no ícone Comentário ou clique com o botão direito do mouse no comentário e clique em Responder a <comentário>.

Realçar elementos ou parágrafos no editor que possuírem comentários associados.

Selecione esse ícone para realçar todos os elementos no editor de artefato que possuírem comentários. Ao trabalhar com um documento, todos os parágrafos que contêm comentários são realçados.

O número de comentários associados a cada elemento ou parágrafo também é mostrado no editor; esse número é ajustado dependendo das configurações do filtro da seção Comentários da barra lateral.

Selecione o ícone novamente para remover o realce.

Filtrar os comentários nesta visualização.

Clique no ícone Filtrar para limitar a exibição apenas aos comentários que incluírem ou corresponderem a seus critérios.

Os critérios de filtragem incluem prioridade, autor do comentário (Por), destinatário desejado para o comentário (Para), estado de resolução (apenas não-resolvido, por padrão) e um intervalo de data apenas para comentários recentes.

Clique no ícone Filtrar para reduzir a seção de filtro. Reduzir a seção Filtrar não limpa as condições de filtragem; apenas os comentários que correspondem aos critérios de filtragem são exibidos.

Clique em Limpar filtros para mostrar todos os comentários.

Resolver um comentário, indicando que o comentário não requer ação adicional ou resposta. Para resolver um comentário, selecione o comentário e clique no ícone Comentário ou clique com o botão direito do mouse no comentário e selecione Resolver Comentário. Comentários resolvidos são exibidos com texto cinza claro. Após um comentário ser resolvido, você pode reabri-lo e respondê-lo.
Editar um comentário. Para editar um comentário, selecione o comentário e clique no ícone Comentário ou clique com o botão direito do mouse no comentário e selecione Editar Comentário. Um comentário só pode ser editado pelo usuário que o criou.
Visualizar o texto integral do comentário.   Comentários longos são truncados na visualização Comentários. Para ver o texto completo, basta passar o mouse sobre o comentário.
Classificar e agrupar comentários. Clique no ícone Classificar e Agrupar na seção Comentários para acessar as opções de classificação e agrupamento. O Autor refere-se ao originador do comentário original. A Data refere-se à data da última atividade para o comentário, incluindo respostas.
Exibir a seção Comentários Recentes na barra lateral da página de projeto.   Abra um projeto utilizando o botão Abrir na barra de ferramentas do editor. Expanda a barra lateral na página de projeto clicando na seta no lado superior direito. Expanda a barra lateral da seção Comentários Recentes.
Exibir a seção Comentários Recentes para Mim na barra lateral da página de projeto.   Abra o seu Console utilizando o botão Abrir na barra de ferramentas do editor. Os comentários recentemente direcionados a você são exibidos na seção Comentários Recentes para Mim.
Excluir comentários.   Os comentários nunca são excluídos, mesmo se o elemento associado for excluído. Esses comentários são agora marcados com "(elemento não nesta revisão) no título do comentário. Esses comentários podem ser ocultados na seção de comentários usando a opção (Ocultar comentários em elementos órfãos) no painel do filtro.

Feedback