{"meta":{"title":"Adicionando e gerenciando campos de problemas","intro":"Você pode definir, editar e limpar valores de campo de problema em problemas individuais para capturar metadados estruturados para sua equipe.","product":"GitHub Issues","breadcrumbs":[{"href":"/pt/issues","title":"GitHub Issues"},{"href":"/pt/issues/tracking-your-work-with-issues","title":"Problemas"},{"href":"/pt/issues/tracking-your-work-with-issues/using-issues","title":"Como usar os problemas"},{"href":"/pt/issues/tracking-your-work-with-issues/using-issues/adding-and-managing-issue-fields","title":"Usando campos de problemas"}],"documentType":"article"},"body":"# Adicionando e gerenciando campos de problemas\n\nVocê pode definir, editar e limpar valores de campo de problema em problemas individuais para capturar metadados estruturados para sua equipe.\n\nOs campos de problemas aparecem na barra lateral direita dos problemas, ao lado de campos do sistema como responsáveis, etiquetas 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.\n\n> \\[!NOTE]\n> Os campos dos itens estão disponíveis atualmente apenas nos itens. As solicitações de pull não dão suporte a campos de problema.\n\n## Definindo um valor de campo\n\n1. Navegue até o problema que você deseja atualizar.\n2. Na barra lateral direita, se o campo desejado ainda não estiver visível, clique em **Adicionar campo**.\n3. No menu suspenso, selecione o campo que deseja adicionar.\n4. Defina o valor:\n   * Para campos **de seleção única**, escolha uma das opções na lista suspensa.\n   * Para campos **de texto** , digite seu valor. As URLs são detectadas e exibidas automaticamente como links.\n   * Para \\*\\*\\*\\* campos numéricos, insira um valor numérico.\n   * Para campos **de data** , use o seletor de datas para selecionar uma data ou digite a data diretamente.\n5. As alterações são salvas automaticamente.\n\n> \\[!NOTE]\n> Atualmente, os campos de problema não podem ser preenchidos previamente por meio de parâmetros de consulta de URL ou definidos por meio de modelos de problema. Para definir valores de campo, use a barra lateral do problema, projetos, a API ou GitHub Actions.\n\n## Editando um valor de campo\n\n1. Acesse o problema.\n2. Na barra lateral direita, clique no valor do campo que você deseja alterar.\n3. Selecione um novo valor ou digite uma nova entrada.\n4. As alterações são salvas automaticamente.\n\n## Limpar um valor de campo\n\n1. Acesse o problema.\n2. Na barra lateral direita, clique no valor do campo.\n3. Limpe o valor:\n   * Para campos **de seleção única** , clique na opção selecionada no momento para desmarcá-la.\n   * Para campos **de texto** e **número** , exclua todo o texto na entrada.\n   * Para campos **de data**, clique no botão 'Limpar' no seletor de data.\n4. Após limpar, o campo é removido da barra lateral. Ele pode ser adicionado novamente usando o botão **Adicionar campo** .\n\n## Campos fixados\n\nSe 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 campos fixados manualmente.\n\n## Visualizando alterações de campo no cronograma\n\nQuando um valor de campo é alterado, a atualização é registrada na linha do tempo do problema. A linha do tempo mostra:\n\n* Qual campo foi alterado\n* O novo valor que foi definido\n* Quem fez a alteração\n* O momento em que a alteração foi feita\n\nOs eventos da linha do tempo para campos definidos com visibilidade \"Somente para a organização\" ficam ocultos para usuários que não são membros ou colaboradores da organização.\n\n## Visibilidade do campo\n\nOs administradores da organização podem definir a visibilidade de cada campo como \"Somente organização\" ou \"Pública\". Isso afeta o que você vê:\n\n* 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.\n* Se um campo for definido como **Público**, ele ficará visível para qualquer pessoa que esteja exibindo o problema.\n\nPara obter mais informações sobre como configurar a visibilidade, consulte [Gerenciando campos de problemas em sua organização](/pt/issues/tracking-your-work-with-issues/using-issues/managing-issue-fields-in-your-organization#setting-field-visibility).\n\n## Usando campos de problema em projetos\n\nOs 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](/pt/issues/planning-and-tracking-with-projects/understanding-fields/about-issue-fields).\n\n## Pesquisando por valores de campo\n\nVocê 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:\n\n* `field.priority:high` para encontrar problemas com a prioridade definida como \"alta\"\n* `field.\"target date\":>=2026-03-01` para encontrar problemas com uma data de destino em ou após 1º de março de 2026\n* `field.priority:high,medium` para encontrar problemas com a prioridade definida como \"alta\" ou \"média\"\n\nPara obter mais informações, consulte [Filtrando e pesquisando problemas e pull requests](/pt/issues/tracking-your-work-with-issues/using-issues/filtering-and-searching-issues-and-pull-requests).\n\n## Usando campos de problemas com a API\n\nOs 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.\n\n* **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](/pt/rest/orgs/issue-fields).\n* **Usando campos**: obter, definir e limpar valores de campo em problemas individuais. Consulte a [API REST de valores de campos de problemas](/pt/rest/issues/issue-field-values).\n* **GraphQL**: tipos de campo de problema e mutações também estão disponíveis por meio do GraphQL. Consulte a [`IssueFields` união](/pt/graphql/reference/issues#union-issuefields), [os objetos de campo de emissão](/pt/graphql/reference/issues#object-issuefieldtext) (como `IssueFieldText`, `IssueFieldSingleSelect`, `IssueFieldNumber` e `IssueFieldDate`), e as [mutações](/pt/graphql/reference/issues#mutation-createissuefield) (como `createIssueField`, `updateIssueField` e `setIssueFieldValue`).\n\n## Automatizando com GitHub Actions\n\nAlterações de campo de problema disparam eventos de webhook no `issues` evento. Você pode usá-los como gatilhos de fluxo de trabalho:\n\n* `field_added`: é acionado quando um valor de campo é definido ou atualizado.\n* `field_removed`: é acionado quando um valor de campo é desmarcado.\n\nPor exemplo, para executar um fluxo de trabalho sempre que um valor de campo for alterado:\n\n```yaml\non:\n  issues:\n    types: [field_added, field_removed]\n```\n\nO conteúdo do evento inclui o nome do campo, o tipo, o valor e o valor anterior. Para obter mais informações, consulte [Eventos que disparam fluxos de trabalho](/pt/actions/reference/workflows-and-actions/events-that-trigger-workflows#issues)."}