Introducción a las tarjetas adaptables para Microsoft Teams

Las tarjetas adaptables constituyen un método independiente de la plataforma para compartir y mostrar bloques de información sin la complejidad de personalizar CSS o HTML para representarlas. Puede crear tarjetas adaptables en formato JSON, con integraciones que las aplicaciones y los servicios en la nube pueden intercambiar de forma abierta. Cuando se entrega a un host específico, como Microsoft Teams, el archivo JSON se transforma en una UI nativa que se adapta automáticamente a su host. Por lo tanto, los diseñadores de procesos ahora pueden ofrecer patrones de interfaz de usuario coherentes siempre que necesiten mostrar información como parte de un proceso de negocio o automatización.

Dado que las tarjetas adaptables se adaptan a su host, son vehículos perfectos para compartir información entre Microsoft Teams y otros servicios.

Acciones actualmente disponibles para los flujos

Las siguientes acciones permiten a los desarrolladores crear tarjetas adaptables para Microsoft Teams. A medida que evolucionan los escenarios de integración, Power Automate admitirá otros hosts, lo que amplía las oportunidades de aprovechar las tarjetas adaptables en las suscripciones en la nube de Microsoft.

Direccionamiento de contenido a miembros de Teams o usuarios de Microsoft Entra

Muestre su propia tarjeta adaptable como el bot de Flow a un usuario

Esta acción publica una tarjeta adaptable como bot de flujo para un usuario específico. En este caso, deberá proporcionar una dirección de correo electrónico del destinatario. Después, la tarjeta aparece en los canales de actividad y de chat del destinatario durante la ejecución del flujo. No es necesario que el usuario forme parte de una instancia de Teams para recibir estos tipos de tarjetas adaptables. En este caso, solo los botones de dirección URL funcionan redirigiendo a la URL que se configura dentro del flujo.

Publique una tarjeta adaptable como bot de Flow en un usuario de Teams y espere respuesta

Esta acción publica una tarjeta adaptable como bot de Flow para un usuario específico, como el caso presentado anteriormente en este artículo. Aunque, en este caso, la ejecución de flujo no continua después de la publicación hasta que el destinatario responda a las entradas necesarias en la tarjeta. El flujo continúa después de que el destinatario responda. El flujo devuelve contenido dinámico para una respuesta por destinatario y por tarjeta.

Dirigir contenido a canales de Teams

• Muestre su propia tarjeta adaptable como el bot de flujo en un canal
  Esta acción publica una tarjeta adaptable como bot de flujo en un canal específico de Teams. En este caso, se le pedirá la instancia de Teams y un canal en el que se publica la tarjeta. El creador del flujo debe tener acceso a la instancia de Teams para publicar en ella una tarjeta interactiva. En este caso, solo los botones de dirección URL funcionan redirigiendo a la URL que se configura dentro del flujo.

• Publicar una tarjeta adaptable como bot de flujo en un canal de Teams y esperar respuesta
  Esta acción publica una tarjeta adaptable como bot de flujo en un canal específico de Teams, como en el caso anterior. En este caso, el flujo no continuará hasta que alguien en el canal responda a las entradas que se requieren en la tarjeta. El flujo continúa una vez que cualquier usuario del canal de Teams responde, pero solo devuelve contenido dinámico para una respuesta por respondedor y por tarjeta. Cuando usas esta tarjeta, el flujo espera una respuesta de cualquier miembro de Teams.

Problemas conocidos

• No puede recopilar datos de tarjetas adaptables a menos que los cree mediante una de las acciones de espera para una respuesta . Las tarjetas adaptables que no esperan devuelven un error en todas las acciones de botón excepto OpenURL. Más información sobre botones de OpenURL.

• Al seleccionar botones Action.Submit en una tarjeta que no incluye el sufijo esperar una respuesta, se muestra un error.

• Las tarjetas adaptables creadas mediante las acciones de espera de respuesta solo se pueden enviar una vez por tarjeta. La ejecución de flujo continúa después de la primera respuesta y se omitirán los envíos posteriores.

• Solo se mostrará la información incluida en el cuadro de entrada Actualizar mensaje en la tarjeta de reemplazo después de que los consumidores envíen la tarjeta.

  Los detalles adicionales, como el identificador de usuario de la persona que envía la tarjeta, están disponibles en el contenido dinámico de las acciones posteriores a la acción esperar una respuesta. Sin embargo, puede ser necesario incluir el conector de Usuarios de Office 365 para completar la información de perfil deseada para el usuario que envió la tarjeta.

• Una vez que las tarjetas adaptables en espera de respuesta se envían, la tarjeta se restablece y luego aparece exactamente igual, a menos que se configure el área de mensajes de reemplazo o actualización. Los mensajes de actualización son una buena práctica. Se recomienda actualizar a otros usuarios e impedir que los consumidores intenten enviar la tarjeta más de una vez.

  

Se han de configurar las entradas de Actualizar mensaje y Se recomienda actualizar la tarjeta si se quiere una tarjeta de reemplazo.

• Power Automate usa las características y los servicios exclusivos de tarjetas adaptables de Microsoft para administrar las tarjetas de cualquier host. En este artículo se aclaran los detalles relacionados con las acciones de flujo. También puede usar la documentación completa sobre creación de tarjetas adaptables.

Información relacionada

• Crear su primera tarjeta adaptable
• Conector de Microsoft Teams
• E/S de tarjetas adaptables