Uso de la aplicación Azure Boards en Microsoft Teams
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.
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
- Para crear un elemento de trabajo, debe ser colaborador del proyecto de Azure Boards. Si aún no tiene un proyecto, puede registrarse y crear un proyecto. Para obtener más información, consulte Empezar a usar Azure Boards.
- Para crear suscripciones en un canal de Teams para eventos de elementos de trabajo, debe ser miembro del grupo Administradores de proyectos de Azure Boards o solicitar que le agreguen al rol de administrador del equipo del equipo. Para que le agreguen, consulte Cambio de permisos en el nivel de proyecto o Agregar administrador de equipo.
- Para recibir notificaciones, debe habilitar el acceso a la aplicación de terceros mediante la configuración de OAuth para la organización de Azure DevOps. Vea Cambio de directivas de acceso a aplicaciones para su organización.
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.
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.
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.
Vinculación del proyecto de Azure Boards a la aplicación Azure Boards
Para usar la aplicación, primero debe vincular el proyecto de Azure Boards al canal de Teams.
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.
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
.
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.
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
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 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
Administración de suscripciones de Azure Boards
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.
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.
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.
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.
Desvincular un proyecto de un canal
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.
Notificaciones agrupadas en conversaciones para vincular y reducir las notificaciones
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
Vista expandida de las notificaciones agrupadas en conversaciones
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
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.
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.
Elija la organización cuyo panel desea agregar.
Complete el formulario presentado. Por ejemplo, aquí vamos a agregar un panel para el equipo de Azure DevOps para el proyecto TechnicalContent.
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.
- Error de configuración. Asegúrese de que la organización "{nombre de la organización}" existe y que tiene permisos suficientes.
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.
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.
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.
Si estos pasos no resuelven el problema de autenticación, póngase en contacto con nosotros en Developer Community.
Artículos relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de