Um problema no Google Issue Tracker é 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 a própria página de detalhes em que os usuários rastreiam a atividade relacionada e onde fazem comentários e atualizam os dados do problema.
Campos de problemas
Cada problema tem um conjunto de campos associados que o descrevem e o estado atual dele. Isso inclui o tipo de problema, a importância dele em termos de gravidade e prioridade e o registro da atividade do 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 é associado a um componente específico. Para todos os novos problemas, há vários campos obrigatórios. Isso inclui Componente, Título, Prioridade e Tipo. Alguns componentes também têm campos personalizados obrigatórios.
Na página de detalhes do problema, a maioria dos campos é encontrada no lado direito, no painel Campos do problema. Outros campos ficam na bandeja Problemas relacionados, perto da parte de cima 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 o campo no texto do mouseover.
Para ver uma descrição dos campos de problemas padrão, consulte Glossário de campos.
Tipo de problema
O campo Type permite categorizar problemas dentro de um componente em um dos vários grupos comuns. Este campo é obrigatório. A tabela a seguir mostra os possíveis tipos de problemas:
| Tipo de problema | Descrição |
|---|---|
| Bug | O comportamento vai contra o que deveria ocorrer ou foi documentado para ocorrer, 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 simplesmente 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 resolvê-lo permitiria uma interação mais simples ou intuitiva durante o desenvolvimento do produto. Também é possível 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 aos SLOs definidos pelas diretrizes de privacidade e segurança do Google. Somente leitura até 01/11/2017. |
| Projeto | Um esforço orientado a metas com início e fim finitos, focado 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 ao 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 ao usuário. |
| Tarefa | Uma pequena unidade de trabalho. |
| Programa | Uma coleção de metas temáticas (projetos, recursos, marcos, épicos). |
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, ela é parcial ou muito dolorosa. O impacto do problema é em uma função organizacional essencial ou impede fundamentalmente outra equipe. |
| P2 | Um problema que precisa ser resolvido em um prazo razoável. Esse problema pode ser: 1) um problema que seria P0 ou P1, mas tem 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. P2 é relevante principalmente para problemas de 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 funções organizacionais essenciais ou 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 funções organizacionais principais ou para o trabalho de outras equipes; ou então, está relacionado apenas à atratividade ou prazer 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 das atividades que 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 tem uma pessoa ou um grupo atribuído. |
| Atribuídas | O problema está atribuído a uma pessoa. Essa pessoa aparece no campo Responsável. |
| Em andamento (aceito) | O responsável reconheceu o problema e começou a trabalhar nele. |
| Fixa | O problema foi resolvido. |
| Corrigido (verificado) | O problema foi resolvido, e a correção da correção foi confirmada pelo usuário no campo Verificador. |
| Não corrigido (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 Duplicado, 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 outras ações, exceto possíveis verificação. Isso inclui qualquer problema com o 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 de um problema que está na lista suspensa Bloqueado por ou Bloqueio de outro problema. Esses ícones fornecem uma maneira rápida de avaliar o progresso de um problema bloqueado ou bloqueado 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 de status em vez de texto.
Status da mudança rápida
Há duas maneiras de mudar rapidamente o status de um problema e avançar para a próxima etapa típica do 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 no lado direito 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 atribuído, ou se o usuário atribuído for outra pessoa, a solicitação de mudança rápida será Atribuir a mim. A alteração rápida do status define o responsável pela tarefa e, se definido de outra forma, altera 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 trabalho. A mudança rápida muda o status do problema para Em andamento.
Se você for o responsável por um problema e o status dele for Em andamento, o comando de mudança rápida mostrará Marcar como corrigido. A mudança rápida muda o status do problema para Corrigido.
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 Sem correção, o aviso de mudança rápida será Reabrir (exceto no caso mencionado acima). Uma 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.
Emitir cartões de visita
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, ela contém um botão CC Me que adiciona você à lista de Cc do problema. Se você já estiver nessa lista, o botão vai dizer (Cancelar CC). Exemplo:
Os cartões de informações de problemas aparecem quando você passa o cursor sobre:
- ID do problema encontrado na guia Bloqueado por, Bloqueio ou Cópias da bandeja Problemas relacionados.
- ID do problema na coluna Bloqueado por, Bloqueio ou Cópia de de uma página de resultados da pesquisa de um problema.
- Link para um problema encontrado no painel Recent issues, localizado à direita de uma página Create Issue.
- Status em uma página de problema marcada como duplicada.
- Link para o problema canônico encontrado na barra amarela na parte superior 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, não é possível editar alguns campos, 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 um nível variado de significância que determina se elas aparecem no painel de histórico do problema e se os usuários recebem uma notificação por e-mail quando a mudança ocorre.
Fechando edições
As edições finais mudam o status de um problema de Aberto para Encerrado. As edições finais aparecem no painel do histórico do problema. As edições de encerramento são enviadas como notificações por e-mail aos 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.
Principais edições
As edições importantes sempre aparecem no painel do 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 Todas as atualizações ou Atualizações importantes. As edições consideradas importantes 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 alteração de status Encerrado, Verificado ou Reaberto.
- Alterações nos campos personalizados marcados como Principal.
Pequenas edições
Pequenas edições só aparecem no painel de histórico de um problema se o nível do filtro estiver definido como Histórico completo. Da mesma forma, pequenas edições são enviadas apenas como notificações por e-mail para os usuários que têm o papel no problema definido como Todas as atualizações.
As edições consideradas secundárias incluem:
- Alterações de título
- Mudanças na hotlist
- Adicionar anexos
- Mudanças em problemas relacionados (bloqueio, bloqueado por, duplicatas)
- Alterações no status que não estão explicitamente declaradas como edições importantes
- Alterações nos seguintes campos: Reporter, Tipo, Verificador, Encontrado em, Direcionado para, Verificado em, Em produção
- Alterações nos campos personalizados marcados como Menor
Edições silenciosas
As edições silenciosas 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 a 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 podem atualizar o status de restrição de um problema para um destes quatro níveis de acesso:
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 listadas no problema como cessionário, colaborador, verificador ou CC podem comentar sobre o problema, independentemente de terem permissões de comentário para outros problemas no componente. As identidades com permissão para problemas de administrador no componente também mantêm o acesso aos comentários. O acesso para visualização continua padrão.
Visibilidade limitada: somente as identidades listadas explicitamente (responsável, colaborador, verificador ou CC) mantêm acesso de leitura ao problema.
Visibilidade limitada + Google: apenas as identidades listadas explicitamente (responsável, colaborador, verificador ou CC), Googlers em tempo integral e contas de automação interna retêm acesso de visualização ao problema.