Consulta por asignación o cambios de flujo de trabajo en Azure Boards

Consulta de cambios en un panel Kanban

Con los campos de consulta Kanban (Columna de panel, Columna de panel listo y Línea de placa), puede enumerar los elementos de trabajo según su estado de flujo en el panel Kanban. Además, puede crear un gráfico de tendencias o de estado basado en estas consultas.

Puede enumerar los elementos en función de la ruta de acceso del área de equipo y si están en una columna kanban y una calle personalizadas específicas. Si cambia el nombre de una columna o calle, deberá actualizar los filtros de consulta para reflejar el nuevo nombre. Para obtener más ideas, vea esta entrada de blog: Los nuevos campos aportan a kanban las mejores calidades a las consultas, y mucho más.

Campos de panel kanban y flujo de trabajo

Los campos siguientes son útiles para filtrar las consultas. Algunos de estos campos se actualizan a medida que un elemento de trabajo progresa de un estado a otro. O bien, se actualizan a medida que mueve un elemento de trabajo del panel Kanban a otra columna o calle. Algunos de estos campos no aparecen en el formulario de elemento de trabajo, pero se realiza un seguimiento de esos tipos de elementos de trabajo enumerados en la tabla siguiente.

Para obtener más información sobre los atributos de campo, vea Campos y atributos de elementos de trabajo.

Campos de flujo de trabajo

Puede usar los campos siguientes para filtrar las consultas o generar informes. Algunos de estos campos se rellenan con información a medida que un elemento de trabajo progresa de un estado a otro. Algunos de estos campos no aparecen en el formulario de elemento de trabajo, pero se realiza un seguimiento de esos WIT enumerados en la tabla siguiente. Para obtener más información sobre los atributos de campo, vea Campos y atributos de elementos de trabajo.

1. Vea Campos de fecha e identidad.

2. De forma predeterminada, el servidor sincroniza los campos definidos por el sistema person-name o Identity-based con Active Directory o Azure Active Directory. Estos campos incluyen: Activado por, Asignado a, Cerrado por, Creado por y Resuelto por. Puede conceder acceso a un proyecto agregando grupos de seguridad creados en AD o Azure AD o agregando cuentas a grupos existentes o personalizados definidos desde la página Seguridad de la configuración de recopilación. Vea Configurar Active Directory o Azure Active Directory.

   Para las implementaciones locales, puede habilitar o deshabilitar la sincronización de un campo de nombre de persona mediante la herramienta de línea de comandos witadmin changefields. También puede sincronizar campos personalizados de nombre de persona especificando el atributo syncnamechanges. Vea Administrar campos de elemento de trabajo y Referencia de elemento FIELD (Definición).

3. Campo que se puede notificar con el atributo establecido en Dimensión. Solo es válido cuando la colección está configurada para admitir el modelo XML local. Los datos notificables se exportan al almacenamiento de datos y se pueden incluir en Excel o SQL Server informes. En el caso de Azure DevOps, use el comando witadmin changefield para cambiar el atributo que se puede notificar de un campo.

4. Campo indexado. La habilitación de la indexación para un campo puede aumentar el rendimiento de la búsqueda de elementos de trabajo cuyas consultas especifican ese campo. En el caso de Azure DevOps, use el comando witadmin indexfield para cambiar el atributo index de un campo.

5. La Categoría de requisitos se aplica a todos los tipos de elementos de trabajo que aparecen en el trabajo pendiente del producto y en el panel Kanban. La categoría incluye los elementos agregados a la categoría de errores en función de la configuración del equipo para Mostrar errores en paneles y trabajo pendiente. Para obtener más información sobre las categorías de tipo de elemento de trabajo, vea Usar categorías para agrupar tipos de elementos de trabajo.

1. De forma predeterminada, el servidor sincroniza los campos de nombre de persona definidos por el sistema con Active Directory o Azure Active Directory, si estos componentes están configurados. Estos campos incluyen: Activado por, Asignado a, Cerrado por, Creado por y Resuelto por. Puede conceder acceso a un proyecto agregando grupos de seguridad creados en AD o Azure AD o agregando cuentas a grupos existentes o personalizados definidos desde la página Seguridad de la configuración de recopilación. Vea Configurar Active Directory o Azure Active Directory.

   Puede habilitar o deshabilitar la sincronización de un campo de nombre de persona mediante la herramienta de línea de comandos witadmin changefields. También puede sincronizar campos personalizados de nombre de persona especificando el atributo syncnamechanges. Vea Administrar campos de elemento de trabajo y Referencia de elemento FIELD (Definición).

2. Campo que se puede notificar con el atributo establecido en Dimensión. Los datos notificables se exportan al almacenamiento de datos y se pueden incluir en Excel o SQL Server informes. Para el servidor local, use el comando witadmin changefield para cambiar el atributo que se puede notificar de un campo.

3. Campo indexado. La habilitación de la indexación para un campo puede aumentar el rendimiento de la búsqueda de elementos de trabajo cuyas consultas especifican ese campo. Para el servidor local, use el comando witadmin indexfield para cambiar el atributo de índice de un campo.

Para limitar el ámbito de las identidades disponibles para la selección a solo los usuarios agregados al proyecto, puede hacerlo mediante el grupo Project de usuarios con ámbito. Para obtener más información, vea Limitar la búsqueda y selección de identidades.

Campos de fecha e identidad

Se establecen varios campos de fecha e identidad en función de los estados o transiciones del flujo de trabajo. El sistema establece algunos campos, como Creado por y Fecha decreación, cuando se agrega un elemento de trabajo. Otros campos, como Closed Date y Closed By, se establecen a través de la definición de flujo de trabajo del tipo de elemento de trabajo. Además, los tipos de elementos de trabajo personalizados pueden tener otras reglas definidas que influyen en las asignaciones de campos de fecha e identidad.

Cambios de estado

En el siguiente ejemplo de sintaxis XML se muestran las reglas que se pueden definir para un tipo de elemento de trabajo que rigen los valores de los campos seleccionados. En este caso, los campos Resolved Date, Resolved By, Closed Date, Closed By, Activated Datey Activated By se establecen en cuando un valor De estado se establece en Nuevo. Las asignaciones de valores de estado se evalúan primero y, a continuación, las asignaciones de transición se evalúan a continuación.

   <WORKFLOW>
      <STATES>
        <STATE value="New">
          <FIELDS>
            <FIELD refname="Microsoft.VSTS.Common.ResolvedDate">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ResolvedBy">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ResolvedReason">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ClosedDate">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ClosedBy">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ActivatedDate">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ActivatedBy">
              <EMPTY />
            </FIELD>
          </FIELDS>
        </STATE>
        <STATE value="Active">
          <FIELDS>
            <FIELD refname="Microsoft.VSTS.Common.ResolvedDate">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ResolvedBy">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ResolvedReason">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ClosedDate">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ClosedBy">
              <EMPTY />
            </FIELD>
          </FIELDS>
        </STATE>
        <STATE value="Resolved">
          <FIELDS>
            <FIELD refname="Microsoft.VSTS.Common.ClosedDate">
              <EMPTY />
            </FIELD>
            <FIELD refname="Microsoft.VSTS.Common.ClosedBy">
              <EMPTY />
            </FIELD>
          </FIELDS>
        </STATE>
        <STATE value="Closed" />
      </STATES>

Asignaciones de transición de fecha activada por y activada

Cuando se producen las siguientes transiciones para un elemento de trabajo Error, se realizan las siguientes asignaciones a los campos Activated By (Activado por) y Activated Date (Fecha activada):

<TRANSITION from="" to="New">
<TRANSITION from="New" to="Active">
<TRANSITION from="New" to="Resolved">
<TRANSITION from="New" to="Closed">
<TRANSITION from="Resolved" to="Active">
<TRANSITION from="Closed" to="Active">

<FIELDS>
   <FIELD refname="Microsoft.VSTS.Common.ActivatedBy">
       <COPY from="currentuser" />
           <VALIDUSER />
           <REQUIRED />
    </FIELD>
    <FIELD refname="Microsoft.VSTS.Common.ActivatedDate">
        <SERVERDEFAULT from="clock" />
   </FIELD>
</FIELDS>

Y cuando se producen las siguientes transiciones para el elemento de trabajo Error:

<TRANSITION from="Active" to="New">
<TRANSITION from="Active" to="Closed">
<TRANSITION from="Resolved" to="Closed">

A continuación, los campos Activated By (Activado por) y Activated Date (Fecha activada) se establecen en READONLY .

<FIELD refname="Microsoft.VSTS.Common.ActivatedDate">
   <READONLY />
</FIELD>
<FIELD refname="Microsoft.VSTS.Common.ActivatedBy">
   <READONLY />
</FIELD>

Campos Activated By/Date y Resolved By/Date

El sistema actualiza estos campos(Activadopor , Fechaactivada , Resueltopor y Fecharesuelta) cuando se produce un cambio en función de los estados de categoría de flujo de trabajo correspondientes. Cuando el estado del flujo de trabajo cambia a una categoría de estado Propuesto, se actualizan Activated By (Activado por) y Activated Date (Fecha activada). Cuando el estado del flujo de trabajo cambia a una categoría de estado Resuelto, se actualizan Resolved By (Resuelto por) y Resolved Date (Fecha resuelta).

Para obtener más información sobre cómo se asignan los estados de flujo de trabajo a las categorías de estado, vea Cómo se usan los estados de flujo de trabajo y las categorías de estado en los backlogs y Boards.

Dado que estos campos hacen referencia a las categorías de estado de flujo de trabajo, se hace referencia a los estados de flujo de trabajo personalizados que agregue al actualizar los campos. Para más información sobre la personalización, consulte Personalización del flujo de trabajo de un proceso.

Notas adicionales:

• Los campos se actualizan cada vez que un elemento de trabajo se mueve desde cualquier estado de categoría distinto del establecido. Por ejemplo, si actualiza un elemento de trabajo de Nuevo a Fijo ,se actualizan los campos Resolved By/Resolved Date (Fecha resuelta por/Resuelta). Sin embargo, si actualiza desde Fijo y Listo para pruebas (quese encuentran en el mismo estado de categoría), los campos Resolved By/Resolved Date no se actualizan.
• Al realizar la transición hacia atrás, como pasar de un estado Resuelto a Activo, el sistema borra los valores de los campos Resolved By/Resolved Date . Si ha pasado de Activo a Nuevo,el sistema borra los valores de los campos Activated By/Activated Date (Fecha activada por/Activado).
• No cambie manualmente los valores de estos campos. Son campos del sistema que se rigen por reglas del sistema. Cualquier valor que intente establecer se escribirá en exceso.

API de REST

Para interactuar mediante programación con las consultas, consulte uno de estos recursos de API REST:

• Azure DevOps Services referencia de la API REST
• Consultas
• Lenguaje de consulta de elementos de trabajo
• Sintaxis del lenguaje de consulta de elementos de trabajo (WIQL)
• Capturar elementos de trabajo con consultas mediante programación

Recursos del SDK

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