Um problema no Google Issue Tracker é um relatório de bug, solicitação de recurso, solicitação de alteração ou item de 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, cada um contendo um grupo de problemas relacionados. Cada problema no Issue Tracker tem sua própria página de detalhes, em que os usuários rastreiam atividades no problema e onde fazem comentários e atualizam os dados do problema.
Campos do problema
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 em termos de gravidade e prioridade e o registro de atividade no problema. Alguns campos são comuns a todos os problemas. Ele também é compatível com campos personalizados que ficam disponíveis somente quando um problema está associado a um componente específico. Para todos os novos problemas, há vários campos obrigatórios. como Component, Title, Priority e Type. Alguns componentes também têm campos personalizados obrigatórios.
Na página de detalhes do problema, a maioria dos campos está localizada no lado direito da página no painel Campos do problema. Alguns campos adicionais ficam na bandeja Problemas relacionados, na parte superior da página. Quase todos os campos podem ser editados no Issue Tracker. Basta clicar no link, na lista suspensa ou no ícone de lápis associados a eles. Quando você passa o cursor sobre um campo, o Issue Tracker fornece informações breves sobre o campo ao passar o mouse.
Para uma descrição dos campos de problema padrão, consulte Glossário de campos.
Tipo de problema
O campo Type permite categorizar problemas em um componente em um de 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 é contrário ao que deveria acontecer ou foi documentado, ou o produto não funciona como esperado. |
| Solicitação de recurso | O produto funciona conforme o esperado, mas pode ser melhorado com as alterações especificadas. |
| Problema do cliente | O problema está afetando 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 ser 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 permitirá uma interação mais simples ou intuitiva ao desenvolver o produto. Você também pode usar esse tipo para rastrear problemas de manutenção. |
| Processo | Processo é uma categoria diversa, com usos variados, dependendo do projeto. Por exemplo, é possível usar esse tipo para problemas gerados por uma API ou para rastrear 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é 01/11/2017. |
| Projeto | Um esforço orientado por metas com um início e fim finitos, com foco na criação de um produto, serviço ou resultado único. |
| Marco | Uma coleção de trabalhos que representam uma conquista importante no caminho da conclusão de um projeto. Os marcos também podem ser usados para representar lançamentos ou versões. |
| Recurso | Uma coleção de trabalho que fornece um valor específico ao usuário. |
| Épico | Uma grande coleção de trabalho em direção a um objetivo comum. |
| Matéria | Uma pequena coleção de trabalho que fornece um valor específico ao 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 determinar a importância de um problema. A tabela a seguir mostra uma maneira comum de priorizar problemas:
| Prioridade do problema | Descrição |
|---|---|
| P0 (em inglês) | Um problema que precisa ser resolvido imediatamente e com todos os recursos necessários. Esse problema causa uma interrupção total ou faz com que uma função crítica do produto fique indisponível para todos, sem nenhuma solução conhecida. |
| P1 (em inglês) | Um problema que precisa ser resolvido rapidamente. Esse problema impacta significativamente uma grande porcentagem de usuários. Se houver uma solução alternativa, ela é parcial ou muito dolorosa. O problema afeta uma função organizacional principal ou impede fundamentalmente outra equipe. |
| P2 (link em inglês) | Um problema que precisa ser resolvido em uma escala razoável. Esse tipo de problema pode ser qualquer um dos seguintes: 1) Um problema que seria P0 ou P1, mas tem uma solução alternativa razoável, 2) Um problema que é importante para uma grande porcentagem dos usuários e está conectado às principais funções organizacionais, 3) Um problema que é um obstáculo para o trabalho de outras equipes e não tem uma solução razoável. P2 é especialmente relevante para problemas de primeiro uso ou tempo de instalação e é o nível de prioridade padrão. |
| P3 (link em inglês) | Um problema que precisa ser resolvido quando possível. Esse problema é relevante para as funções organizacionais principais ou para o trabalho de outras equipes, mas não impede o progresso ou tem uma alternativa razoável. |
| P4 | Um problema que precisa ser resolvido. Esse problema não é relevante para as principais funções organizacionais ou para o trabalho de outras equipes, ou está relacionado apenas à atratividade ou ao 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 diferentes definições das atividades que precisam ocorrer para que um problema mude de status ou seja resolvido. Nem todos os valores do campo Status disponíveis precisam ser usados para rastrear a resolução de um problema. A tabela a seguir mostra maneiras comuns de usar o campo Status:
| Status do problema | Descrição |
|---|---|
| Novo | Uma pessoa ou um grupo não foi atribuído ao problema. |
| Atribuído | O problema está atribuído a uma pessoa. Essa pessoa aparecerá no campo Responsável. |
| Em andamento (Aceito) | O responsável reconheceu o problema e começou a trabalhar nele. |
| Fixo | O problema foi resolvido. |
| Corrigido (verificado) | O problema foi resolvido, e o usuário corrigiu a correção 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 esperado) | 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 razoavelmente possíveis. |
| Duplicados | O problema foi relatado em outro lugar. Para definir o status de um problema como Duplicado, consulte Duplicar um problema. |
O Rastreador de problemas considera os problemas como abertos ou fechados, dependendo do status deles. Os problemas abertos são aqueles que estão aguardando a resolução. Isso inclui todos os problemas com status Novo, Atribuído ou Em andamento. Problemas fechados são aqueles que não exigem outras ações, exceto, possivelmente, verificação. Isso inclui todos os problemas com 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 de bloqueio sem precisar sair da página atual. Também é possível definir a coluna Status de uma página de resultados de pesquisa para exibir ícones de status em vez de texto de status.
Alterar status rapidamente
Há duas maneiras de alterar 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 superior da página de detalhes do problema e o link Alterar status no painel Campos do problema no lado direito da página. Clicar em um deles avançará o status do problema da seguinte maneira:
Se o problema for novo e não estiver atribuído, ou se o responsável for outra pessoa, a solicitação de alteração rápida será Atribuir a mim. Alterar o status rapidamente definirá o responsável e, se definido de outra forma, mudará o status do problema para Atribuído.
Se você for o responsável por um problema e o status dele for Atribuído, o prompt de alteração rápida mostrará Iniciar trabalho. Alterar rapidamente 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 prompt de alteração rápida mostrará Marcar como corrigido. Alterar rapidamente muda o status do problema para Corrigido.
Se o status de um problema for Fixo e você for o verificador, o prompt de alteração rápida mostrará Verificar. A alteração rápida muda o status do problema para Corrigido (Verificado).
Se o status de um problema for fechado (Corrigido, Duplicar ou Não é corrigido), o prompt de alteração rápida mostrará Reabrir (exceto no caso mencionado acima). Alterar rapidamente muda o status para Novo, se o problema não tiver um cessionário, ou Atribuído, se o problema tiver um cessionário.
Emitir cartões de visita
Um cartão de visita de problemas contém informações como título, código, 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 na lista CC, o botão será Cancelar cópia). Por exemplo:
Os cartões de problemas são exibidos quando você passa o cursor sobre os seguintes itens:
- O código do problema encontrado na guia Bloqueados por, Bloqueio ou Cópias da bandeja Problemas relacionados.
- ID do problema na coluna Bloqueado por, Bloqueio ou Cópia de da página de resultados da pesquisa.
- Link para um problema encontrado no painel Problemas recentes, localizado à direita de uma página Criar problema.
- Status na página de um problema que está marcado como duplicado.
- 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 permissão para visualizar e editar um componente, poderá editar os campos 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 alterações em um problema têm um nível variável de importância que determina se as alterações aparecem no painel do histórico do problema e se os usuários recebem notificação por e-mail quando ocorre.
Fechando edições
Quando você fecha edições, o status de um problema muda de Aberto para Fechado. As edições de fechamento são exibidas no painel do 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 principais ou Somente fechamento.
Para ver uma lista completa dos status que resolvem um problema aberto, consulte o status do problema.
Principais edições
As principais edições sempre aparecem no painel de histórico do problema. Após uma grande edição, uma notificação por e-mail é enviada para os usuários com uma configuração de notificação de Todas as atualizações ou Principais atualizações. As edições consideradas importantes incluem:
- Criação inicial do problema.
- Comentários adicionados ao problema.
- O problema foi movido para um novo componente.
- Alterações na prioridade, gravidade, retenção ou responsável.
- Uma alteração de status Fechada, Verificada ou Reaberta.
- Alterações nos campos personalizados marcados como Principal.
Pequenas edições
As pequenas edições só aparecerão no painel de histórico de um problema se o Histórico completo estiver ativado. Da mesma forma, edições secundárias são enviadas apenas como notificações por e-mail para usuários com o papel no problema com uma configuração de notificação Todas as atualizações.
As edições consideradas menores incluem:
- Alterações de título
- Alterações de hotlist
- Alterações relacionadas a problemas (bloqueio, bloqueio de, duplicatas)
- Alterações no status que não foram explicitamente declaradas como importantes
- Alterações nos seguintes campos: Reporter, Type, Verifier, Found In, Targeted To, Verified In e In Prod
- Alterações em 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 o grupo tenha sido adicionado ou removido recentemente;
- Como editar um comentário
- Alterar um campo personalizado marcado como Silent
Limites de acesso à edição
O Issue Tracker é compatível com 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 dos 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 explicitamente listadas no problema como cessionário, colaborador, verificador ou CC terão permissão para comentar sobre o problema, independentemente de terem permissões de comentário para outros problemas no componente. As identidades com permissão de problemas de administrador no componente também mantêm o acesso aos comentários. O acesso de visualização permanece padrão.
Visibilidade limitada: apenas identidades explicitamente listadas (responsável, colaborador, verificador ou CC) mantêm acesso de visualização ao problema.
Visibilidade limitada + Google: apenas identidades explicitamente listadas (responsável, colaborador, verificador ou CC), Googlers em tempo integral e contas de automação interna mantêm acesso de visualização ao problema.