Compartir a través de


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 pueden ofrecer ahora patrones de UI coherentes siempre que necesiten mostrar información como parte de una automatización o un proceso de negocio.

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

Captura de pantalla de tarjetas adaptables.

Acciones disponibles actualmente para flujos

Las siguientes acciones permiten a los desarrolladores crear tarjetas adaptables para Microsoft Teams. A medida que los escenarios de integración evolucionen, Power Automate admitirá también otros hosts, lo que ampliará sus oportunidades de aprovechar las tarjetas adaptables a través de las suscripciones a la nube de Microsoft.

Nota

Las tarjetas adaptables no están disponibles en el entorno DoD (Departamento de defensa).

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. Luego, la tarjeta aparece en el chat y/o en las fuentes de actividad de ese 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 continuará después de la publicación hasta que el destinatario responda a las entradas que se requieren en la tarjeta. El flujo continúa después de que el destinatario responda. El flujo devuelve contenido dinámico para una (1) sola respuesta por destinatario y por tarjeta.

Direccionamiento de 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 marcador de flujo debe tener acceso a la instancia de Teams para publicar allí una tarjeta adaptable. 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 cuando alguien del canal de Teams responda, pero solo devuelve contenido dinámico para una (1) sola respuesta por respondedor y tarjeta. Cuando se usa esta tarjeta, el flujo espera respuesta de cualquier miembro de Teams.

Problemas conocidos

  • No es posible recopilar datos de las tarjetas adaptables a menos que se creen con una de las acciones en espera de 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.

  • Si selecciona botones Action.Submit en una tarjeta que no incluya el sufijo en espera de respuesta, se produce un error.

  • Las tarjetas adaptables creadas con las acciones en 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á disponible en el contenido dinámico de las acciones que siguen a la acción en espera de respuesta. Aunque podría ser necesario incluir el conector de usuarios de Office 365 para poder 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. Son un procedimiento recomendado para actualizar a otros y para evitar que los consumidores intenten enviar la tarjeta más de una vez.

    Captura de pantalla de un mensaje de actualización.

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. El objetivo de este artículo es aclarar cualquier información específica relacionada con las acciones de flujo. También puede usar la documentación completa sobre creación de tarjetas adaptables.