Uso de la aplicación Azure Boards en Microsoft Teams

  • Artículo

Azure DevOps Services

Si usa Microsoft Teams, puede crear elementos de trabajo y supervisar la actividad del elemento de trabajo en el proyecto de Azure Boards desde el canal de Teams. Para ello, agregue la aplicación Azure Boards para Microsoft Teams al canal de Teams.

La aplicación Azure Boards para Microsoft Teams permite a los usuarios completar las siguientes tareas:

  • Configurar y administrar suscripciones para crear y actualizar elementos de trabajo
  • Administrar otros eventos de elementos de trabajo
  • Recibir y administrar notificaciones para eventos de elementos de trabajo en el canal de Teams
  • Crear elementos de trabajo a partir de conversaciones en el canal
  • Buscar y compartir elementos de trabajo con otros miembros del canal mediante la extensión de mensajería
  • Vea las vistas previas de los elementos de trabajo desde las direcciones URL para iniciar discusiones y mantener las conversaciones contextuales.

Imagen: Notificación

Lea este artículo para obtener información sobre cómo:

  • Agregar la aplicación Azure Boards al equipo en Microsoft Teams
  • Vincular y desvincular el proyecto de Azure Boards a la aplicación Azure Boards
  • Configurar suscripciones para eventos relacionados con elementos de trabajo del canal de Teams
  • Crear elementos de trabajo en el canal de Teams
  • Supervisar la actividad del elemento de trabajo en el canal de Teams

Nota:

Azure Boards y la integración de Microsoft Teams solo se admiten para Azure DevOps Services.

Además, la integración de Azure Boards y Microsoft Teams no se admite si es cliente de O365 Government Community Cloud (GCC) que use una suscripción comercial de Azure junto con el inquilino de GCC.

Requisitos previos

Nota:

  • En este momento, puede vincular la aplicación Azure Boards para Microsoft Teams solo a un proyecto hospedado en Azure DevOps Services.
  • Actualmente no se admiten notificaciones dentro de mensajes directos.
  • Solo se admiten canales públicos.

Incorporación de la aplicación Azure Boards a Microsoft Teams

Agregue la aplicación al canal de Teams de Microsoft Teams.

  1. Visite la tienda de aplicaciones en Microsoft Teams y busque la aplicación Azure Boards. Tras la instalación, aparece un mensaje de bienvenida de la aplicación, como se muestra en la imagen siguiente.

    Imagen: Mensaje de bienvenida

  2. Use el identificador @azure boards para interactuar con la aplicación. Para obtener una lista de comandos, consulte Referencia de comandos que aparece más adelante en este artículo.

Para usar la aplicación, primero debe vincular el proyecto de Azure Boards al canal de Teams.

  1. Una vez instalada la aplicación en el equipo, conéctese y autentíquese en Azure Boards. Si Microsoft Teams y Azure Boards están en diferentes inquilinos, seleccione Iniciar sesión con un correo electrónico diferente.

    Conexión y autenticación en Azure Boards.

    Conexión y autenticación en Azure Boards, paso 2.

  2. Después de iniciar sesión, use el siguiente comando dentro de un canal de Teams para vincularse al proyecto de Azure Boards que especifique con la dirección URL:

     @azure boards link [project url]

    Por ejemplo:

     @azure boards link https://dev.azure.com/myorg/myproject

Una vez vinculado el proyecto, puede crear elementos de trabajo mediante el comando @azure boards create o usar acciones de mensaje.

Configuración de suscripciones

Puede crear suscripciones para supervisar los elementos de trabajo en cualquier momento mediante el comando @azure boards subscriptions.

  1. Seleccione la ruta de acceso al área que desee y el evento que le interese. Use los filtros asociados para personalizar que notificaciones recibe en el canal de Teams. Para ayudar a configurar fácilmente las suscripciones, las rutas de acceso al área a las que se ha accedido recientemente se muestran en la lista desplegable de rutas de acceso al área.

    Configure suscripciones.

En caso de que la ruta de acceso al área que desee no aparezca en el menú desplegable Ruta de acceso al área, siga las instrucciones mencionadas en la sección siguiente, Agregar rutas de acceso al área. Las rutas de acceso al área agregadas mediante el comando @azure boards addAreapath y las rutas de acceso al área para las que se crean suscripciones en el canal siempre aparecen en la lista desplegable Ruta de acceso al área junto con las rutas a las que se ha accedido recientemente.

Agregar rutas de acceso al área

Puede agregar las áreas en las que trabaja su equipo al canal para que estén siempre disponibles para crear elementos de trabajo y suscripciones. Esta característica es útil para los equipos con más de 100 rutas de acceso al área en su proyecto.

  • Use el siguiente comando para agregar rutas de acceso al área desde el proyecto al canal de Teams.

      @azure boards addAreapath [area path]

    Por ejemplo:

      @azure boards addAreapath myproject\fabrikam

    mensaje de finalización correcta de la acción Agregar ruta de acceso al área

  • Si elige el nombre del proyecto como ruta de acceso al área, recibirá notificaciones de todas las rutas de acceso al área del proyecto.

Creación de un elemento de trabajo con un comando

Con la aplicación Azure Boards, puede crear elementos de trabajo desde el canal. La aplicación también admite elementos de trabajo personalizados.

  • Para crear un elemento de trabajo, use @azure boards create.

    Creación de un elemento de trabajo mediante comandos

Creación de un elemento de trabajo a partir de acciones de mensaje

A menudo, las discusiones en un canal requieren la creación de elementos de trabajo. Puede usar acciones de mensaje para crear un elemento de trabajo. El mensaje seleccionado se rellena previamente en la sección de descripción del elemento de trabajo. La sección Discusión del elemento de trabajo recién agregado almacena un vínculo de vuelta a la conversación en el canal.

  • Para crear elementos de trabajo mediante acciones de mensaje

    Creación de un elemento de trabajo mediante acciones de mensaje

    Creación de un elemento de trabajo mediante acciones de mensaje, paso 2.

Administración de suscripciones de Azure Boards

  1. Para ver, agregar y quitar suscripciones para un canal, use el comando @azure boards subscriptions:

     @azure boards subscriptions

Este comando enumera todas las suscripciones actuales del canal y permite agregar nuevas suscripciones y eliminar las existentes. Como parte de la adición de suscripciones, también puede personalizar las notificaciones que recibe mediante varios filtros.

Ver suscripciones

Nota:

Los administradores del equipo no pueden quitar ni modificar suscripciones creadas por los administradores del proyecto.

Búsqueda y uso compartido de elementos de trabajo mediante la extensión de redacción

Para ayudar a los usuarios a buscar y compartir elementos de trabajo, la aplicación Azure Boards para Microsoft Teams admite la extensión de redacción. Puede buscar elementos de trabajo por identificador de elemento de trabajo, título o comando funcional compatible. Para obtener una lista de comandos, consulte Búsqueda de elementos de trabajo funcionales. Para usar la extensión de redacción, los usuarios deben iniciar sesión en la aplicación Azure Boards ejecutando el comando @azure boards signin o iniciando sesión directamente en la extensión de redacción.

Inicio de sesión en la extensión de redacción.

Obtener una vista previa de las direcciones URL del elemento de trabajo

Para respaldar la colaboración en los elementos de trabajo descritos en un canal, este muestra una vista previa de los elementos de trabajo a los que se hace referencia. Cuando un usuario pega la dirección URL del elemento de trabajo, aparece una vista previa similar a la de la siguiente imagen. Esta vista previa ayuda a que las conversaciones relacionadas con los elementos de trabajo sean pertinentes y correctas.

Apertura de la dirección URL del elemento de trabajo.

Para que esta característica funcione, los usuarios deben iniciar sesión. Una vez que haya iniciado sesión, esta característica funciona para todos los canales de un equipo de Microsoft Teams.

Un canal de Teams solo puede vincularse a un proyecto de Azure Boards a la vez. Para vincular a otro proyecto, primero debe desvincular el proyecto actual mediante el comando @azure boards unlink.

Al desvincular un proyecto, se eliminan todas las suscripciones junto con las rutas de acceso al área agregadas desde el canal. Si el canal no tiene suscripciones, cualquier usuario puede desvincular un proyecto. Sin embargo, si un canal tiene suscripciones, solo los administradores del proyecto pueden desvincular un proyecto de un canal.

El canal de Teams agrupa en conversaciones las notificaciones para vincular de manera lógica y reducir las notificaciones relacionadas del canal. Todas las notificaciones vinculadas a un elemento de trabajo determinado están vinculadas juntas.

Vista compacta de las notificaciones agrupadas en conversaciones

Subproceso compacto

Vista expandida de las notificaciones agrupadas en conversaciones

Subproceso expandido

Referencia de comandos de Azure Boards

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

Comando Funcionalidad
@azure boards link [project url] Vincula un proyecto a este canal para crear elementos de trabajo y recibir notificaciones
@azure boards subscriptions Agregar o quitar suscripciones de este canal
@azure boards create Crear un elemento de trabajo
@azure boards addAreapath [area path] Agrega una ruta de acceso al área del proyecto a este canal
@azure boards sign in Inicia sesión en la organización de Azure Boards
@azure boards sign out Cierra sesión en la organización de Azure Boards
@azure boards unlink Desvincula un proyecto de este canal
@azure boards feedback Notificar un problema o sugerir una característica

Configuración de las pestañas de Azure DevOps Services en Microsoft Teams

  1. Para incorporar el panel Kanban o el panel a Microsoft Teams, seleccione el botón "+" ("agregar nueva pestaña") en la navegación superior del canal del equipo.

    Aparece el cuadro de diálogo Agregar una pestaña. Los iconos se organizan normalmente según el acceso más reciente. Puede seleccionar A-Z para obtener una lista ordenada alfabéticamente.

    Captura de pantalla para agregar una nueva pestaña al canal de Teams.

  2. Elija el icono de Azure DevOps y autentique su identidad. Opcionalmente, puede elegir el icono de sitio web y agregar la dirección URL del panel Kanban o del panel al canal.

  3. Elija la organización cuyo panel desea agregar.

  4. Complete el formulario presentado. Por ejemplo, aquí vamos a agregar un panel para el equipo de Azure DevOps para el proyecto TechnicalContent.

    Cuadro de diálogo para agregar un panel de equipo a un canal de Teams.

  5. Se muestra el panel Kanban o el panel de información seleccionado.

Compatibilidad multiinquilino

En su organización, si usa un correo electrónico o inquilino diferente para Microsoft Teams y Azure DevOps, siga estos pasos para iniciar sesión y conectarse en función del caso de uso en cuestión.

Case

Identificador de correo electrónico e inquilino en Microsoft Teams

Identificador de correo electrónico e inquilino en Azure DevOps

Pasos a seguir

1

email1@abc.com
(inquilino 1)

email1@abc.com
(inquilino 1)

Inicie sesión con el botón Iniciar sesión.

2

email1@abc.com
(inquilino 1)

email1@abc.com
(inquilino 2)

  • Inicio de sesión en la cuenta de Azure DevOps
  • En el mismo navegador, abra una nueva pestaña y vaya a https://teams.microsoft.com
  • Ejecute el comando signin y elija el botón Iniciar sesión.

3

email1@abc.com
(inquilino 1)

email2@pqr.com
(inquilino 2)

Inicie sesión mediante Iniciar sesión con una dirección de correo electrónico diferente y, 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 actualmente.

Solución de errores

Si experimenta los errores siguientes al usar la aplicación Azure Boards para Microsoft Teams, siga los procedimientos de esta sección.

Algo ha ido mal. Inténtelo de nuevo.

La aplicación Azure Boards usa el protocolo de autenticación de OAuth y requiere que la opción Acceso a aplicaciones de terceros mediante OAuth para la organización esté habilitada. Para habilitar este ajuste, vaya a Configuración de la organización>Seguridad>Directivas y cambie la opción Acceso a aplicaciones de terceros a través de OAuth para la organización a 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.

Para cerrar sesión en Azure DevOps, vaya a https://aka.ms/VsSignout mediante el navegador.

Abra una ventana del navegador InPrivate o 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 proyecto que desea vincular.

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

En el mismo navegador, abra una nueva pestaña y vaya a https://teams.microsoft.com/. Ejecute el comando @azure boards signout y, después, ejecute el comando @azure boards signin en el canal donde está instalada la aplicación Azure Boards 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.