Introducción a las tarjetas adaptables para Microsoft TeamsOverview of Adaptive Cards for 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 representarlos.Adaptive Cards are a platform-agnostic method of sharing and displaying blocks of information without the complexity of customizing CSS or HTML to render them. Puede crear tarjetas adaptables en formato JSON, con integraciones que las aplicaciones y los servicios en la nube pueden intercambiar de forma abierta.You author Adaptive Cards in JSON format, with integrations that cloud apps and services can openly exchange. Cuando se entrega a un host específico, como Microsoft Teams, el formato JSON se transforma en una interfaz de usuario nativa que se adapta automáticamente al host.When delivered to a specific host, such as Microsoft Teams, the JSON is transformed into native UI that automatically adapts to its host. Por lo tanto, los diseñadores de procesos pueden ofrecer ahora patrones de interfaz de usuario coherentes siempre que necesiten mostrar información como parte de una automatización o un proceso de negocio.Therefore, process designers can now offer consistent UI patterns whenever they need to display information as part of a business process/automation.

Dado que las tarjetas adaptables se ajustan al host, son vehículos perfectos para compartir información entre Microsoft Teams y otros servicios.Since Adaptive Cards adapt to their host, they are perfect vehicles for sharing information between Microsoft Teams and other services.

Captura de pantalla de Tarjetas adaptables

Acciones disponibles actualmente para flujosCurrently available actions for flows

Las siguientes acciones permiten a los desarrolladores crear tarjetas adaptables para Microsoft Teams.The following actions enable makers to create Adaptive Cards for 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 Tarjetas Adaptables a través de las suscripciones a la nube de Microsoft.As integration scenarios evolve, other hosts will also be supported by Power Automate, which will extend your opportunities to leverage Adaptive Cards throughout Microsoft cloud subscriptions.

Direccionamiento de contenido a miembros de Teams o usuarios de AADDirecting content to Teams members or AAD users

  • Muestre su propia tarjeta adaptable como el bot de Flow a un usuarioPost your own adaptive card as the Flow bot to a user
    Esta acción publica una tarjeta adaptable como bot de Flujo para un usuario específico.This action posts an adaptive card as a Flow bot to a specific user. En este caso, deberá proporcionar una dirección de correo electrónico de destinatario y la tarjeta se mostrará en el chat del destinatario o en las fuentes de actividades durante la ejecución del flujo.In this case, you will need to provide a recipient email address, and the card will show up in the recipient's chat and/or activity feeds during the flow run. No es necesario que el usuario forme parte de una instancia de Teams para recibir estos tipos de tarjetas adaptables.There is no requirement for the user to be part of a Teams instance to receive these types of Adaptive Cards. En este caso, solo los botones de dirección URL funcionan redirigiendo a la URL que se configura dentro del flujo.In this case, only the URL buttons function by redirecting to the URL that's configured within the flow.

    Ejemplos de tarjetas adaptables

  • Post an adaptive card as the Flow bot to a Teams user, and wait for a response (Publique una tarjeta adaptable como bot de Flow en un usuario de Teams y espere respuesta)Post an adaptive card as the Flow bot to a Teams user, and wait for a response
    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.This action posts an adaptive card as a Flow bot to a specific user, like the case presented earlier in this article. 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.However, in this case the flow run will not continue after the post until the recipient responds to inputs that are required within the card. El flujo continúa después de que el destinatario responda.The flow continues after the recipient responds. El flujo devuelve contenido dinámico para una (1) sola respuesta por destinatario y por tarjeta.The flow returns dynamic content for one (1) response per recipient and per card.

Direccionamiento de contenido a canales de TeamsDirecting content to Teams channels

  • Muestre su propia tarjeta adaptable como el bot de Flow en un canalPost your own adaptive card as the Flow bot to a channel
    Esta acción publica una tarjeta adaptable como bot de Flujo en un canal específico de Teams.This action posts an adaptive card as a Flow bot to a specific Teams channel. En este caso, se le pedirá la instancia de Teams y un canal en el que se publicará la tarjeta.In this case, you will be prompted for Teams instance, and a channel where the card will be posted. El marcador de Flow ha de tener acceso a la instancia de Teams para publicar allí una tarjeta adaptable.The flow-maker will have to have access to the Teams instance in order to post an adaptive card there. En este caso, solo los botones de dirección URL funcionan redirigiendo a la URL que se configura dentro del flujo.In this case, only URL buttons function by redirecting to the URL configured within the flow.

  • Post an adaptive card as the Flow bot to a Teams channel, and wait for a response (Publique una tarjeta adaptable como bot de Flow en un canal de Teams y espere respuesta)Post an adaptive card as the Flow bot to a Teams channel, and wait for a response
    Esta acción publica una tarjeta adaptable como bot de Flow en un canal específico de Teams, como en el caso anterior.This action posts an adaptive card as a Flow bot to a specific Teams channel as in the case above. Aunque, en este caso, el flujo no continuará hasta que alguien en el canal haya respondido a las entradas que se requieren en la tarjeta.However, in this case the flow will not continue until someone on the channel has responded to any inputs required within the card. El flujo continuará cuando alguien del canal de Teams responda, pero solo devolverá contenido dinámico para una (1) sola respuesta por respondedor y tarjeta.The flow will continue once the anyone in the Teams channel responds but will only return dynamic content for one (1) response per responder and per card.

    Sugerencia

    Cuando se usa esta tarjeta, el flujo espera respuesta de cualquier miembro de Teams.When you use this card, the flow waits for a response from any Teams member.

Problemas conocidosKnown issues

  • No es posible recopilar datos de las tarjetas adaptables a menos que se creen con una de las acciones "en espera de respuesta".It is not possible to collect data from Adaptive Cards unless they are created using one of the "wait for a response" actions. Las tarjetas adaptables que no esperan devuelven un error en todas las acciones de botón excepto OpenURL.Adaptive Cards that don't wait return an error for all button actions except OpenURL. Obtenga más información sobre botones de OpenURL.Learn more on OpenURL buttons.

  • Si selecciona botones Action.Submit en una tarjeta que no incluya el sufijo "en espera de respuesta", se producirá un error.Selecting Action.Submit buttons on a card which doesn't include the "wait for a response" suffix, will throw an error.

  • Las tarjetas adaptables creadas con las acciones "en espera de respuesta" solo se pueden enviar una vez por tarjeta.Adaptive Cards created using the "wait for response" actions can only be submitted once per card. La ejecución de flujo continuará después de la primera respuesta y se omitirán los envíos posteriores.The flow run will continue after the first response, and any further submissions are ignored.

  • Solo se mostrará la información incluida en el cuadro de entrada "Actualizar mensaje" (consulte la imagen 3) en la tarjeta de reemplazo después de que los consumidores envíen la tarjeta.Only the information within the ‘Update message’ input box (see image 3) will be shown on the replacement card after consumers submit the card.

    Los detalles adicionales, como el identificador de usuario de la persona que envía la tarjeta, estarán disponibles en el contenido dinámico de las acciones que siguen a la acción "en espera de respuesta".Additional details, such as the user id of the person submitting the card, will be available within the dynamic content in actions following the ‘wait for a response’ action. Aunque puede que sea 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.However, it may be necessary to include the Office 365 Users connector in order to complete desired profile information for the user who submitted the card.

  • 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.Once the "wait for a response" Adaptive Cards are submitted, the card resets and then appears exactly the same, unless the replacement/update message area is configured. Los mensajes de actualización son un procedimiento recomendado que se propone para actualizar a otros, pero también para evitar que los consumidores intenten enviar la tarjeta más de una vez.Update messages are a best practice, and are recommended in order to update others, but also to prevent consumers from attempting to submit the card more than once.

    Mensaje de actualización

Sugerencia

Se han de configurar las entradas de Actualizar mensaje y Se recomienda actualizar la tarjeta si se quiere una tarjeta de reemplazo.The Update Message and the Should update card inputs must be configured if a replacement card is desired.

  • Power Automate usa las características y los servicios exclusivos de Tarjetas adaptables de Microsoft para administrar las tarjetas de cualquier host.Power Automate uses Microsoft Adaptive Cards' unique features and services to handle the cards within any host. El objetivo de este artículo es aclarar cualquier información específica relacionada con las acciones de flujo.This article is intended to clarify any specifics related to flow actions. También puede usar la documentación completa sobre creación de tarjetas adaptables.You can also use the full documentation for building Adaptive Cards.

Más informaciónLearn more