Gerenciando campos de problema

Os campos de problema permitem adicionar metadados estruturados a problemas em seus repositórios. 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 ou do usuário e se aplicam em todos os repositórios.

Sobre tipos de campo de problema

Você pode criar até 25 campos de issue. 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 estão habilitados, 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:

Field	Sem tipo	Bug	Tarefa	Feature
Priority
Effort
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. Em seu nome de organização ou perfil de usuário, clique em Configurações.
2. Na seção "Planejamento" da barra lateral, clique nos Campos de questões.
3. Clique em Novo campo.
4. Em "Nome do campo", digite o nome do novo campo.
5. Opcionalmente, em "Descrição", digite uma descrição para ajudar outras pessoas a entender a finalidade do campo.
6. Em "Tipo de campo", selecione o tipo de campo que você deseja criar.
7. 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.
8. Em "Visibilidade do Campo", escolha um dos seguintes:
   • Permissões: escolha quem pode ver o campo e seu valor. As opções são Restritas (padrão) ou Públicas. 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.
9. Clique em Criar.

Editando um campo de problema

1. No menu abaixo do nome da organização ou do perfil de usuário, clique em Configurações.
2. Na seção "Planejamento" da barra lateral, clique nos Campos de questões.
3. À direita do campo que você deseja editar, clique em .
4. Clique em Editar e faça suas alterações.
5. 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. Em seu nome de organização ou perfil de usuário, clique em Configurações.
2. Na seção "Planejamento" da barra lateral, clique nos Campos de questões.
3. À direita do campo que você deseja excluir, clique em .
4. 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. Em seu nome de organização ou perfil de usuário, clique em Configurações.
2. Na seção "Planejamento" da barra lateral, clique em Tipos de problema.
3. Clique no tipo de problema para o qual você deseja reordenar campos.
4. Em "Campos de problema fixados", arraste os campos para reordená-los.
5. 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. Em seu nome de organização ou perfil de usuário, clique em Configurações.
2. Na seção "Planejamento" da barra lateral, clique nos Campos de questões.
3. Clique no campo que você deseja fixar.
4. Em "Fixar em tipos", clique e selecione os tipos de problema em que esse campo deve aparecer.
5. Clique em Salvar campo.

Os campos fixados aparecem automaticamente na barra lateral da tarefa 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 ou perfis de usuário com repositórios públicos, você pode controlar se cada campo de problema está visível para todos ou apenas para membros, proprietários de repositório e colaboradores.

1. Em seu nome de organização ou perfil de usuário, clique em Configurações.
2. Na seção "Planejamento" da barra lateral, clique nos Campos de questões.
3. À direita do campo, clique em .
4. Clique em Editar.
5. Em "Visibilidade do Campo", escolha um dos seguintes:
   • Restrito: o campo é visível apenas para membros da organização e colaboradores de repositório com pelo menos acesso de leitura em repositórios de propriedade da organização ou para o proprietário do repositório e colaboradores com pelo menos acesso de leitura em repositórios de propriedade pessoal.
   • Público: o campo é visível para qualquer pessoa que esteja visualizando o problema.
6. Clique em Salvar.

Por padrão, todos os campos novos e existentes são definidos como "Restrito". 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.

Emitir campos e projetos

Os campos de issue estão disponíveis em qualquer projeto em sua organização ou perfil de usuário, 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. Campos definidos como Restritos 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 "Restrito" 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

Resource	Limit
Campos de problema	25
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