Skip to main content

Adición y administración de campos de problemas

Puede establecer, editar y borrar valores de campo de problema en problemas individuales para capturar metadatos estructurados para su equipo.

¿Quién puede utilizar esta característica?

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

Nota:

Los campos de incidencias se encuentran actualmente en versión preliminar pública y están sujetos a cambios. Para compartir comentarios, consulte la discusión de la comunidad.

Los campos de incidencias aparecen en la barra lateral derecha de las incidencias, junto con campos del sistema como asignados, etiquetas y tipo. Puede establecer valores al crear o editar un problema. Al seleccionar un tipo de problema al crear un problema, los campos anclados a ese tipo aparecen automáticamente en la barra lateral.

Establecimiento de un valor de campo

  1. Navegue a la incidencia que desea actualizar.
  2. En la barra lateral derecha, si el campo que desea no está visible, haga clic en Agregar campo.
  3. En la lista desplegable, seleccione el campo que desea agregar.
  4. Establezca el valor:
    • Para campos de selección única , elija una opción en la lista desplegable.
    • En los campos de texto , escriba el valor. Las direcciones URL se detectan y se muestran automáticamente como vínculos.
    • Para los campos numéricos , escriba un valor numérico.
    • Para los campos de fecha , use el selector de fecha para seleccionar una fecha o escriba la fecha directamente.
  5. Los cambios se guardan automáticamente.

Edición de un valor de campo

  1. Navegue hasta la incidencia.
  2. En la barra lateral derecha, haga clic en el valor del campo que desea cambiar.
  3. Seleccione un nuevo valor o escriba una nueva entrada.
  4. Los cambios se guardan automáticamente.

Borrar un valor de campo

  1. Navegue hasta la incidencia.
  2. En la barra lateral derecha, haga clic en el valor del campo.
  3. Borre el valor:
    • Para los campos de selección única , haga clic en la opción seleccionada actualmente para anular la selección.
    • Para los campos de texto y número , elimine todo el texto de la entrada.
    • Para los campos de fecha , haga clic en el botón borrar del selector de fechas.
  4. Una vez borrado, el campo se quita de la barra lateral. Se puede volver a agregar mediante el botón Agregar campo .

Campos anclados

Si el administrador de la organización ha anclado campos a tipos de problemas específicos, esos campos aparecen automáticamente en la barra lateral y el modal de creación del problema al crear o ver un problema de ese tipo. No es necesario agregar manualmente campos anclados.

Visualización de los cambios en los campos en la línea de tiempo

Cuando se cambia un valor de campo, la actualización se registra en la escala de tiempo del problema. Las entradas de la línea de tiempo muestran:

  • Qué campo se cambió
  • Nuevo valor que se estableció
  • Quién ha realizado el cambio
  • Cuándo se realizó el cambio

Los eventos de la línea de tiempo para los campos establecidos con visibilidad "Solo organización" están ocultos para los usuarios que no son miembros de la organización o colaboradores.

Visibilidad de campos

Los administradores de la organización pueden establecer la visibilidad de cada campo en "Solo organización" o "Público". Esto afecta lo que ves:

  • Si un campo solo se establece en Organización, solo es visible para los miembros de la organización y los colaboradores del repositorio con al menos acceso de lectura. Si no es miembro o colaborador, el campo no aparece en la barra lateral de la incidencia, el historial o las sugerencias de búsqueda.
  • Si un campo está establecido en Público, es visible para cualquier persona que vea el problema.

Para obtener más información sobre cómo configurar la visibilidad, consulte Administración de campos de problemas en la organización.

Uso de campos de problema en proyectos

Los campos de problema se pueden agregar como columnas en vistas de proyecto, donde puede editar valores, agrupar, filtrar, ordenar y generar gráficos. Para obtener más información, vea Acerca de los campos de problemas en proyectos.

Buscar por valores de campo

Puede filtrar y buscar problemas en función de los valores de campo en el panel de problemas y en la página de problemas del repositorio. En la barra de búsqueda, escriba field. seguido del nombre y el valor del campo. Por ejemplo:

  •         `field.priority:high` para encontrar problemas con la prioridad establecida en "alta"
    
  •         `field."target date":>=2026-03-01` para encontrar problemas con una fecha de destino el 1 de marzo de 2026 o después
    
  •         `field.priority:high,medium` para encontrar problemas con la prioridad establecida en "alto" o "medio"
    

Para obtener más información, vea Filtrar y buscar propuestas y solicitudes de cambios.

Uso de campos de problema con la API

Los campos de problema tienen compatibilidad completa con REST y GraphQL API. Puede automatizar la administración de campos, establecer valores mediante programación e integrarlos con herramientas externas.

  •         **Administrar campos**: crear, actualizar y eliminar campos de nivel de organización. Consulte la [API REST de los campos de problemas de la organización](/rest/orgs/issue-fields).
    
  •         **Uso de campos**: obtener, establecer y borrar valores de campo en problemas individuales. Consulte la [API REST de valores de campo Issue](/rest/issues/issue-field-values).