Agregar consultas de elementos de trabajo a una plantilla de proceso

  • Artículo
  • 4 minutos para leer

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

Importante

Este artículo se aplica a la personalización de proyectos para los modelos de proceso XML locales. Para obtener información general sobre los modelos de proceso, consulte Personalización de la experiencia de seguimiento de trabajo.

Al agregar consultas de elementos de trabajo a la plantilla de proceso, puede definir el conjunto inicial de consultas compartidas y la estructura de carpetas de consulta para un proyecto. Todos los miembros del equipo usan consultas para buscar errores, tareas y otros elementos de trabajo sobre los que deben efectuar alguna acción.

Las consultas de elemento de trabajo especifican criterios para generar una lista de elementos de trabajo (por ejemplo, una lista de errores activos o tareas cerradas). Los archivos para las consultas de elementos de trabajo tienen una extensión .wiq y se almacenan en la subcarpeta Consultas de la carpeta Seguimiento de WorkItem para las plantillas de proceso predeterminadas.

Importante

Las plantillas de proceso predeterminadas definen algunas consultas que aparecen en Mis consultas en la página Consultas. Ya no definen consultas compartidas. Siempre puede definir consultas compartidas y agregarlas a una plantilla de proceso personalizada. Las definiciones de consulta dependen de los campos y los tipos de elemento de trabajo definidos en la plantilla de proceso. Además, algunos libros que se cargan en el complemento de portal dependen de las definiciones de consulta.

Importante

Las plantillas de proceso predeterminadas definen varias consultas que difieren en función del proceso:Agile,Scrumo CMMI. Las definiciones de consulta dependen de los campos y los tipos de elemento de trabajo definidos en la plantilla de proceso. Además, algunos libros que se cargan en el complemento de portal dependen de las definiciones de consulta.

Especifique las definiciones de consulta que se deben cargar como una tarea dentro del complemento WorkItemTracking. Esta tarea puede ser necesaria porque varios artefactos de una plantilla de proceso pueden depender de una consulta. Además, la tarea de cargar las consultas depende de la finalización correcta de la tarea que carga los tipos de elemento de trabajo. Especifique cada archivo de consulta que se va a cargar dentro del elemento taskXml.

Después de crear un proyecto a partir de la plantilla de proceso, puede agregar, quitar y cambiar consultas mediante el Editor de consultas. Para obtener más información, vea Usar el editor de consultas para enumerar y administrar consultas.

Para obtener información sobre cómo asignar permisos de consulta a grupos, vea Control del acceso a las áreas funcionales. Para obtener información sobre cómo crear carpetas de consulta, vea Definir objetos para el seguimiento de elementos de trabajo.

Creación de un archivo de consulta de elemento de trabajo (.wiq)

Cada definición de consulta debe especificarse en su propio archivo con una extensión de .wiq, mediante el elemento primario WorkItemQuery, y ajustarse al esquema definido en el archivo wiq.xsd.

En el ejemplo siguiente se muestra la estructura de sintaxis de alto nivel que define una consulta de elemento de trabajo:

<WorkItemQuery Version="1">  
<TeamFoundationServer>collectionURL</TeamFoundationServer>  
<TeamProject>TeamProjectName</TeamProject>  
  <Wiql>  
      WorkItemQueryLanguage  
  </Wiql>  
</WorkItemQuery>

Para obtener más información sobre cómo crear una consulta de elemento de trabajo para agregarla a una plantilla de proceso, vea Definir una consulta de elemento de trabajo.

Especificación de las consultas que se cargarán

Para incluir las consultas de elemento de trabajo en la plantilla de proceso, cree una o más tareas en el archivo workitems.xml que encontrará en la carpeta \WorkItem Tracking, situada en la carpeta en la que descargó la plantilla de proceso. Use el elemento Query para especificar el archivo de la consulta de elemento de trabajo. Por ejemplo, el siguiente código XML especifica la consulta que se define en el archivo ActiveBugs.wiq que se va a cargar, denominado Active Bugs.

<Query name="Active Bugs" fileName="WorkItem Tracking\Queries\ActiveBugs.wiq" /

Agregue el conjunto de consultas que se va a cargar como una tarea en el complemento WorkItemTracking.

En el ejemplo siguiente se muestra cómo especificar una tarea para crear una carpeta de consulta denominada Product Management y cargar una consulta denominada All User Stories en dicha carpeta.

<task id="Queries" name="Stored Query Definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage=" Work item queries uploaded" / 
   <dependencies 
      <dependency taskId="WITs" / 
   </dependencies 
   <taskXml 
      <QUERIES 
         <QueryFolder name="Product Management"  
               <Query name="All User Stories" fileName="WorkItem Tracking\Queries\AllUserStories.wiq" / 
         </QueryFolder 
         . . .  
      </QUERIES 
   </taskXml 
</task

Para obtener más información, vea Definir objetos para realizar el seguimiento de elementos de trabajo.

Elementos QUERY

La sintaxis siguiente muestra la estructura del elemento QUERIES y sus elementos secundarios.

<QUERIES 
      <Permission / 
      <QueryFolder  
      <Query / 
      </QueryFolder 
</QUERIES

En la tabla siguiente se describen los elementos que se usan para especificar la estructura de las carpetas de consulta, los permisos y las consultas que se van a cargar. Estos elementos se especifican dentro de un elemento contenedor taskXml en el archivo de complemento WorkItemTracking.

Elemento Descripción y sintaxis
Permiso Elemento secundario opcional de Query. Especifica los permisos predeterminados que se asignan a las consultas compartidas. Para obtener más información, vea Asignación de permisos para consultas de elementos de trabajo.
<permission allow="ListOfPermissions" identity="GroupName" />
Consultar Elemento secundario requerido de QUERIES. Especifica el nombre y la ruta de acceso del archivo .wiq que define una consulta que se va a cargar.
<Query name="QueryName" fileName="QueryFilePathName" />

Como se muestra en el ejemplo siguiente, puede cargar la consulta con la etiqueta "¿Errores activos? y que se define en el archivo Active Faq.wiq:

<Query name="Active Bugs" fileName="WorkItem Tracking\Queries\ActiveBugs.wiq" />
QueryFolder Elemento secundario opcional de QUERIES. Especifica el nombre de la carpeta de una consulta.
QueryFolder name="FolderName">
<Consulta />
</QueryFolder>
CONSULTAS Elemento secundario opcional del elemento taskXml para el complemento WorkItemTracking. Especifica qué archivos de definición de consulta se usan para crear las consultas predeterminadas.
CONSULTAS>
. . .
</QUERIES>