Acciones universales para tarjetas adaptables

Las acciones universales para tarjetas adaptables evolucionaron a partir de los comentarios de los desarrolladores que, aunque el diseño y la representación de las tarjetas adaptables era universal, el control de la acción no lo era. Incluso si un desarrollador quisiera enviar la misma tarjeta a distintos lugares, debe controlar las acciones de forma diferente.

Las acciones universales para tarjetas adaptables traen el bot como el back-end común para controlar acciones e introduce un nuevo tipo de acción, , que funciona en todas las aplicaciones, como Teams y Action.Execute Outlook.

Este documento le ayuda a comprender cómo puede usar el modelo de acciones universales para mejorar la experiencia del usuario de interactuar con tarjetas adaptables en plataformas y aplicaciones.

Nota

La compatibilidad con acciones universales para tarjetas adaptables v1.4 solo está disponible para las tarjetas enviadas por el bot. La compatibilidad con las tarjetas enviadas a través del cuadro de redacción y las tarjetas de desamuestración de vínculos estará disponible próximamente.

Mejorar las experiencias de usuario con acciones universales para tarjetas adaptables

Las acciones universales para tarjetas adaptables mejoran la experiencia del usuario al habilitar los siguientes escenarios:

Acciones universales

Antes de las acciones universales para tarjetas adaptables, los distintos hosts proporcionaba diferentes modelos de acción de la siguiente manera:

  • Teams o bots usados , un enfoque que aplaza el modelo de comunicación Action.Submit real al canal subyacente.
  • Outlook se Action.Http usa para comunicarse con el servicio back-end especificado explícitamente en la carga de la tarjeta adaptable.

La siguiente imagen muestra el modelo de acción incoherente actual:

Modelo de acción incoherente

Con las acciones universales para tarjetas adaptables, puedes usar para el control Action.Execute de acciones en diferentes plataformas. Action.Executefunciona en todos los concentradores, incluidos Teams y Outlook. Además, se puede devolver una tarjeta adaptable como respuesta para una Action.Execute solicitud de invocación desencadenada.

En la siguiente imagen se muestra el nuevo modelo de acción universal:

Nuevas acciones universales para tarjetas adaptables

Ahora puede enviar la misma tarjeta a ambos, Teams y Outlook, y mantenerlos sincronizados entre sí mediante el bot subyacente. Cualquier acción realizada en cualquier plataforma se refleja en la otra con esta compilación una vez, implemente en cualquier lugar (acciones universales para tarjetas adaptables).

En la siguiente imagen se muestran las acciones universales de las tarjetas adaptables para Teams y Outlook:

Vistas específicas de usuario

Hoy en día, todos los usuarios Teams chat o canal ven exactamente las mismas acciones de vista y botón en la tarjeta adaptable. Sin embargo, en determinados escenarios existe un requisito para que determinados usuarios actúen de forma diferente y tengan acceso a información diferente dentro del mismo chat o canal.

Por ejemplo, si envía una tarjeta de informes de incidentes en un chat o canal, solo el usuario al que se le asignó el incidente debe ver un botón Resolver. Por otra parte, el creador de incidentes debe ver un botón Editar y todos los demás usuarios solo deben poder ver los detalles del incidente. Esto es posible mediante vistas específicas del usuario habilitadas por la refresh propiedad.

En la siguiente imagen se muestra un ejemplo de una extensión de mensajería de vales (ME) donde se muestran diferentes usuarios en el chat diferentes acciones según el requisito:

Para obtener más información, vea el ejemplo de vistas específicas del usuario.

Compatibilidad con flujos de trabajo secuenciales

Con la compatibilidad con flujo de trabajo secuencial, los usuarios pueden avanzar a través de una serie de flujos de trabajo sin enviar tarjetas diferentes por separado. Esto es posible gracias a la capacidad de Action.Execute devolver una tarjeta adaptable en respuesta a una acción. Además, cualquier usuario del chat o canal puede avanzar a través de su flujo de trabajo sin modificar la tarjeta para otros usuarios en el chat.

En la siguiente imagen se muestra un ejemplo de bot de ordenación de alimentos:

Sequential Workflow

La siguiente imagen muestra los distintos estados para diferentes usuarios en el chat o canal:

Estados del bot de restauración

Para obtener más información, vea el ejemplo de Flujo de trabajo secuencial.

Vistas actualizadas

Puedes crear tarjetas adaptables que se actualicen automáticamente. Por ejemplo, puede ser una solicitud de aprobación enviada por un usuario. Después de la aprobación, la tarjeta debe mostrar automáticamente los detalles sobre el tiempo de aprobación de la solicitud y quién aprobó la solicitud. El modelo de actualización permite proporcionar dichas vistas actualizadas. En la siguiente imagen se muestra un flujo de aprobación de varios pasos y cómo se muestran las vistas para diferentes usuarios.

Vistas específicas del usuario actualizadas

Para obtener más información, vea el ejemplo de vistas actualizadas.

Ahora, puede comprender cómo se pueden transformar las tarjetas adaptables con el nuevo modelo de acciones universales para proporcionar una experiencia de usuario única y mejorada.

Tarjetas adaptables y el nuevo modelo de acciones universales

Las tarjetas adaptables son una combinación de contenido, como texto y gráficos, y acciones que puede realizar un usuario. Para obtener más información, vea Adaptive Cards. Las nuevas acciones universales para tarjetas adaptables permiten un control común de las acciones de tarjeta adaptable en plataformas y aplicaciones. Para obtener más información, vea Universal Action Model.

Puede empezar actualizando escenarios mediante la guía de inicio rápido y aprovechar las acciones universales.

Paso siguiente

Consulte también