Adicionando e gerenciando campos de problemas

Você pode definir, editar e limpar valores de campo de problema em problemas individuais para capturar metadados estruturados para sua equipe.

Quem pode usar esse recurso?

People with triage access or greater to a repository can set and edit issue field values.

Neste artigo

Observação

Issue fields are currently in versão prévia pública and subject to change. To share feedback, see the community discussion.

Os campos de problema aparecem na barra lateral direita de problemas, juntamente com campos do sistema, como atribuições, rótulos e tipo. Você pode definir valores ao criar ou editar um problema. Quando você seleciona um tipo de problema ao criar um problema, todos os campos fixados nesse tipo aparecem automaticamente na barra lateral.

Definindo um valor de campo

  1. Navegue até o problema que você deseja atualizar.
  2. Na barra lateral direita, se o campo desejado ainda não estiver visível, clique em Adicionar campo.
  3. Na lista suspensa, selecione o campo para adicionar.
  4. Defina o valor:
    • Para campos de seleção única, escolha uma das opções na lista suspensa.
    • Para campos de texto , digite seu valor. As URLs são detectadas e exibidas automaticamente como links.
    • Para **** campos numéricos, insira um valor numérico.
    • Para campos de data , use o seletor de datas para selecionar uma data ou digite a data diretamente.
  5. As alterações são salvas automaticamente.

Editando um valor de campo

  1. Navegue até o problema.
  2. Na barra lateral direita, clique no valor do campo que você deseja alterar.
  3. Selecione um novo valor ou digite uma nova entrada.
  4. As alterações são salvas automaticamente.

Limpar um valor de campo

  1. Navegue até o problema.
  2. Na barra lateral direita, clique no valor do campo.
  3. Limpe o valor
    • Para campos de seleção única , clique na opção selecionada no momento para desmarcá-la.
    • Para campos de texto e número , exclua todo o texto na entrada.
    • Para campos de data, clique no botão 'Limpar' no seletor de data.
  4. Após a limpeza, o campo é removido da barra lateral. Ele pode ser adicionado novamente usando o botão Adicionar campo .

Campos fixados

Se o administrador da sua organização fixou campos a tipos de problema específicos, esses campos aparecerão automaticamente na barra lateral e no modal de criação de problemas ao criar ou exibir um problema desse tipo. Você não precisa adicionar manualmente campos fixados.

Visualizando alterações de campo no cronograma

Quando um valor de campo é alterado, a atualização é registrada na linha do tempo do problema. A linha do tempo mostra:

  • Qual campo foi alterado
  • O novo valor que foi definido
  • Quem fez a alteração
  • O momento em que a alteração foi feita

Eventos de linha do tempo para campos com visibilidade "Apenas organização" estão ocultos de usuários que não são membros da organização ou colaboradores.

Visibilidade do campo

Os administradores da organização podem definir a visibilidade de cada campo como "Somente organização" ou "Pública". Isso afeta o que você vê:

  • Se um campo for definido apenas como Organização, ele só ficará visível para membros da organização e colaboradores de repositório com pelo menos acesso de leitura. Se você não for membro ou colaborador, o campo não aparecerá na barra lateral do problema, na linha do tempo ou nas sugestões de pesquisa.
  • Se um campo for definido como Público, ele ficará visível para qualquer pessoa que esteja exibindo o problema.

Para obter mais informações sobre como configurar a visibilidade, consulte Gerenciando campos de problemas em sua organização.

Usando campos de problema em projetos

Os campos de problema podem ser adicionados como colunas em exibições de projeto, em que você pode editar valores, agrupar, filtrar, classificar e compilar gráficos. Para obter mais informações, consulte Sobre campos de problema em projetos.

Pesquisando por valores de campo

Você pode filtrar e pesquisar problemas com base em valores de campo no painel de problemas e na página de problemas do repositório. Na barra de pesquisa, digite field. seguido pelo nome e valor do campo. Por exemplo:

  •         `field.priority:high` para encontrar problemas com a prioridade definida como "alta"

  •         `field."target date":>=2026-03-01` para encontrar problemas com uma data de destino em ou após 1º de março de 2026

  •         `field.priority:high,medium` para encontrar problemas com a prioridade definida como "alta" ou "média"

Para obter mais informações, consulte Filtrando e pesquisando problemas e pull requests.

Usando campos de problema com a API

Os campos de problema têm suporte completo à API REST e GraphQL. Você pode automatizar o gerenciamento de campos, definir valores programaticamente e integrar-se a ferramentas externas.

  •         **Gerenciamento de campos**: criar, atualizar e excluir campos no nível da organização. Consulte a [API REST dos campos de problema da organização](/rest/orgs/issue-fields).

  •         **Usando campos**: obter, definir e limpar valores de campo em problemas individuais. Consulte a [API REST dos valores dos campos de chamado](/rest/issues/issue-field-values).