Gerenciando campos de problemas em sua organização

Os campos de problema permitem adicionar metadados estruturados a problemas em toda a sua organização. Em vez de depender de rótulos ou soluções alternativas de texto livre, você pode criar campos como prioridade, esforço, impacto ou qualquer categoria personalizada de que sua equipe precise. Os campos são definidos no nível da organização e se aplicam a todos os repositórios em sua organização.

Sobre tipos de campo de problema

Você pode criar até 25 campos de problema por organização. Os seguintes tipos de campo estão disponíveis:

• Seleção única: escolha uma opção em uma lista predefinida. As opções podem ter nomes, descrições e cores.
• Texto: capturar texto de forma livre. As URLs são detectadas automaticamente e exibidas como links clicáveis.
• Número: aceite entrada numérica, incluindo decimais.
• Data: forneça um seletor de datas para selecionar datas.

Campos padrão

Quando os campos de problema são habilitados para sua organização, quatro campos padrão são criados automaticamente:

• Prioridade (seleção única): Urgente, Alta, Média, Baixa
• Esforço (seleção única): Alta, Média, Baixa
• Data de início (data)
• Data de destino (data)

Esses campos padrão são fixados em tipos de problema da seguinte maneira:

Campo	Sem tipo	Bug	Tarefa	Característica
Prioridade
Esforço
Data de início
Data de destino

Esses campos padrão são totalmente personalizáveis. Você pode editar seus nomes, descrições e opções ou excluí-los se eles não se ajustarem ao fluxo de trabalho.

Criando um campo de problema

1. No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.

2. Selecione uma organização clicando nela.

3. No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

   

4. Na seção "Planejamento" da barra lateral, clique nos Campos de questões.

5. Clique em Novo campo.

6. Em "Nome do campo", digite o nome do novo campo.

7. Opcionalmente, em "Descrição", digite uma descrição para ajudar outras pessoas a entender a finalidade do campo.

8. Em "Tipo de campo", selecione o tipo de campo que você deseja criar.

9. Se você selecionou a seleção única, adicione opções para o campo:

   • Clique em Adicionar opção e digite o nome da opção.
   • Opcionalmente, para definir uma cor para uma opção, clique ao lado da opção, clique na opção Editar, escolha uma cor e clique em Salvar.
   • Repita para adicionar mais opções.

10. Em "Visibilidade do Campo", escolha um dos seguintes:

    • Permissões: escolha quem pode ver o campo e seu valor. As opções são somente Organização (padrão) ou Pública. Essa configuração só se aplica a problemas em repositórios públicos.
    • Fixar em tipos: clique para escolher quais tipos de problema mostram esse campo no visualizador de problemas e no criador. Selecione um ou mais tipos de problema ou "Problemas sem um tipo". Os campos que não estiverem fixados e não tiverem valor permanecerão ocultos no visualizador e criador de problemas.

11. Clique em Criar.

Editando um campo de problema

1. No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.

2. Selecione uma organização clicando nela.

3. No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

   

4. Na seção "Planejamento" da barra lateral, clique nos Campos de questões.

5. À direita do campo que você deseja editar, clique em .

6. Clique em Editar e faça suas alterações.

7. Clique em Salvar campo.

Excluindo um campo de problema

Quando você exclui um campo de problema, todos os valores definidos em problemas para esse campo são permanentemente removidos.

1. No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.

2. Selecione uma organização clicando nela.

3. No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

   

4. Na seção "Planejamento" da barra lateral, clique nos Campos de questões.

5. À direita do campo que você deseja excluir, clique em .

6. Clique em Excluir e confirme a exclusão.

Reordenando campos de problema

A ordem dos campos fixados é gerenciada por tipo de problema. A ordem do campo determina como os campos aparecem na barra lateral do problema e o modal de criação de problemas.

1. No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.

2. Selecione uma organização clicando nela.

3. No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

   

4. Na seção "Planejamento" da barra lateral, clique em Tipos de problema.

5. Clique no tipo de problema para o qual você deseja reordenar campos.

6. Em "Campos de problema fixados", arraste os campos para reordená-los.

7. Clique em Salvar.

Fixando campos a tipos de problema

Você pode associar campos de problema a tipos de problema específicos para que apenas os campos mais relevantes apareçam ao criar ou exibir problemas desse tipo. Por exemplo, você pode fixar "Gravidade" em bugs e "Impacto" em funcionalidades.

1. No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.

2. Selecione uma organização clicando nela.

3. No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

   

4. Na seção "Planejamento" da barra lateral, clique nos Campos de questões.

5. Clique no campo que você deseja fixar.

6. Em "Fixar em tipos", clique e selecione os tipos de problema em que esse campo deve aparecer.

7. Clique em Salvar campo.

Os campos fixados aparecem automaticamente na barra lateral de problemas com base no tipo de tarefa selecionado. Para fixar campos em problemas que não têm tipo, selecione a opção "Problemas sem tipo".

Se um campo não estiver aparecendo em seus problemas, verifique se ele está fixado ao tipo de problema relevante ou a "Problemas sem um tipo". Os campos que não estão fixados e não têm nenhum valor definido ficam ocultos na barra lateral do problema.

Configurando a visibilidade do campo

Para organizações com repositórios públicos, você pode controlar se cada campo de problema é visível para todos ou apenas para membros e colaboradores da organização.

1. No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.

2. Selecione uma organização clicando nela.

3. No nome da organização, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

   

4. Na seção "Planejamento" da barra lateral, clique nos Campos de questões.

5. À direita do campo, clique em .

6. Clique em Editar.

7. Em "Visibilidade do Campo", escolha um dos seguintes:

   • Organização somente: o campo é visível apenas para membros da organização e colaboradores do repositório com pelo menos acesso de leitura.
   • Público: o campo é visível para qualquer pessoa que esteja visualizando o problema.

8. Clique em Salvar.

Por padrão, todos os campos novos e existentes são definidos como "Somente organização". As configurações de visibilidade são aplicadas na interface web, na API, nos eventos da linha do tempo das questões e nas sugestões de pesquisa.

Campos e projetos de problemas

Os campos de problema estão disponíveis em qualquer projeto em sua organização, incluindo projetos públicos e internos. Para obter detalhes sobre como adicionar, remover e editar campos de problema em projetos, consulte Sobre campos de problema em projetos.

Visibilidade em projetos públicos e internos

Somente os campos com visibilidade pública estão disponíveis em projetos públicos e internos. Os campos definidos como Organização só não são exibidos. Ao adicionar campos a um projeto público, apenas campos de visibilidade pública aparecem na caixa de diálogo de campo de adição.

Se a visibilidade de um campo for alterada de "Público" para "Somente Organização" enquanto estiver em uso em um projeto público, o campo será removido automaticamente do projeto. Para restaurá-lo, altere a visibilidade do campo de volta para "Público".

Migrando de campos de projeto para campos de emissão

Se você já usar campos personalizados no nível do projeto para metadados, como prioridade ou esforço, poderá adotar campos de problema para centralizar esses valores no nível de problema.

• Os campos de problema são a fonte da verdade. O valor reside no problema e é consistente em todos os projetos aos que o problema pertence.
• Os campos do projeto são restritos a um único projeto. O mesmo problema pode ter valores de campo de projeto diferentes em projetos diferentes.
• Ambos podem coexistir. Você não precisa remover os campos do projeto imediatamente, mas manter os dois pode causar confusão se eles representarem o mesmo conceito (por exemplo, dois campos chamados "Prioridade").
• Para migrar, crie o campo de problema equivalente e remova o campo no nível do projeto das exibições do projeto quando sua equipe estiver pronta.

Limites de campo em projetos

Os projetos dão suporte a até 50 campos no total, e campos de problema e campos do sistema contam para esse limite. Se um projeto já estiver no limite do campo, você precisará remover os campos existentes antes que os campos de problema possam ser adicionados.

Limits

Recurso	Limit
Emitir campos por organização	vinte e cinco
Opções por campo de seleção única	100
Campos fixados por tipo de problema	10
Total de campos em um projeto (incluindo campos de problema e campos do sistema)	50