Comentários

O Requirements Portal permite adicionar comentários aos seus projetos de requisitos. Um comentário é uma nota adicionada por um usuário e vinculada a um requisito, especificação, seção, atividade de V&V ou bloco específico, à qual outros usuários podem responder. Os comentários promovem a colaboração entre os usuários sem alterar os próprios dados compartilhados, pois 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 e na árvore do projeto por meio de uma janela contextual de comentários. Os comentários também são exibidos no painel Comments and Tasks, localizado à direita, que funciona mais como uma ferramenta de visão geral e navegação do que como uma interface operacional. Use o controle  no canto superior direito para mostrar ou ocultar o painel Comments and Tasks.

Adição de um comentário

O modo de adição de comentários pode ser ativado de uma das seguintes maneiras:

  • Clique no botão  na parte superior do painel Comments and Tasks e use o cursor de posicionamento exibido () para selecionar uma linha de requisito na tabela ou uma especificação, seção, atividade de V&V ou bloco na árvore do projeto à esquerda para comentar ().

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

  • Clique com o botão direito do mouse na entrada da especificação, seção, atividade de V&V ou bloco na árvore do projeto à esquerda e selecione o comando Comment no menu de contexto ().

Em todos os casos, será exibida uma janela de comentários, na qual você poderá definir o comentário no contexto da entidade escolhida. Digite seu comentário no campo disponível. 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 obter mais informações sobre esses recursos adicionais, consulte a seção Como trabalhar com a janela contextual de comentários.

Após inserir o comentário, adicionar as menções e fazer a atribuição, se necessário, clique no botão  abaixo. O comentário será salvo e aparecerá tanto na janela contextual de comentários quanto no painel Comments and Tasks. Um marcador de comentário () será exibido na coluna Identifier para um requisito com comentário.

A qualquer momento antes da publicação, você pode sair do modo de adição de comentários pressionando Esc.

É possível adicionar qualquer quantidade de comentários a uma entidade. O número ao lado do marcador de comentário na coluna Identifier indica a quantidade de comentários adicionados à entidade.

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

Abra ou feche o painel Comments and Tasks usando o ícone . 

Selecione o botão para adicionar um comentário a um requisito e use o cursor de posicionamento exibido () para selecionar uma linha de requisito para comentar.

Insira o texto do comentário na janela de comentários e, opcionalmente, uma menção a um usuário. Digite o caractere @ para acessar uma lista de membros e grupos do Workspace que podem ser mencionados.

Marque a opção Assign a task para criar uma tarefa (solicitação de trabalho) para o usuário mencionado ou para outro usuário selecionado na lista suspensa associada.

Clique no botão  para confirmar a adição do comentário e, caso tenha sido atribuída, a criação de uma tarefa associada.

A entrada do comentário é adicionada ao painel Comments and Tasks. A janela de comentários, que pode ser aberta a qualquer momento, permite adicionar novos comentários, menções e atribuições ou atualizar o status da tarefa. Um marcador de comentário será exibido na coluna Identifier do requisito comentado.

 

Como trabalhar com a janela contextual de comentários

Os pontos a seguir se referem ao trabalho com comentários e à janela contextual de comentários 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 navegar sequencialmente até os comentários anteriores e seguintes, respectivamente.

    Você também pode usar Shift+Left Arrow e Shift+Right Arrow para navegar até os comentários anteriores e seguintes, respectivamente.

  • Após a criação de um comentário inicial, a janela de comentários, quando acessada, estará pronta para a inserção de uma resposta. Digite seu texto no campo disponível e clique no botão para salvá-lo. Para sair sem responder, pressione Esc.

  • Você pode mencionar uma pessoa ou um grupo em um comentário. Digite o caractere @ para acessar uma lista 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á exibida uma lista de grupos, membros da equipe e pessoas externas à equipe (mas pertencentes à sua organização) que correspondem à pesquisa, para você escolher. Você pode clicar em uma entrada para adicioná-la ou usar as teclas Up Arrow / Down Arrow e pressionar Enter para adicioná-la.

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

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

    Como alternativa, insira @ e comece a digitar para pesquisar um grupo ou uma 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, as pessoas ou os grupos desejados 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. Para isso, habilite a opção Assign a Task to. Por padrão, a tarefa é atribuída à primeira pessoa mencionada ou, se não houver menções, a você (Me). Como alternativa, use o menu suspenso para escolher outro membro do Workspace a quem atribuir a tarefa. A pessoa responsável é exibida na entrada do painel Comments and Tasks por meio da imagem ou letra do seu perfil de usuário, com uma referência à tarefa associada. A atribuição da tarefa pode ser alterada ou removida ao editar o comentário.

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

    • um ícone (imagem/letra) que indica 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 da entidade com o número da tarefa como sufixo. Clique na referência para navegar até a entrada dessa tarefa na página de tarefas do Workspace.

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

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

  • É possível adicionar uma tarefa 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 reatribuída a outro membro do Workspace selecionando-o na lista suspensa aberta a partir do avatar do responsável (no canto superior esquerdo).

  • A janela de comentários também aceita um arquivo de imagem ou uma captura de tela colada 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 qualquer anotação de texto e menção a usuários. A imagem é exibida no corpo da janela de comentários — clique nela para abri-la em tamanho original. 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 comentários feitos por você — não é possível editar nem remover comentários feitos por outro usuário. Se você editar um comentário existente, faça as alterações e clique no botão  para confirmá-las. Para sair sem aplicar alterações, pressione Esc.

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

  • Quando a janela de comentários é acessada, apenas o comentário inicial e o mais recente da discussão são apresentados. Para ver todos os comentários da discussão, clique no controle disponível entre essas entradas. Use a barra de rolagem para percorrer 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 tem uma tarefa atribuída, seu status atual pode ser alterado para Resolved (ou outro nível) no menu suspenso de status. Por padrão, os comentários resolvidos não são exibidos no painel Comments and Tasks, mas podem ser exibidos por meio da opção de mostrar/ocultar marcadores — consulte a próxima seção para obter mais informações.

Como trabalhar com o painel de comentários

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

  • O painel Comments and Tasks oferece uma visão geral dos comentários do projeto e uma ferramenta de navegação entre eles, em vez de uma interface operacional para publicar, editar e responder. Essa funcionalidade é exclusiva da janela contextual de comentários.

  • O painel Comments and Tasks também pode ser aberto clicando em um marcador de comentário na área principal de visualização. Isso também abrirá a janela contextual de comentários.

  • Use o controle no canto superior direito do painel para exibir os marcadores de comentários na tabela de requisitos () ou ocultá-los ().

     
  • Na parte superior do painel Comments and Tasks, há controles que dão acesso aos filtros de discussões, permitindo definir o que é apresentado no painel. Essencialmente, é possível definir dois níveis de filtragem. 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 – somente os comentários que foram atribuídos como tarefas de usuários, os quais, por sua vez, estão disponíveis no fluxo da página de tarefas.

    • Assigned to – somente os comentários atribuídos aos usuários selecionados na lista abaixo. Quando a caixa de seleção de um usuário é marcada, o painel (e o documento exibido) incluirá apenas os comentários cujas tarefas foram atribuídas a esse usuário. Observe que o usuário conectado no momento aparece no topo da lista, independentemente de haver tarefas de comentários atribuídas a ele.

    O nível secundário de filtragem, 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, seção, atividade de V&V ou bloco), em vez de todo o projeto (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 sobre quais comentários do projeto receberá notificações por e-mail. Escolha receber notificações de todas as discussões de comentários, de nenhuma discussão ou apenas daquelas em que você está envolvido (que você iniciou, às quais respondeu ou nas quais foi mencionado).

  • Quanto à ordenação das discussões de comentários no painel, também há dois níveis. Primeiro, os comentários são ordenados pelas entidades em que estão localizados, seguindo a mesma ordem da estrutura do projeto na árvore à esquerda. Em seguida, para cada entidade, os comentários são ordenados pela data de criação — em ordem decrescente.

  • Ao clicar em uma entrada de discussão de comentários 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 será destacada em azul. Se você clicar em um comentário que não esteja na entidade visualizada no momento, será direcionado à entidade em que ele está localizado.

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

AI-LocalizedLocalizado por IA
Caso encontre um problema, selecione o texto/imagem e primaCtrl + Enterpara nos enviar o seu feedback.
Contents
Disponibilidade de Recursos

Os recursos disponíveis para você dependem de qual solução Altium você possui – Altium Develop, Altium Agile Teams, Altium Agile Enterprise ou Altium Designer (com assinatura ativa).

Se você não vir um recurso documentado no software que está usando no momento, entre em contato com a equipe de vendas da Altium para saber mais.

Contents