Acciones universales para tarjetas adaptables

  • Artículo

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 tarjetas adaptables eran universales, el control de acciones no lo era. Incluso si un desarrollador quisiera enviar la misma tarjeta a diferentes lugares, tiene que controlar las acciones de forma diferente.

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

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

Mejora de las experiencias del 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 como se indica a continuación:

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

En la imagen siguiente se muestra el modelo de acción incoherente actual:

Modelo de acción incoherente

Con acciones universales para tarjetas adaptables, puede usar para el Action.Execute control de acciones en distintas plataformas.

Action.Execute funciona en todos los centros, incluidos Teams y Outlook, y no es un reemplazo de Action.Submit. Por ejemplo, si desea que un sistema externo realice una acción y el resultado de la acción se debe devolver a la conversación mediante la extensión de mensajería, Action.Execute no se admite.

Para las tarjetas desplegadas de vínculos , como las tarjetas de héroe y miniatura, debe llamar a Action.Submit.

Además, se puede devolver una tarjeta adaptable como respuesta para una Action.Execute solicitud de invocación desencadenada.

En la imagen siguiente 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 mantenerlas sincronizadas entre sí mediante el bot subyacente. Cualquier acción realizada en cualquiera de las plataformas se refleja en la otra con esta compilación una vez, implementar en cualquier lugar (acciones universales para tarjetas adaptables).

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

Vistas específicas de usuario

En la actualidad, todos los usuarios del chat o canal de Teams ven exactamente las mismas acciones de vista y botón en la tarjeta adaptable. Sin embargo, en determinados escenarios hay un requisito para que determinados usuarios actúen de manera 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 asigna el incidente debe ver un botón Resolver . Por otro lado, 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 gracias a las vistas específicas del usuario habilitadas por la refresh propiedad .

En la imagen siguiente se muestra un ejemplo de una extensión de mensaje de vales (ME) en la que se muestran diferentes acciones de los usuarios del chat en función del requisito:

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

Compatibilidad con flujos de trabajo secuenciales

Con la compatibilidad con el 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 progresar a través de su flujo de trabajo sin modificar la tarjeta de otros usuarios en el chat.

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

Flujo de trabajo secuencial

En la imagen siguiente se muestran los distintos estados de los distintos usuarios en el chat o canal:

Estados del bot de catering

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

Vistas actualizadas

Puede 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 le permite proporcionar dichas vistas actualizadas. En la imagen siguiente se muestra un flujo de aprobación de varios pasos y cómo se muestran las vistas de los distintos usuarios.

Vistas actualizadas específicas del usuario

Para obtener más información, consulte 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 Tarjetas adaptables. Las nuevas acciones universales para tarjetas adaptables permiten un control común de las acciones de tarjeta adaptable entre plataformas y aplicaciones. Para obtener más información, vea Modelo de acción universal.

Para empezar, actualice los escenarios mediante la guía de inicio rápido y aproveche Las acciones universales.

Paso siguiente

Trabajar con Acciones universales para tarjetas adaptables

Consulte también