Vínculo a elementos de trabajo desde otros objetos

  • Artículo
  • 8 minutos para leer

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018- TFS 2015

Al vincular a elementos de trabajo de otros objetos, como compilaciones, confirmaciones, solicitudes de extracción, etc., se admite la capacidad de su equipo de mantener una pista de auditoría del trabajo relacionado. Todos los usuarios pueden agregar vínculos a sus elementos de trabajo.

Puede escribir desde #ID las siguientes áreas para vincular a los elementos de trabajo:

  • Una discusión de elementos de trabajo o cualquier campo de texto enriquecido
  • Comentarios de confirmación de Git y descripciones de solicitudes de extracción
  • Comentarios de conjunto de cambios o conjunto de cambios de TFVC
  • Páginas wiki
  • Una discusión sobre elementos de trabajo
  • Comentarios de confirmación de Git y descripciones de solicitudes de extracción
  • Comentarios de conjunto de cambios o conjunto de cambios de TFVC

Sugerencia

Puede configurar la vinculación automática y otras opciones que vinculen elementos de trabajo a confirmaciones de Git, solicitudes de extracción, compilaciones, etc. Para obtener información sobre cómo hacerlo, consulte los siguientes recursos:

Los tipos de vínculo que se usan para vincular elementos de trabajo a objetos de devops , como se muestra en la siguiente imagen, son Build, Found in build, Integrated in build, Integrated in release for build and release pipelines; Branch, Commit, Pull Requesty Tag para repositorios de Git, y Changeset, Shelveset y VersionedItem para Control de versiones de Team Foundation repositorios de Control de versiones de Team Foundation (TFVC). Todos se designan como tipos de vínculo externos.

Imagen conceptual de los tipos de vínculo usados para vincular elementos de trabajo a objetos de desvía.

En el formulario de elemento de trabajo, pestaña Vínculos, puede ver todos los objetos vinculados al elemento de trabajo como se describe más adelante en este artículo. Sin embargo, no se puede crear una consulta de elemento de trabajo para enumerar esos vínculos. Las consultas de elementos de trabajo solo devuelven elementos de trabajo vinculados a otros elementos de trabajo. Sin embargo, puede crear una consulta que enumera los elementos de trabajo que contienen vínculos externos. Para obtener información sobre cómo hacerlo, consulte Consulta por vínculo o recuento de datos adjuntos.

Nota

También puede vincular a elementos de trabajo desde GitHub, solicitudes de extracción y problemas. Para ello, es necesario conectar Azure DevOps proyecto al GitHub repositorio. Para más información, consulte Integración Boards-GitHub Azure.

Nota

La #ID característica está disponible en TFS 2015 Update 1 y versiones posteriores.

  1. Escriba para desencadenar el selector de elementos de trabajo en las confirmaciones de la solicitud de extracción, los comentarios de confirmación, los comentarios del conjunto de cambios, los comentarios del conjunto de cambios, la descripción ##ID y mucho más. Verá una lista de 50 elementos de trabajo que ha modificado recientemente o que se le han asignado.

    Captura de pantalla de la lista de elementos de trabajo que se genera al escribir # en la descripción de la pr.

  2. Limite la lista de elementos de trabajo sugeridos especificando palabras clave que coincidan con el tipo, el identificador o el título del elemento de trabajo.

    Captura de pantalla de la especificación de la palabra clave después de # y el elemento de trabajo resultante en la búsqueda

    Para filtrar aún más la lista, siga especificando palabras clave hasta que encuentre una coincidencia. Puede escribir hasta cinco palabras clave.

Nota

Requiere TFS 2015 Update 2 o una versión posterior.

Establecimiento del estado del elemento de trabajo en la solicitud de extracción

Al crear una solicitud de extracción, puede establecer el valor de estado de los elementos de trabajo vinculados en la descripción. Siga la sintaxis: {state value}: #ID . Al combinar la solicitud de extracción, el sistema lee la descripción y actualiza el estado del elemento de trabajo. En el ejemplo siguiente, establecemos los elementos de trabajo #300 y #301 en Resuelto, y #323 y #324 en Cerrado.

Captura de pantalla de la configuración del estado del elemento de trabajo dentro de una pr.

Nota

Esta característica requiere la instalación Azure DevOps Server actualización 2020.1. Para obtener más información, Azure DevOps Server notas de la versión de 2020 Update 1 RC1, Boards.

Cómo funciona

El sistema tiene en cuenta los tres criterios diferentes siguientes (en este orden) al intentar establecer el estado de los #mentioned de trabajo:

  • State
  • Categoría de estado
  • palabra clave

Lógica de criterios

En la tabla siguiente se describe la lógica.

Criterios Acción
Si el valor coincide con un estado, A continuación, estadónla en ese estado.
De lo contrario, si el valor coincide con una categoría de estado, A continuación, establezca el elemento de trabajo en el primer estado de esa categoría. Vea la nota siguiente.
Si el valor coincide con una palabra clave, A continuación, establezca el elemento de trabajo en el estado de la palabra clave correspondiente. Vea la tabla siguiente.
Más Ignórese y no haga nada.

Lógica de palabra clave

La lógica de palabra clave ayuda con la coincidencia de intenciones. Por ejemplo, podría escribir "Resuelve", pero realmente quería "Resuelto".

Palabra clave Acción
Propuesta, Propuestas, Proponer Establezca en el primer estado de la categoría Propuesta.
InProgress Establezca en el primer estado de la categoría En curso.
Completado, Completado, Completo Establezca en el primer estado de la categoría Completado.
Resuelto, Resuelve, Resolver Establezca en el primer estado de la categoría Resuelto.
Correcciones, Fijas, Corrección Cierre el elemento de trabajo. Excepto Error, que se establece en Resuelto.

Nota

La coincidencia de categorías no se admite en proyectos que usan un proceso XML hospedado. La coincidencia de categorías solo está disponible para los proyectos que usan un proceso heredado.

Puede vincular elementos de trabajo a compilaciones existentes desde el cuadro de diálogo Agregar vínculo. Estas compilaciones pueden estar dentro del proyecto o de otros proyectos de su organización o colección.

Nota

Esta característica requiere la instalación Azure DevOps Server actualización 2020.1. Para obtener más información, Azure DevOps Server notas de la versión de 2020 Update 1 RC1, Boards.

  1. En la pestaña Vínculos de un elemento de trabajo, elija Agregar vínculo Elemento existente.

  2. En el cuadro de diálogo Agregar vínculo, elija uno de los tipos de vínculo de compilación:Compilación,Encontrado en compilación, Integrado en compilación y especifique el número de compilación.

    Si no conoce el número de compilación (una combinación de la canalización y el nombre de la compilación), puede buscarlo eligiendo el icono .

    Cuadro de diálogo Agregar vínculo con Tipo de vínculo de compilación seleccionado.

  3. En el cuadro de diálogo Vincular compilaciones, elija los parámetros para filtrar la búsqueda de compilaciones.

    Si se vincula a una compilación en un proyecto diferente, elija primero la Project a la que desea vincular la compilación.

    Por ejemplo, puede especificar un número de compilación, seleccionar una canalización de compilación, un resultado de compilación, como All, succeeded, partially succeeded, failedo canceled. O bien, con Todo seleccionado en Resultado,elija Buscar para enumerar las compilaciones disponibles a las que vincular.

    Cuadro de diálogo Buscar compilaciones con el proyecto seleccionado y compilaciones enumeradas.

  4. Elija la compilación de la lista a la que desea vincular y, a continuación, elija Aceptar.

  5. En el cuadro de diálogo Agregar vínculo, elija Aceptar para completar la operación.

    Cuadro de diálogo Agregar vínculo con el número de compilación rellenado.

Puede vincular elementos de trabajo a compilaciones existentes desde el cuadro de diálogo Agregar vínculo.

  1. En la pestaña Vínculos de un elemento de trabajo, elija Agregar vínculo Elemento existente.

  2. En el cuadro de diálogo Agregar vínculo, elija uno de los tipos de vínculo de compilación:Compilación,Encontrado en compilación, Integrado en compilación y especifique el número de compilación.

    Si no conoce el número de compilación (una combinación de la canalización y el nombre de la compilación), puede buscarlo eligiendo el icono .

    Cuadro de diálogo Agregar vínculo con Tipo de vínculo de compilación seleccionado.

  3. En el cuadro de diálogo Vincular compilaciones, elija los parámetros para filtrar la búsqueda de compilaciones.

    Por ejemplo, puede especificar un número de compilación, seleccionar una canalización de compilación, un resultado de compilación, como All, succeeded, partially succeeded, failedo canceled. O bien, con Todo seleccionado en Resultado,elija Buscar para enumerar las compilaciones disponibles a las que vincular.

    Cuadro de diálogo Buscar compilaciones, vínculo a una compilación dentro del proyecto.

  4. Elija la compilación de la lista a la que desea vincular y, a continuación, elija Aceptar.

  5. En el cuadro de diálogo Agregar vínculo, elija Aceptar para completar la operación.

    Cuadro de diálogo Agregar vínculo con el número de compilación rellenado.

Vínculo a elementos de trabajo desde una página Wiki

Escriba # para desencadenar el selector de elementos de trabajo desde una página #ID Wiki.

Para obtener más información sobre la wiki integrada, vea Agregar páginas wiki de edición e Instrucciones de Markdown de Wiki.

También puede vincular una tabla de resultados de consulta a una wiki. Esto admite el acceso rápido a cada elemento de trabajo vinculado de la consulta. Para más información, consulte la guía de Markdown de Wiki.

Ver lista de objetos vinculados

Para ver la lista de todos los objetos vinculados a un elemento de trabajo, abra el elemento de trabajo y elija la pestaña Vínculos. La pestaña vínculos indica el recuento de todos los objetos vinculados.

Captura de pantalla de la pestaña Vínculos con el recuento de objetos vinculados.

Los objetos vinculados se agrupan en su tipo de vínculo, con un recuento dentro de cada grupo. Puede expandir o contraer cada grupo y ordenar dentro de cada grupo por Estado ,Actualización más recienteo Comentario eligiendo el título de columna correspondiente.

Por ejemplo, la pestaña Vínculos siguiente muestra una parte de los 64 objetos vinculados para un elemento de trabajo.

Captura de pantalla de la pestaña Vínculos con muchos objetos vinculados.

Los vínculos precedido por el signo de exclamación rojo indican que se ha eliminado la compilación, la versión u otro objeto. Esto suele deberse a directivas de retención que eliminan automáticamente estos objetos una vez transcurrido un período de tiempo determinado.

Azure Repos, Git