Um problema no Issue Tracker do Google é um relatório de bug, uma solicitação de recurso, uma solicitação de mudança ou um item do fluxo de trabalho do processo que um usuário quer rastrear ou espera que outro usuário ou equipe rastreie. Os problemas são organizados em componentes, e cada um deles contém um grupo de problemas relacionados. Cada problema no Issue Tracker tem uma página de detalhes própria em que os usuários rastreiam a atividade relacionada ao problema e onde fazem comentários e atualizar os dados do problema.
Campos do problema
Cada problema tem um conjunto de campos associados que o descreve e o estado atual dele. Isso inclui o tipo de problema, a importância dele em termos de gravidade e prioridade, além do registro da atividade relacionada ao problema. Alguns campos são comuns a todos os problemas. O Issue Tracker também oferece suporte a campos personalizados que estão disponíveis somente quando um problema está associado a um componente específico. Para todos os novos problemas, há vários campos obrigatórios. Isso inclui Component, Title, Priority e Type. Alguns componentes também têm campos personalizados obrigatórios.
Na página de detalhes de um problema, a maioria dos campos está à direita da página, no painel Campos do problema. Há alguns campos adicionais na bandeja Problemas relacionados, perto da parte superior da página. Quase todos os campos podem ser editados no Issue Tracker clicando no link, na lista suspensa ou no ícone de lápis associado a eles. Quando você passa o cursor sobre um campo, o Issue Tracker mostra informações breves sobre ele no texto do mouse.
Veja uma descrição dos campos de problemas padrão em Glossário de campos.
Tipo de problema
O campo Tipo permite categorizar problemas em um componente em um dos vários grupos comuns. Este campo é obrigatório. A tabela a seguir mostra os tipos de problemas possíveis:
| Tipo de problema | Descrição |
|---|---|
| Bug | O comportamento é contra o que deveria ocorrer ou foi documentado para acontecer, ou o produto não funciona como esperado. |
| Solicitação de recurso | O produto funciona conforme o esperado, mas pode ser melhorado com as mudanças especificadas. |
| Problema do cliente | O problema afeta terceiros e pode não ser reproduzido pela pessoa que o informou. Esse problema pode ser apenas uma questão de solução de problemas ou treinamento, mas pode acabar sendo um bug ou uma solicitação de recurso. |
| Limpeza interna | o problema não tem efeito externo no comportamento de um produto, mas abordar o problema permitiria uma interação mais simplificada ou intuitiva durante o desenvolvimento do produto. Você também pode usar esse tipo para rastrear problemas de manutenção. |
| Processo | Processo é uma categoria diversa que tem usos variados dependendo do projeto. Por exemplo, é possível usar esse tipo para problemas gerados por uma API ou para acompanhar tarefas administrativas. |
| Vulnerabilidade | Vulnerabilidades de privacidade e segurança sujeitas a SLOs definidos pelas diretrizes de privacidade e segurança do Google. Somente leitura até depois de 01/11/2017. |
| Projeto | É um esforço orientado por metas com início e fim finitos, com foco na criação de um produto, serviço ou resultado exclusivo. |
| Marco | Uma coleção de trabalhos que representa uma conquista importante no caminho para a conclusão de um projeto. Os marcos também podem ser usados para representar lançamentos ou lançamentos. |
| Recurso | Uma coleção de trabalhos que fornece um valor específico para o usuário. |
| Épico | Uma grande coleção de trabalhos voltados a um objetivo comum. |
| Matéria | Uma pequena coleção de trabalhos que fornece um valor específico para o usuário. |
| Tarefa | Uma pequena unidade de trabalho. |
Prioridade do problema
O campo Prioridade permite especificar a importância de um problema. Esse campo é obrigatório. As equipes geralmente têm critérios diferentes para a determinação da importância de um problema. A tabela a seguir mostra uma maneira comum de priorizar problemas:
| Prioridade do problema | Descrição |
|---|---|
| P0 | É um problema que precisa ser resolvido imediatamente e com o máximo de recursos necessário. Esse problema causa uma interrupção completa ou faz com que uma função essencial do produto fique indisponível para todos, sem uma solução alternativa conhecida. |
| P1 | Um problema que precisa ser resolvido rapidamente. Esse problema afeta significativamente uma grande porcentagem de usuários. Se houver uma solução alternativa, isso será parcial ou muito complicado. O impacto do problema é em uma função organizacional central ou impede fundamentalmente outra equipe. |
| P2 | Um problema que precisa ser resolvido em uma escala de tempo razoável. Esses problemas podem ser: 1) um problema que seria P0 ou P1, mas com uma solução razoável; 2) um problema que é importante para uma grande porcentagem de usuários e está conectado às principais funções organizacionais; 3) um problema que impede o trabalho de outras equipes e não tem uma solução alternativa razoável. A P2 é muito importante para problemas no primeiro uso ou na instalação e é o nível de prioridade padrão. |
| P3 | Um problema que deve ser resolvido quando possível. Esse problema é relevante para as principais funções organizacionais ou para o trabalho de outras equipes, mas não impede o progresso nem tem uma solução razoável. |
| P4 | Um problema que deve ser resolvido em algum momento. Esse problema não é relevante para as principais funções organizacionais ou para o trabalho de outras equipes, ou então está relacionado apenas à atratividade ou agradável do sistema. |
Status do problema
O campo Status permite especificar o status de um problema no processo de resolução. As equipes geralmente têm definições diferentes sobre quais atividades precisam ocorrer para que um problema mude de status ou seja resolvido. Nem todos os valores do campo Status precisam ser usados para rastrear a resolução de um problema. A tabela a seguir mostra formas comuns de usar o campo Status:
| Status do problema | Descrição |
|---|---|
| Novo | O problema não foi atribuído a uma pessoa ou um grupo. |
| Atribuído | O problema está atribuído a uma pessoa. essa pessoa aparece no campo Responsável; |
| Em andamento (aceito) | O usuário reconheceu o problema e começou a trabalhar nele. |
| Corrigida | O problema foi resolvido. |
| Corrigido (verificado) | O problema foi resolvido, e a exatidão da correção foi confirmada pelo usuário no campo Verificador. |
| Sem correção (não reproduzível) | Não há informações suficientes para corrigir o problema ou ele não pode ser recriado. |
| Não corrigido (comportamento pretendido) | O problema descreve o comportamento esperado do produto nas circunstâncias informadas. |
| Não corrigido (obsoleto) | O problema não é mais relevante devido a mudanças no produto. |
| Não corrigido (inviável) | As alterações necessárias para resolver o problema não são viáveis. |
| Duplicar | O problema já foi informado em outro lugar. Para definir o status de um problema como Duplicar, consulte Duplicar um problema. |
O Issue Tracker considera os problemas como Abertos ou Fechados, dependendo do status. Problemas abertos são aqueles que estão aguardando resolução. Isso inclui qualquer problema com um status Novo, Atribuído ou Em andamento. Problemas fechados são aqueles que não exigem mais ações, exceto possivelmente verificação. Isso inclui qualquer problema com um status Corrigido, Não corrigido ou Duplicado.
Ícones de status
Os ícones de status são uma representação visual do status de um problema. Um ícone de status aparece à esquerda do problema que está na lista suspensa Bloqueado por ou Bloqueio de outro problema. Esses ícones oferecem uma maneira rápida de avaliar o progresso de um problema bloqueado ou de bloqueio sem precisar sair da página atual. Também é possível definir a coluna Status de uma página de resultados da pesquisa para mostrar ícones em vez de texto.
Mudança rápida de status
Há duas maneiras de mudar rapidamente o status de um problema para avançar para a próxima etapa típica no processo de resolução. O primeiro é o botão Alterar status, localizado na barra de apps, na parte de cima da página de detalhes do problema, e o link Alterar status no painel Campos do problema, à direita da página. Clique em um deles para avançar o status do problema da seguinte maneira:
Se o problema for novo e não estiver atribuído, ou se o usuário atribuído não for você, a solicitação de mudança rápida será Atribuir a mim. A mudança rápida do status define o responsável por você e, se definido de outra forma, muda o status do problema para Atribuído.
Se você for a pessoa responsável por um problema e o status dele for Atribuído, a solicitação de mudança rápida será Iniciar o trabalho. A mudança rápida muda o status do problema para Em andamento.
Se você for a pessoa responsável por um problema e o status dele for Em andamento, a solicitação de mudança rápida será Marcar como corrigido. A mudança rápida muda o status do problema para Fixed.
Se o status de um problema for Corrigido e você for o verificador, a solicitação de mudança rápida será Verificar. A mudança rápida muda o status do problema para Corrigido (verificado).
Se um problema tiver o status Corrigido, Duplicado ou Não foi corrigido, a solicitação de alteração rápida será Reabrir, exceto no caso mencionado acima. A mudança rápida muda o status para Novo, se o problema não tiver um responsável, ou Atribuído, se o problema tiver um responsável.
Cartões de visita com problemas
Um cartão de informações do problema contém informações como título, ID, descrição e status atual de um problema. Além disso, ele contém um botão CC Me que adiciona você à lista de CC do problema. Se você já estiver nessa lista, o botão diz Un-CC Me. Exemplo:
Os cartões de informações de problemas aparecem quando você passa o cursor sobre:
- O ID do problema pode ser encontrado na guia Bloqueado por, Bloqueio ou Cópias da bandeja Problemas relacionados.
- O ID do problema na coluna Bloqueado por, Bloqueio ou Duplicar de de um problema na página de resultados da pesquisa.
- Link para um problema encontrado no painel Recent Issues, à direita de uma página Create Issue.
- Status em uma página de problemas marcada como duplicada.
- Link para o problema canônico encontrado na barra amarela na parte de cima de uma página marcada como duplicada.
Problemas de edição
Se você tiver a permissão de visualização e edição para um componente, poderá editar os campos dele e anexar comentários a ele. No entanto, alguns campos não podem ser editados, como a data de criação do problema ou os comentários feitos anteriormente.
Editar níveis
As mudanças em um problema têm nível variável de significância, que determina se as mudanças aparecem no painel de histórico do problema e se os usuários recebem notificações por e-mail quando a mudança ocorre.
Fechando edições
As edições de fechamento alteram o status de um problema de Aberto para Fechado. As edições de fechamento aparecem no painel de histórico do problema. As edições de fechamento são enviadas como notificações por e-mail para os usuários com uma das seguintes configurações de notificação: Todas as atualizações, Atualizações importantes ou Somente fechamento.
Para ver uma lista completa dos status que encerram um problema aberto, consulte o status do problema.
Edições importantes
As edições importantes sempre aparecem no painel de histórico do problema. Após uma edição importante, uma notificação por e-mail é enviada aos usuários que têm uma configuração de notificação definida como Todas as atualizações ou Atualizações importantes. As edições consideradas principais incluem:
- Criação inicial do problema.
- Comentários adicionados ao problema.
- O problema foi movido para um novo componente.
- Mudanças na prioridade, gravidade, retenção ou responsável
- uma mudança de status Fechada, Verificada ou Reaberta.
- Mudanças nos campos personalizados marcados como Principal.
Pequenas edições
Pequenas edições só aparecerão no painel de histórico de um problema se a opção Histórico completo estiver ativada. Da mesma forma, pequenas edições são enviadas apenas como notificações por e-mail para usuários com o papel definido como Todas as atualizações.
As edições consideradas secundárias incluem:
- Alterações de título
- Alterações na hotlist
- Mudanças relacionadas a problemas (bloqueio, bloqueio por, duplicatas)
- Mudanças no status não explicitamente declaradas como edições importantes
- Alterações nos seguintes campos: Reporter, Tipo, Verificador, Encontrado em, Direcionado para, Verificado em, In Prod
- Mudanças nos campos personalizados marcados como Menor
Edições silenciosas
As edições silenciosas não aparecem no painel de histórico de um problema e não geram e-mails de notificação para os usuários. As edições consideradas silenciosas incluem:
- Adicionar ou remover entradas dos campos CC ou Colaborador (a menos que o usuário ou grupo tenha sido adicionado ou removido recentemente)
- Editar um comentário
- Alterar um campo personalizado marcado como Silenciosa
Limites de acesso para problemas
O Issue Tracker oferece suporte a restrições de controle de acesso que permitem que os problemas tenham um conjunto menor de acessadores do que outros problemas no mesmo componente.
Os administradores de problemas têm permissão para atualizar o status de restrição de um problema para um dos quatro níveis de acesso ao problema:
Acesso padrão: as regras normais se aplicam: um problema com o nível de acesso padrão tem os mesmos acessadores que todos os outros problemas no componente.
Comentários limitados: somente as identidades explicitamente listadas no problema como responsável, colaborador, verificador ou CC poderão comentar sobre o problema, independentemente de terem permissões para comentar em outros problemas no componente. Identidades com a permissão "Problemas de administrador" no componente também mantêm o acesso para comentários. O acesso de leitura continua padrão.
Visibilidade limitada: apenas as identidades explicitamente listadas (responsável, colaborador, verificador ou CC) retêm acesso de visualização ao problema.
Visibilidade limitada + Google: apenas as identidades explicitamente listadas (responsável, colaborador, verificador ou CC), Googlers em tempo integral e contas de automação interna retêm acesso de visualização ao problema.