Consulta por títulos, iDs y campos de texto enriquecido en Azure Boards y Azure DevOps

  • Artículo
  • 10 minutos para leer

Tipo de datos

Operadores y macros admitidos

Texto enriquecido (HTML)
Cadenas de texto de varias líneas (Texto sin formato)

Contiene palabras, no contiene palabras, está vacía (nota 1), no está vacía (nota 1)

Cadenas de texto de varias líneas (Texto sin formato)

Operadores y macros admitidos

Texto único (cadena)

= , <> , , , = , = , ><>< =[Field], <>> [Field], [Field], < [Field], > =[Field], < =[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Not In Group, Was Ever
Macros: [Any], válidas con el campo Tipo de elemento de trabajo
@Project (Nota 2), válido con el campo Team Project

GUID

= , <> , , , = , = , ><>< In, Not In
Macros: @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity válido con el campo id. y operadores In y Not In@Project (Nota 2), válidos con el campo Team Project

Campos Estadoy Tipo de elemento de trabajo

= , <> , , , = , = , ><>< =[Field], <>> [Field], [Field], < [Field], > =[Field], < =[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Not In Group, Was Ever
Macros: [Any] válidas con ambos campos

Nota

  1. Los operadores Is Empty y Is Not Empty se admiten para Azure DevOps Server 2019 RC2 y versiones posteriores
  2. La macro @Project es compatible con Azure Boards y TFS 2015.1 y versiones posteriores. El sistema establece automáticamente el filtrado de forma predeterminada en función del proyecto actual. Para más información, consulte Consulta entre proyectos.

Uso para Contains words coincidencias de cadena

Si desea filtrar por una coincidencia de cadena, intente usar el Contains Words operador en lugar de Contains . El Contains Words operador ejecuta una búsqueda de texto completo en el campo especificado, que es más rápido en la mayoría de los casos. La cadena de texto está limitada a 100 caracteres.

Mientras el operador ejecuta un examen de tabla, que no solo es más lento, sino que también Contains consume más ciclos de CPU. Estos ciclos de CPU contribuyen al límite de velocidad de consumo de recursos.

Consulta de palabras clave o frases con caracteres comodín

Use Contains or Contains Words (Contiene o contiene palabras) para enumerar los elementos que coinciden parcial o exactamente con las palabras o frases que escriba.

Editor de consulta de lista plana para filtrar palabras clave

Elija Contiene o No contiene para buscar coincidencias exactas o parciales de una palabra o frase. Elija Contains Words (Contienepalabras) o Does Not Contain Words (No contiene palabras) para buscar una frase exacta o para usar el carácter comodín *. Estos operadores utilizan el índice de búsqueda de texto completo.

Por ejemplo, especifique Contains Words einform* para filtrar por un campo de texto que contenga informacióno información o informativo.

Uso de caracteres comodín con Contains Words

Sugerencia

Para entender cómo se agrupan las cláusulas AND/OR, consulte Creación y guardado de consultas administradas, Cláusulas group. Para ver la sintaxis de WIQL de una consulta, instale la extensión del editor de consultas WIQL, que le permitirá ver la versión de WIQL de cualquier entrada de la interfaz de usuario de consulta.

Consulta de palabras específicas y no de otras

Use los operadores Contiene palabras y No contiene palabras para enumerar los elementos que coinciden exactamente con las palabras o frases que escriba y excluir otras palabras o frases. Puede usar estos operadores en combinación con el carácter comodín (*).

En el ejemplo siguiente, estos operadores filtran los elementos de trabajo para los elementos que contienen la fase de trabajo, pero no la palabra Phasor.

Captura de pantalla del Editor de consultas para incluir y excluir palabras exactas.

Consultas de valores de campo sin definir

Puede encontrar elementos de trabajo que tengan un valor de campo indefinido mediante el operador equals (=) y dejando el valor del campo en blanco. Por ejemplo, los filtros siguientes mostrarán todos los elementos de trabajo de tipo Task cuyo campo Activity está en blanco.

Filtrar en función de las entradas en blanco

Para enumerar los elementos de trabajo basados en un campo que no está en blanco, use el operador not ( ) y <> deje el valor en blanco.

Consultas de campo HTML vacías o no vacías

Puede encontrar elementos de trabajo en los que no se ha especificado ninguna descripción. El uso de Está vacío o No está vacío con un campo HTML permite enumerar elementos de trabajo con campos de texto enriquecido vacíos o no vacíos. No se especifica un valor con este operador.

Por ejemplo, los siguientes filtros de consulta mostrarán todos los elementos de trabajo en los que se han realizado algunas entradas en el campo Descripción.

Filtrar campos HTML no vacíos basados en filtros

Nota

La capacidad de consultar elementos de trabajo que no tienen etiquetas asociadas no es una característica admitida. Si desea votar la solicitud para admitir esta característica, puede hacerlo en nuestra página developer Community,Be able to search for empty tags (Buscar etiquetas vacías).

Consultas basadas en categorías

Para filtrar los elementos de trabajo en función de la categoría a la que pertenecen, use el operador In Group. Por ejemplo, los siguientes criterios de filtro devolverán todos los elementos de trabajo que se encuentran en el proyecto actual, asignados al miembro del equipo y definidos como pertenecientes a la Categoría de errores.

Cláusula de consulta para buscar elementos de trabajo por categoría

¿Qué elementos aparecen en las categorías Requisito o Tarea?

Las asignaciones predeterminadas de tipos de elementos de trabajo a cada categoría se enumeran a continuación para cada proceso.

Proceso Categoría de requisitos Categoría de la tarea:
Básico Incidencia Tarea
Agile Caso de usuario Tarea
Scrum Elemento de trabajo pendiente del producto, error Tarea
CMMI Requisito Tarea

Cada equipo puede determinar si el tipo de elemento de trabajo Error aparece en la categoría Requisito o Tarea. Consulte Show bugs on backlogs and boards (Mostrar errores en los paneles y los trabajo pendientes). Puede agregar tipos de elementos de trabajo personalizados a un trabajo pendiente. Para obtener más información, vea Agregar o modificar un tipo de elemento de trabajo, Agregar un WITpersonalizado a un trabajo pendiente o panel.

Consulta de elementos de trabajo que está siguiendo

Puede usar la macro @Follows para filtrar una lista en función de los elementos de trabajo que sigue junto con otros filtros de consulta.

Por ejemplo, la consulta siguiente muestra cómo consultar en todos los proyectos los elementos de trabajo activos que está siguiendo. Use el campo ID y el operador In con @Follows macro.

Editor de consultas, con id. en @Follows cláusula de consulta

Consulta de la actividad de elemento de trabajo reciente

Puede usar las macros siguientes para enumerar elementos de trabajo basados en la actividad reciente:

  • @MyRecentActivity:enumerar los elementos que ha visto o modificado recientemente
  • @RecentMentions:enumerar los elementos a los que se agregó a través de una @mention en los últimos 30 días
  • @RecentProjectActivity:enumera los elementos que se han creado o modificado recientemente en el proyecto.

Especifique el campo ID y los operadores In o Not In.

Por ejemplo, la consulta siguiente muestra cómo consultar los elementos de trabajo que ha visto o modificado recientemente.

Editor de consultas, con id. en @MyRecentActivity cláusula de consulta

Campos comunes para la mayoría de los tipos de elementos de trabajo

En la tabla siguiente se describen los campos comunes que se usan para filtrar las consultas. Los campos id. identifican de forma única los elementos de trabajo de una lista. Use el campo Título para distinguir el elemento de trabajo de todos los demás del mismo tipo. Los campos Descripción y otros campos de texto enriquecido (tipo de datos=HTML) proporcionan información adicional necesaria para implementar el trabajo y realizar un seguimiento de los cambios. Después de crear un elemento de trabajo, puede modificar todos los campos excepto el identificador. Al agregar y guardar un elemento de trabajo, el sistema asigna el identificador y no se puede cambiar.

Nota

El sistema indexa automáticamente todos los campos de texto largo con un tipo de datos de campos PlainText y HTML para la búsqueda de texto completo. Esto incluye los campos Título,Descripcióny Pasos para la reprobación. Para obtener más información y los requisitos de servidor e intercalación aplicables a los Azure DevOps locales, vea Consulta de campos, operadores,valores y variables: búsquedas de texto completo y palabras parciales.

Nombre del campo

Descripción

Tipo de elemento de trabajo

Criterios de aceptación 1

Descripción de los criterios que deben cumplirse antes de poder cerrar el error o el elemento de trabajo pendiente del producto.

Antes de comenzar a trabajar en un error o elemento de trabajo pendiente del producto, deben describirse los criterios de aceptación del cliente con tanta claridad como sea posible. Las conversaciones entre el equipo y los clientes para definir los criterios de aceptación ayudarán a garantizar que el equipo comprende las expectativas de los clientes. Los criterios de aceptación se pueden usar como base para las pruebas de aceptación, con el fin de que se pueda evaluar más eficazmente si un elemento se ha completado satisfactoriamente o no.

Nombre de referencia=Microsoft.VSTS.Common.AcceptanceCriteria, Tipo de datos=HTML

Error, Epopeya, Característica, Elemento de trabajo pendiente del producto (Scrum)

Descripción 1, 2

Use este campo para proporcionar información detallada sobre un elemento de trabajo.

Nombre de referencia=System.Description, Tipo de datos=HTML

All

ID

Identificador único que se ha asignado a un elemento de trabajo. Los identificadores de elemento de trabajo son únicos en todos los proyectos y dentro de una colección de proyectos.

Nombre de referencia=System.Id, Tipo de datos=Entero

All

Pasos de reproducción (o Pasos para reproducir) 1

Pasos necesarios para reproducir un comportamiento inesperado Capture información suficiente para que otros miembros del equipo puedan entender las consecuencias del problema, así como para ver si se corrigió el error. Esto incluye las acciones realizadas para buscar o reproducir el error y el comportamiento previsto.
Nombre de referencia=Microsoft.VSTS.TCM.ReproSteps, Tipo de datos=HTML

Error

Resolución

Describe cómo se resolvió un impedimento.

Nombre de referencia=Microsoft.VSTS.Common.Resolution, Tipo de datos=HTML

Impedimento (Scrum)

Información delsistema 1

Información sobre la configuración de software y sistema pertinente para el error, la revisión de código o los comentarios.

Nombre de referencia=Microsoft.VSTS.TCM.SystemInfo, Tipo de datos=HTML

Error, solicitud de revisión de código, solicitud de comentarios

Proyecto de equipo

Proyecto al que pertenece un elemento de trabajo. Agregue este campo a una consulta cuando desee filtrar la lista por elementos de uno o varios proyectos.

Nota

  Para Azure Boards o para TFS 2015.1 y versiones posteriores, debe comprobar la opción Consulta entre proyectos en el editor de consultas para que este campo aparezca en la lista desplegable de campos. Para obtener más información, vea Consultas de ejemplo, consulta en proyectosde .

Nombre de referencia=System.TeamProject, Tipo de datos=Cadena

Todo

Título

Breve descripción que resume lo que es el elemento de trabajo y que sirve para que los miembros del equipo lo distingan de los otros elementos de trabajo de una lista.

Nombre de referencia=System.Title, Tipo de datos=Cadena

Todo

Tipo de elemento de trabajo

Nombre del tipo de elemento de trabajo. Los tipos de elementos de trabajo se definen en función del proceso utilizado al crear el proyecto. Para obtener información general, vea Elegir el proceso. Para obtener información sobre cómo agregar un tipo de elemento de trabajo personalizado, vea Agregar o modificar un tipo de elemento de trabajo.

Para filtrar los elementos de trabajo en función de su asignación de categoría,puede usar los operadores En grupo y No en grupo y seleccionar una categoría en la lista desplegable.

Nombre de referencia=System.WorkItemType, Tipo de datos=Cadena

Todo

Nota

  1. Para obtener más información sobre cómo trabajar con campos de texto enriquecido, vea Compartir información dentro de elementos de trabajo.
  2. Tras la actualización a Team Foundation Server 2012, el campo Descripción se cambió de un tipo de campo de Texto sin formato a HTML. Con el comando witadmin changefield puede revertir el tipo de datos de este campo. Consulte Manage work item fields (witadmin) (Administrar campos de elemento de trabajo [witadmin]).

Recursos del SDK

Para interactuar mediante programación con consultas, vea Consulta de errores, tareas y otros elementos de trabajo.

Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013

Si desea buscar elementos de trabajo basados en una palabra clave o frase o un campo de texto nulo, puede hacerlo filtrando por campos de texto de una sola línea (Cadena), texto de varias líneas (Texto sin formato) y texto enriquecido (HTML). Si se da cuenta de que las consultas tarden demasiado tiempo en devolver resultados, revise la guía para crear consultas de alto rendimiento.

Operadores y macros admitidos

Las cláusulas de consulta que especifican un campo de texto o de texto enriquecido pueden usar los operadores y macros enumerados en la tabla siguiente.