Uso de la aplicación Azure Boards en Microsoft Teams

  • Artículo
  • Tiempo de lectura: 10 minutos

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:

  • Configuración y administración de suscripciones para crear y actualizar elementos de trabajo
  • Administrar otros eventos de elemento de trabajo
  • Recibir y administrar notificaciones para eventos de elemento de trabajo en su canal de Teams
  • Creación de 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 del elemento de trabajo de sus direcciones URL para iniciar discusiones y mantener las conversaciones contextuales.

Imagen: Notificación

Lea este artículo para aprender a:

  • Agregar la aplicación Azure Boards al equipo en Microsoft Teams
  • Vincular y desvincular el proyecto de Azure Boards a la aplicación de Azure Boards
  • Configurar suscripciones para eventos relacionados con elementos de trabajo en el canal de Teams
  • Crear elementos de trabajo desde el canal de Teams
  • Supervisión de 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, no se admite Azure Boards y la integración de Microsoft Teams si es un cliente de O365 Government Community Cloud (GCC) que usa una suscripción comercial de Azure junto con el inquilino de GCC.

Prerrequisitos

Nota:

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

Agregar la aplicación Azure Boards a Microsoft Teams

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

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

    Pic: Mensaje de bienvenida

  2. Use el @azure boards identificador para interactuar con la aplicación. Para obtener una lista de comandos, consulte Referencia de comandos proporcionada 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. Use Iniciar sesión con un correo electrónico diferente si Microsoft Teams y Azure Boards están en distintos inquilinos.

    Conéctese y autentíquese en Azure Boards.

    Conéctese y autentíquese en Azure Boards, paso 2.

  2. Después de iniciar sesión, use el siguiente comando dentro de un canal de Teams para vincular 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 @azure boards create el comando o usar acciones de mensaje.

Configuración de suscripciones

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

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

    Configure suscripciones.

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

Agregar rutas de acceso de área

Puede agregar áreas en las que trabaja el 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 de área en su proyecto.

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

      @azure boards addAreapath [area path]

    Por ejemplo:

      @azure boards addAreapath myproject\fabrikam

    Agregar mensaje de operación correcta de la ruta de área

  • Si elige el nombre del proyecto como ruta de acceso del área, recibirá notificaciones para todas las rutas de acceso de á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 el comando

Crear 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 a la conversación en el canal.

  • Para crear elementos de trabajo mediante acciones de mensaje

    Creación de un elemento de trabajo mediante la acción de mensaje

    Cree un elemento de trabajo mediante la acción del mensaje, paso 2.

Administración de suscripciones de Azure Boards

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

     @azure boards subscriptions

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

Ver suscripciones

Nota:

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

Buscar y compartir elementos de trabajo mediante la extensión compose

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 compose, los usuarios deben iniciar sesión en Azure Boards aplicación ejecutando @azure boards signin el comando o iniciando sesión directamente en la extensión compose.

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

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

Para admitir la colaboración en torno a los elementos de trabajo descritos en un canal, el canal 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, se muestra una vista previa similar a la siguiente imagen. Esta versión preliminar ayuda a mantener las conversaciones relacionadas con los elementos de trabajo relevantes y correctos.

Dirección URL del elemento de trabajo que se desenfurca.

Para que esta característica funcione, los usuarios deben iniciar sesión. Una vez iniciada la 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 @azure boards unlink el comando .

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

Las notificaciones de subprocesos del canal de Teams para vincular y reducir lógicamente las notificaciones relacionadas en el canal. Todas las notificaciones vinculadas a un elemento de trabajo determinado están vinculadas juntas.

Vista compacta de notificaciones en subprocesos

Subproceso compacto

Vista expandida de notificaciones en subprocesos

Subproceso expandido

referencia de comandos de Azure Boards

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

Comando Funcionalidad
vínculo @azure boards [project url] Vincular un proyecto a este canal para crear elementos de trabajo y recibir notificaciones
suscripciones de @azure boards Agregar o quitar suscripciones para este canal
creación de paneles de @azure Crear un elemento de trabajo
@azure paneles addAreapath [area path] Agregar una ruta de acceso de área desde el proyecto a este canal
inicio de sesión de @azure boards Inicie sesión en su organización de Azure Boards
cierre de sesión de @azure boards Cierre de sesión de la organización de Azure Boards
@azure paneles desvinculan Desvincular un proyecto de este canal
comentarios de @azure paneles Notificar un problema o sugerir una característica

Configurar 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 de equipo.

    Se muestra 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 una lista alfabética.

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

  2. Elija el icono de Azure DevOps y autentíquela. Opcionalmente, puede elegir el icono Sitio web y agregar la dirección URL del panel Kanban o panel al canal.

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

  4. Rellene el formulario presentado. Por ejemplo, aquí se agrega 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 seleccionado.

Compatibilidad multiinquilino

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

Caso

Email id. y inquilino en Microsoft Teams

Email id. y inquilino en Azure DevOps

Pasos que se deben 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 explorador, inicie una nueva pestaña, vaya a https://teams.microsoft.com
  • Ejecute el signin comando y elija el botón Iniciar sesión .

3

email1@abc.com
(inquilino 1)

email2@pqr.com
(inquilino 2)

Inicie sesión con Inicio de sesión con una dirección de correo electrónico diferente, en el selector de identificadores de correo electrónico, use el correo electrónico2 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 hoy en día.

Solución de errores

Si experimenta los siguientes errores al usar la aplicación Azure Boards para Microsoft Teams, siga los procedimientos descritos en 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 se habilite el acceso a aplicaciones de terceros a través de OAuth para que la organización esté habilitada. Para habilitar esta configuración, vaya a Configuración de la organización Directivas> deseguridad> y establezca el acceso a la aplicación de terceros a través de OAuth para la configuración de la organización en Activado.

Habilitar el acceso a la aplicación de terceros a través de OAuth para la configuración de 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 sesión en Azure DevOps; para ello, vaya a https://aka.ms/VsSignout mediante el explorador.

Abra una ventana del explorador En privado o de incógnito y vaya a https://aex.dev.azure.com/me e inicie sesión. En la lista desplegable situada debajo del icono de perfil a la izquierda, seleccione el directorio que contiene la organización que contiene el proyecto que desea vincular.

Seleccione el directorio que contiene la organización que contiene el proyecto.

En el mismo explorador, inicie una nueva pestaña, vaya a https://teams.microsoft.com/. Ejecute el @azure boards signout comando y, a continuación, ejecute el @azure boards signin comando en el canal donde está instalada la aplicación Azure Boards para Microsoft Teams.

Seleccione el Sign in botón 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 elegido 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.