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 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. Ao lado da organização, clique em Configurações.
3. Na seção "Planejamento" da barra lateral, clique nos Campos de questões.
4. Clique em Novo campo.
5. Em "Nome do campo", digite o nome do novo campo.
6. Opcionalmente, em "Descrição", digite uma descrição para ajudar outras pessoas a entender a finalidade do campo.
7. Em "Tipo de campo", selecione o tipo de campo que você deseja criar.
8. 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 em ao lado da opção, clique em Editar opção, escolha uma cor e clique em Salvar.
   • Repita para adicionar mais opções.
9. 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 em <svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-pencil" aria-label="edit pinning" role="img"><path d="M11.013 1.427a1.75 1.75 0 0 1 2.474 0l1.086 1.086a1.75 1.75 0 0 1 0 2.474l-8.61 8.61c-.21.21-.47.364-.756.445l-3.251.93a.75.75 0 0 1-.927-.928l.929-3.25c.081-.286.235-.547.445-.758l8.61-8.61Zm.176 4.823L9.75 4.81l-6.286 6.287a.253.253 0 0 0-.064.108l-.558 1.953 1.953-.558a.253.253 0 0 0 .108-.064Zm1.238-3.763a.25.25 0 0 0-.354 0L10.811 3.75l1.439 1.44 1.263-1.263a.25.25 0 0 0 0-.354Z"></path></svg> para escolher quais tipos de problema exibirão este campo no visualizador e criador de problemas. 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.
     

10. 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. Ao lado da organização, clique em Configurações.
3. Na seção "Planejamento" da barra lateral, clique em Campos de Tarefa.
4. À direita do campo que você deseja editar, clique em .
5. Clique em Editar e faça suas alterações.
6. 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. Ao lado da organização, clique em Configurações.
3. Na seção "Planejamento" da barra lateral, clique em Campos de problema.
4. À direita do campo que você deseja excluir, clique em .
5. 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. Ao lado da organização, clique em Configurações.
3. Na seção "Planejamento" da barra lateral, clique em Tipos de problema.
4. Clique no tipo de problema para o qual você deseja reordenar campos.
5. Em "Campos de problema fixados", arraste os campos para reordená-los.
6. 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. Ao lado da organização, clique em Configurações.
3. Na seção "Planejamento" da barra lateral, clique em Campos de problema.
4. Clique no campo que você deseja fixar.
5. Em "Fixar em tipos", clique em e selecione os tipos de problema nos quais este campo deve aparecer.
6. Clique em Salvar campo.

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

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. Ao lado da organização, clique em Configurações.
3. Na seção "Planejamento" da barra lateral, clique nos campos de questão.
4. À direita do campo, clique em .
5. Clique em Editar.
6. 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.
7. 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 de problema e projetos

Os campos de problema estão disponíveis em qualquer projeto em sua organização. Para obter detalhes sobre como adicionar, remover e editar campos de problema em projetos, consulte Adicionando e gerenciando campos de problemas.

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	50
Campos fixados por tipo de problema	10
Total de campos em um projeto (incluindo campos de problema e campos do sistema)	50