Componentes de bucle basado en tarjeta adaptable

Nota:

Los componentes de bucle basado en tarjeta adaptable requieren la versión 1.6 o posterior de las tarjetas adaptables.

Los componentes de bucle basado en tarjeta adaptable le permiten crear experiencias de colaboración dentro de las extensiones de mensajes de Microsoft Teams que funcionan en Microsoft 365. Los componentes de bucle basado en tarjeta adaptable tienen contenido accionable que permite a los usuarios realizar actualizaciones dinámicas sin tener que cambiar de contexto entre aplicaciones de Microsoft 365, como Teams y Outlook.

Los componentes de bucle se publicaron por primera vez en Teams, seguidos de otras aplicaciones de Microsoft 365, como Outlook, Whiteboard y aplicación loop. Los componentes de bucle permiten a los usuarios colaborar y compartir contenido en directo con otros usuarios en la aplicación de chat, correo electrónico, reunión, Whiteboard o bucle. Dado que los componentes de bucle permanecen sincronizados en diferentes aplicaciones de Microsoft 365, permiten a los usuarios coautorizar contenido y realizar actualizaciones en tiempo real en su contenido. Para obtener más información, consulte información general sobre los componentes de bucle en el ecosistema de Microsoft 365.

A continuación se muestra un ejemplo de un componente de bucle basado en tarjeta adaptable:

En este artículo se proporciona información general sobre cómo compilar y probar los componentes de bucle basado en tarjeta adaptable.

Requisitos previos

Antes de compilar un componente de bucle basado en tarjeta adaptable, asegúrese de cumplir los siguientes requisitos previos:

1. Cree una extensión de mensaje con un comando de búsqueda.

2. Agregue compatibilidad con la desplegamiento de vínculos a la extensión de mensaje.

3. Use Acciones universales para tarjetas adaptables.

4. Extienda la extensión de mensajes de Teams en Microsoft 365.

Compilar componente de bucle basado en tarjeta adaptable

Para compilar el componente de bucle basado en tarjeta adaptable, siga estos pasos:

1. Asegúrese de que la tarjeta adaptable cumple las directrices de diseño para crear una experiencia basada en tarjeta adaptable accionable y coherente para los usuarios finales.
2. Para habilitar el componente Loop, agregue la dirección URL que identifica de forma única la tarjeta en la propiedad metadata.webUrl en el esquema de tarjeta adaptable. La metadata.webUrl propiedad admite la portabilidad mediante el botón Copiar presente en el encabezado del componente loop.

Ejemplo:

A continuación se muestra un ejemplo JSON de un componente de bucle basado en tarjeta adaptable con las metadata propiedades y webUrl :

{
  "type": "AdaptiveCard",
  "version": "1.6",
  "metadata": {
    "webUrl": "https://contoso.com/tab"
  },
  "body": [
    {
      ....
    },
  ]
  }

Parámetros de consulta

Propiedad	Tipo	Descripción	Obligatorio
metadata	Metadata	Define varias propiedades de metadatos que normalmente no se usan para representar la tarjeta.	No
webUrl	Cadena	Dirección URL que identifica de forma única la tarjeta y actúa como reserva del explorador que pueden usar algunos hosts.	No

Prueba del componente de bucle

Puede probar el componente bucle en los entornos de desarrollador de Teams y Outlook para web.

Prueba en Microsoft Teams

Para configurar, distribuir y administrar la aplicación, use el Portal para desarrolladores de Teams. Puede probar y depurar la aplicación en el Portal para desarrolladores mediante las siguientes opciones:

• Página de información general: en la página Información general, en Validación de la tienda Teams, puede ver una instantánea de la configuración de la aplicación y comprobar si el paquete de la aplicación se valida en casos de prueba de la Tienda Microsoft Teams.
• Versión preliminar en Teams: el botón Vista previa en Teams inicia la aplicación rápidamente en el cliente de Teams para la depuración.

Prueba en Outlook para web

Para activar el componente de bucle basado en tarjeta adaptable en Outlook para web, siga estos pasos:

1. Create una extensión de mensaje basada en búsqueda mediante Teams App Camp.
2. Create un inquilino para desarrolladores de Microsoft 365 o inicie sesión con sus credenciales de inquilino de prueba.

La tarjeta adaptable generada por la aplicación se representa como un componente de bucle.

Ejemplo de código

Ejemplo de nombre	Descripción	Node.js	.NET	Manifiesto
Extensión de mensaje con componente de bucle basado en tarjeta adaptable	En este ejemplo se muestra cómo crear una extensión de mensaje con el componente de bucle basado en tarjeta adaptable.	View	View	Ver

Consulte también

Diseño del componente de bucle