Um problema no Issue Tracker do Google é um relatório de bug, solicitação de recurso, solicitação de mudança ou item de fluxo de trabalho de processo que um usuário quer acompanhar ou espera que outro usuário ou equipe acompanhe. Os problemas são organizados em componentes, cada um contendo um grupo de problemas relacionados. Cada problema no Issue Tracker tem uma página de detalhes própria, onde os usuários rastreiam a atividade no problema, fazem comentários e atualizam os dados.
Campos de problema
Cada problema tem um conjunto de campos associados que o descrevem e o estado atual. Isso inclui o tipo de problema, a importância em termos de gravidade e prioridade e o registro de atividades sobre o 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 apenas 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 está no lado direito da página no painel Campos do problema. Alguns campos adicionais estão na bandeja Problemas relacionados, perto da parte de cima da página. Quase todos os campos são editáveis no Issue Tracker. Para isso, clique 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 resumidas sobre ele no texto de passagem do cursor.
Para uma descrição dos campos de problemas padrão, consulte Glossário de campos.
Tipo de problema
O campo Type permite categorizar problemas em um componente em um dos vários grupos comuns. Este campo é obrigatório. A tabela a seguir mostra os possíveis tipos de problema:
| Tipo de problema | Descrição |
|---|---|
| Bug | O comportamento é contrário ao que deveria ocorrer ou foi documentado para ocorrer, ou o produto não funciona como esperado. |
| Solicitação de recurso | O produto funciona como esperado, mas pode ser melhorado com as mudanças especificadas. |
| Problema do cliente | O problema está afetando terceiros e não pode ser reproduzido pela pessoa que o relatou. 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 permitiria uma interação mais simplificada ou intuitiva ao desenvolver o produto. Você também pode usar esse tipo para acompanhar problemas de manutenção. |
| Processo | O processo é uma categoria variada que tem usos variados, dependendo do projeto. Por exemplo, você pode 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é 01/11/2017. |
| Projeto | Um esforço orientado por metas com início e fim definidos, 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 | Um conjunto de trabalhos que oferece um valor específico ao usuário. |
| Epic | Uma grande coleção de trabalhos com um objetivo comum. |
| Matéria | Uma pequena coleção de trabalho que oferece um valor específico ao usuário. |
| Tarefa | Uma pequena unidade de trabalho. |
| Programa | Uma coleção de metas relacionadas a temas (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 determinar a 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 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 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 será parcial ou muito difícil. O problema afeta uma função organizacional principal ou impede uma outra equipe. |
| P2 | Um problema que precisa ser resolvido em um período razoável. Esse problema pode ser 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 de usuários e está conectado às funções organizacionais principais; 3) um problema que impede o trabalho de outras equipes e não tem uma solução alternativa razoável. P2 é especialmente relevante para problemas de primeiro uso ou de instalação e é o nível de prioridade padrão. |
| P3 | Um problema que precisa ser resolvido quando possível. Esse problema é relevante para as funções organizacionais principais ou o trabalho de outras equipes, mas não impede o progresso ou tem uma solução alternativa razoável. |
| P4 | Um problema que precisa ser resolvido em algum momento. Esse problema não é relevante para as funções organizacionais principais ou para o trabalho de outras equipes, ou se relaciona 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 sobre quais atividades precisam ocorrer para que um problema mude de status ou seja resolvido. Nem todos os valores de campo Status disponíveis precisam ser usados para acompanhar a resolução de um problema. A tabela a seguir mostra maneiras comuns de usar o campo Status:
| Status do problema | Descrição |
|---|---|
| Nova | O problema não está atribuído a uma pessoa ou grupo. |
| Atribuída | O problema está atribuído a uma pessoa. Essa pessoa aparece no campo Atribuído a. |
| Em andamento (aceita) | O responsável reconheceu o problema e começou a trabalhar nele. |
| Correção | O problema foi resolvido. |
| Corrigido (verificado) | O problema foi resolvido, e a exatidão da correção foi confirmada pelo usuário no campo Verifier. |
| 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 mudanças necessárias para resolver o problema não são viáveis. |
| Duplicar | 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 Fechado, dependendo do status. Os problemas abertos são aqueles que estão aguardando resolução. Isso inclui qualquer problema com status Novo, Atribuído ou Em andamento. Os problemas fechados são aqueles que não exigem mais ações, exceto, talvez, verificação. Isso inclui qualquer problema com status Fixed, Won't Fix ou Duplicate.
Í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 Bloqueando 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 de status em vez de texto.
Status de mudança rápida
Há duas maneiras de mudar rapidamente o status de um problema para avançar para a próxima etapa típica do processo de resolução. O primeiro é o botão Change Status, localizado na App Bar, perto da parte de cima da página de detalhes do problema, e o link Change Status no painel Issue Fields, no lado direito da página. Clicar em qualquer uma delas vai avançar o status do problema da seguinte maneira:
Se o problema for novo e não tiver sido atribuído a você ou a outra pessoa, o prompt de mudança rápida vai mostrar Atribuir a mim. A mudança rápida do status vai definir o atribuído para você e, se estiver 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 comando de mudança rápida vai ser Iniciar trabalho. A mudança rápida muda o status do problema para Em andamento.
Se você for o atribuído de um problema e o status dele for Em andamento, o comando de mudança rápida vai ser Marcar como corrigido. A mudança rápida muda o status do problema para Corrigido.
Se um problema tiver o status Corrigido e você for o verificador, o comando de mudança rápida vai mostrar Verificar. A mudança rápida muda o status do problema para Corrigido (verificado).
Se um problema tiver um status fechado (Fixed, Duplicate ou Won't Fix), o prompt de mudança rápida vai mostrar Re-open (exceto no caso mencionado acima). A mudança rápida muda o status para Novo se o problema não tiver um atribuído ou Atribuído se tiver.
Cartões de visita do problema
Um card de passagem de 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 na lista de CC, o botão vai mostrar Un-CC Me. Exemplo:
Os cards de problema aparecem quando você passa o cursor sobre os seguintes itens:
- O ID do problema encontrado nas guias Bloqueado por, Bloqueando ou Duplicados da bandeja Problemas relacionados.
- ID do problema nas colunas Bloqueado por, Bloqueio ou Duplicado de da página resultados da pesquisa de um problema.
- Link para um problema encontrado no painel Recent Issues, localizado à direita da página Create Issue.
- Campo Status em uma página de problema 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 permissão de leitura e edição para 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 comentários feitos anteriormente.
Editar níveis
As mudanças em um problema têm um nível de significância variável 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.
Fechar edições
As edições de fechamento mudam 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 encerramento são enviadas como notificações por e-mail para usuários com uma das seguintes configurações de notificação: Todas as atualizações, Atualizações principais ou Somente encerramento.
Para conferir uma lista completa de status que fecham um problema aberto, consulte status do problema.
Edições importantes
As edições importantes sempre aparecem no painel de histórico do problema. Depois de uma edição importante, uma notificação por e-mail é enviada para os usuários que têm a configuração de notificação 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 é movido para um novo componente.
- Mudanças na prioridade, gravidade, retenção ou atribuição.
- Uma mudança de status para Encerrado, Verificado ou Reaberto.
- Mudanças em campos personalizados marcados como Principais.
Pequenas edições
As edições menores só aparecem no painel de histórico de um problema se o nível de filtro estiver definido como Histórico completo. Da mesma forma, as edições menores são enviadas apenas como notificações por e-mail para usuários cuja função no problema tem uma configuração de notificação de Todas as atualizações.
As edições consideradas menores incluem:
- Mudanças no título
- Mudanças na Hotlist
- Como adicionar anexos
- Mudanças no problema relacionado (bloqueio, bloqueado por, duplicações)
- Mudanças no status não declaradas explicitamente como edições importantes
- Mudanças nos seguintes campos: Reporter, Type, Verifier, Found In, Targeted To, Verified In, In Prod
- Mudanças em campos personalizados marcados como Pequenas
Edições silenciosas
As edições silenciosas não geram e-mails de notificação para nenhum usuário. As edições consideradas silenciosas incluem:
- Adicionar ou remover entradas dos campos CC ou Collaborator, a menos que o usuário ou grupo esteja sendo adicionado ou removido.
- Editando um comentário
- Mudar um campo personalizado marcado como Silencioso
Limites de acesso a itens
O Rastreador de problemas oferece suporte a restrições de controle de acesso que permitem que os problemas tenham um conjunto menor de acessórios 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 a problemas:
Acesso padrão: as regras normais se aplicam: um problema com o nível de acesso padrão tem os mesmos acessórios que todos os outros problemas no componente.
Comentários limitados: apenas as identidades listadas explicitamente no problema como atribuídas, colaboradoras, verificadoras ou CC poderão comentar sobre o problema, independentemente de terem permissões de comentário para outros problemas no componente. As identidades com a permissão de problemas de administrador no componente também mantêm o acesso aos comentários. O acesso de leitura continua padrão.
Visibilidade limitada: apenas as identidades listadas explicitamente (atribuídas, colaboradores, verificadores ou CC) mantêm o acesso de leitura ao problema.
Visibilidade limitada + Google: apenas identidades listadas explicitamente (responsável pela atribuição, colaborador, verificador ou CC), Googlers em tempo integral e contas de automação internas mantêm o acesso de visualização ao problema.