Compartir vía


Uso de Azure Repos con Microsoft Teams

Azure DevOps Services

Si usa Microsoft Teams y Azure Repos, puede usar la aplicación Azure Repos para Teams a fin de supervisar los repositorios. La aplicación admite la supervisión de repositorios de Git y de Control de versiones de Team Foundation (TFVC), pero no admite la integración con repositorios de GitHub.

En este artículo, descubrirá cómo realizar las tareas siguientes:

  • Agregar la aplicación Azure Repos al equipo en Microsoft Teams
  • Conexión de la aplicación Azure Repos a los repositorios
  • Administrar suscripciones a eventos relacionados con el repositorio en el canal
  • Buscar y compartir información de PR mediante la extensión de redacción
  • Obtener una vista previa de las direcciones URL de PR
  • Eliminar suscripciones y repositorios de un canal

Requisitos previos

Nota:

  • Actualmente no se admiten notificaciones dentro de mensajes directos.
  • Solo puede vincular la aplicación Azure Repos para Microsoft Teams a un proyecto hospedado en Azure DevOps Services.

Incorporación de la aplicación Azure Repos a un equipo en Microsoft Teams

  1. Vaya a la aplicación Azure Repos en Microsoft Teams, Microsoft Teams > Azure Repos.

  2. Seleccione Agregar o, si ya ha descargado la aplicación, seleccione el menú desplegable situado junto a Abrir y, después, seleccione Agregar a un equipo.

  3. Escriba un nombre de equipo o canal y, después, seleccione Configurar un bot.

    Captura de pantalla del mensaje de bienvenida de Azure Repos en Teams.

Conexión de la aplicación Azure Repos a los repositorios

  1. Una vez instalada la aplicación en el equipo, escriba el texto siguiente en el campo de respuesta: @azure repos signin.

    Si Microsoft Teams y Azure Boards están en diferentes inquilinos, seleccione Sign in with different email (Iniciar sesión con un correo electrónico diferente).

    Captura de pantalla en la que se muestra la entrada del inicio de sesión de Teams para Azure Repos.

    Captura de pantalla que muestra la respuesta completa de inicio de sesión.

  2. Para supervisar todos los repositorios de Git de un proyecto, escriba @azure repos subscribe [project url] en el canal. Asegúrese de agregar la dirección URL del proyecto. La dirección URL del proyecto puede estar en cualquier página del proyecto (excepto las direcciones URL de los repositorios).

    También puede supervisar un repositorio específico mediante @azure repos subscribe [repo url].

    La dirección URL del repositorio puede estar en cualquier página del repositorio que tenga el nombre del repositorio; por ejemplo, @azure repos subscribe https://dev.azure.com/myorg/myproject/_git/myrepo o, para los repositorios de TFVC, @azure repos subscribe https://dev.azure.com/myorg/myproject/_versionControl.

  3. El comando subscribe le ayudará a empezar con una suscripción predeterminada. En el caso de los repositorios de Git, el canal se suscribe al evento PR creada (con la rama de destino = principal). En el caso de los repositorios de TFVC, el canal se suscribe al evento Código insertado en el repositorio.

    Captura de pantalla que muestra el mensaje de creación de suscripciones predeterminadas.

Administrar suscripciones

A fin de ver, agregar y quitar suscripciones para un canal, escriba el texto siguiente: @azure repos subscriptions.

Verá una lista de todas las suscripciones actuales para el canal y podrá agregar nuevas suscripciones o quitar las existentes. Personalice las notificaciones con varios filtros, tal como se describe en la sección siguiente.

Nota:

Los administradores del equipo no pueden quitar ni modificar suscripciones que hayan creado los administradores del proyecto.

Ver suscripciones

Uso de filtros para obtener solo las notificaciones que se quieran

Cuando se suscribe a un repositorio con @azure repos subscribe, se crea una suscripción predeterminada sin filtros aplicados. A menudo, los usuarios deben personalizar estas suscripciones para recibir notificaciones solo cuando se cumplen determinadas condiciones. En las capturas de pantalla siguientes se muestra un ejemplo de configuración de notificaciones solo cuando nuestro equipo está en la lista de revisores de una PR.

  1. Escriba el texto siguiente en el canal: @azure repos subscriptions.

  2. En la lista de suscripciones, si hay una suscripción que no quiere o que debe modificarse, seleccione Quitar para eliminarla.

  3. Seleccione el botón Agregar suscripción.

  4. Elija un tipo de evento y, después, seleccione Siguiente.

    Captura de pantalla que muestra la selección del tipo de evento.

  5. Elija un repositorio y, después, seleccione Siguiente.

    Captura de pantalla que muestra la selección del repositorio.

  6. Seleccione los filtros adecuados para personalizar la suscripción y, después, seleccione Enviar.

    Captura de pantalla que muestra los filtros elegidos.

Nota:

  • Todos los filtros suelen ser listas desplegables. Pero si la lista desplegable tiene más de 100 elementos, tendrá que escribir manualmente los valores.
  • Para el evento Código insertado en el repositorio de TFVC, el filtro Bajo la ruta debe tener el formato $/myproject/path.

Búsqueda y uso compartido de información de PR mediante la extensión de redacción

Para ayudar a los usuarios a buscar y compartir información sobre las PR, la aplicación Azure Repos para Microsoft Teams admite una extensión de redacción. Puede buscar PR por id. o por nombre. Para que la extensión funcione, inicie sesión en el proyecto de Azure Repos escribiendo @azure repos signin o iniciando sesión directamente en la extensión de redacción.

Captura de pantalla que muestra la extensión de redacción.

Vista previa de las direcciones URL de PR

Al pegar la dirección URL de una PR, se muestra una vista previa como la de la imagen siguiente, lo que ayuda a mantener el contexto y la precisión de las conversaciones relacionadas con PR. Debe iniciar sesión y, después, puede obtener una vista previa de las PR de las direcciones URL de todos los canales de un equipo.

Captura de pantalla que muestra el despliegue de direcciones URL.

Eliminar suscripciones y repositorios de un canal

Para eliminar todas las suscripciones relacionadas con cualquier repositorio del proyecto y quitar los repositorios del canal, escriba el texto siguiente en Teams: @azure repos unsubscribe all [project url]. Asegúrese de escribir la dirección URL del proyecto. Solo los administradores del proyecto pueden realizar esta tarea.

Notificaciones de subproceso

Para vincular un conjunto de notificaciones relacionadas y también para reducir el espacio que ocupan las notificaciones en un canal, las notificaciones se subprocesan. Todas las notificaciones vinculadas a una PR determinada están vinculadas juntas.

Vista compacta de las notificaciones de subprocesoCaptura de pantalla que muestra la vista compacta de las notificaciones de subproceso.

Vista expandida de las notificaciones de subprocesoCaptura de pantalla que muestra la vista expandida de las notificaciones de subproceso.

Referencia de comandos

En la tabla siguiente se muestran todos los comandos azure repos que puede usar en el canal de Teams.

Comando Funcionalidad
@azure repos subscribe [repo url/ project url] Suscribirse a un repositorio o a todos los repositorios de un proyecto para recibir notificaciones.
@azure repos subscriptions Agregar o quitar suscripciones de este canal.
@azure repos signin Iniciar sesión en la organización de Azure Repos.
@azure repos signout Cerrar sesión de la organización de Azure Repos.
@azure repos feedback Notificar un problema o sugerir una característica.
@azure repos unsubscribe all [project url] Quitar todos los repositorios (que pertenecen a un proyecto) y sus suscripciones asociadas de un canal.

Compatibilidad multiinquilino

Si usa otro correo electrónico o inquilino para Microsoft Teams y Azure DevOps, siga estos pasos a fin de iniciar sesión, en función del caso de uso.

Caso de uso Id. de correo electrónico + inquilino de Microsoft Teams Id. de correo electrónico + inquilino de Azure DevOps Pasos
1 email1@abc.com (inquilino 1) email1@abc.com (inquilino 1) Seleccione Iniciar sesión.
2 email1@abc.com (inquilino 1) email1@abc.com (inquilino 2) Inicie sesión en Azure DevOps. En el mismo explorador, inicie una nueva pestaña y vaya a https://teams.microsoft.com/. Ejecute el comando de inicio de sesión y seleccione Iniciar sesión.
3 email1@abc.com (inquilino 1) email2@pqr.com (inquilino 2) Seleccione Sign in with different email address (Iniciar sesión con una dirección de correo electrónico diferente) y, después, en el selector de id. de correo electrónico, use el correo electrónico 2 para iniciar sesión en Azure DevOps.
4 email1@abc.com (inquilino 1) email2@pqr.com (inquilino no predeterminado 3) Este escenario no se admite.

Solución de problemas

Si experimenta los errores siguientes al usar la aplicación de Azure Repos, siga los procedimientos de esta sección.

Algo ha ido mal. Inténtelo de nuevo.

La aplicación Azure Repos usa el protocolo de autenticación de OAuth y requiere que la opción Third-party application access via OAuth for the organization (Acceso a aplicaciones de terceros mediante OAuth para la organización) esté habilitada. Para habilitar esta configuración, vaya a Configuración de la organización>Seguridad>Directivas y establezca la configuración de Third-party application access via OAuth for the organization (Acceso a aplicaciones de terceros mediante OAuth para la organización) en Activado.

Habilitación de la configuración de Acceso a aplicaciones de terceros mediante OAuth para la organización

Error de configuración. Asegúrese de que la organización "{nombre de la organización}" existe y que tiene permisos suficientes.

Cierre la sesión en Azure DevOps; para ello, vaya a https://aka.ms/VsSignout mediante el explorador.

Abra una ventana del explorador Privada o en modo Incógnito, vaya a https://aex.dev.azure.com/me e inicie sesión. En la lista desplegable del icono de perfil situado a la izquierda, seleccione el directorio que incluye la organización que contiene el repositorio al que quiere suscribirse.

Selección del directorio que incluye la organización que contiene el proyecto

En el mismo explorador, abra una nueva pestaña e inicie sesión en https://teams.microsoft.com/. Ejecute el comando @Azure Repos signout y, después, ejecute el comando @Azure Repos signin en el canal donde está instalada la aplicación Azure Repos para Microsoft Teams.

Seleccione el botón Sign in y se le redirigirá a una página de consentimiento como la del ejemplo siguiente. Asegúrese de que el directorio que se muestra junto al correo electrónico es el mismo que el seleccionado en el paso anterior. Acepte y complete el proceso de inicio de sesión.

Consentimiento para los permisos de aplicación solicitados

Si estos pasos no resuelven el problema de autenticación, póngase en contacto con nosotros en Developer Community.