Ações universais para cartões adaptáveisUniversal Actions for Adaptive Cards

As Ações Universais para Cartões Adaptáveis evoluíram dos comentários do desenvolvedor que, embora o layout e a renderização para Cartões Adaptáveis fosse universais, o tratamento de ações não era.Universal Actions for Adaptive Cards evolved from developer feedback that even though layout and rendering for Adaptive Cards was universal, action handling was not. Mesmo que um desenvolvedor quisesse enviar o mesmo cartão para locais diferentes, ele teria que lidar com ações de maneira diferente.Even if a developer wanted to send the same card to different places, they have to handle actions differently.

Ações universais para Cartões Adaptáveis traz o bot como o back-back comum para lidar com ações e introduz um novo tipo de ação, que funciona em aplicativos, como Teams e Action.Execute Outlook.Universal Actions for Adaptive Cards brings the bot as the common backend for handling actions and introduces a new action type, Action.Execute, which works across apps, such as Teams and Outlook.

Este documento ajuda você a entender como você pode usar o modelo de Ações Universais para aprimorar a experiência do usuário de interagir com Cartões Adaptáveis em plataformas e aplicativos.This document helps you to understand how you can use Universal Actions model to enhance user experience of interacting with Adaptive Cards across platforms and applications.

Observação

O suporte para Ações Universais para Cartões Adaptáveis só está disponível para cartões enviados por bot.Support for Universal Actions for Adaptive Cards is only available for cards sent by bot. O suporte para cartões enviados por meio da caixa de redação e dos cartões de desfraldamento de link está chegando em breve.Support for cards sent through compose box and link unfurling cards is coming soon.

Aprimorar as experiências do usuário com ações universais para cartões adaptáveisEnhance user experiences with Universal Actions for Adaptive Cards

Ações universais para cartões adaptáveis aprimora a experiência do usuário habilitando os seguintes cenários:Universal Actions for Adaptive Cards enhances user experience by enabling the following scenarios:

Ações universaisUniversal Actions

Antes das Ações Universais para Cartões Adaptáveis, hosts diferentes forneceam modelos de ação diferentes da seguinte maneira:Before the Universal Actions for Adaptive Cards, different hosts provided different action models as follows:

  • Teams ou bots usados , uma abordagem que adia o modelo de comunicação Action.Submit real para o canal subjacente.Teams or bots used Action.Submit, an approach which defers the actual communication model to the underlying channel.
  • Outlook usado Action.Http para se comunicar com o serviço back-end explicitamente especificado na carga cartão adaptável.Outlook used Action.Http to communicate with the backend service explicitly specified in the Adaptive Card payload.

A imagem a seguir mostra o modelo de ação inconsistente atual:The following image shows the current inconsistent action model:

Modelo de ação inconsistente

Com as Ações Universais para Cartões Adaptáveis, você pode usar para o tratamento Action.Execute de ações em diferentes plataformas.With the Universal Actions for Adaptive Cards, you can use Action.Execute for action handling across different platforms. Action.Executefunciona entre hubs, incluindo Teams e Outlook.Action.Execute works across hubs including Teams and Outlook. Além disso, um Cartão Adaptável pode ser retornado como resposta para uma Action.Execute solicitação de invocação disparada.In addition, an Adaptive Card can be returned as response for an Action.Execute triggered invoke request.

A imagem a seguir mostra o novo modelo de Ação Universal:The following image shows the new Universal Action model:

Novas ações universais para cartões adaptáveis

Agora você pode enviar o mesmo cartão para ambos, Teams e Outlook e mantê-los em sincronia uns com os outros usando o bot subjacente.You can now send the same card to both, Teams and Outlook, and keep them in sync with each other using the underlying bot. Qualquer ação realizada em qualquer plataforma é refletida na outra com essa com build uma vez, implante em qualquer lugar (Ações Universais para Cartões Adaptáveis).Any action taken on either platform is reflected to the other with this build once, deploy anywhere (Universal Actions for Adaptive Cards) model.

A imagem a seguir mostra as Ações Universais para Cartões Adaptáveis para Teams e Outlook:The following image depicts the Universal Actions for Adaptive Cards for both Teams and Outlook:

Mesmo cartão para Teams e Outlook

Exibições específicas do usuárioUser Specific Views

Hoje, todos os usuários no Teams chat ou canal veem exatamente as mesmas ações de modo de exibição e botão no Cartão Adaptável.Today every user in the Teams chat or channel sees the exact same view and button actions on the Adaptive Card. No entanto, em determinados cenários, há um requisito para que determinados usuários atuem de forma diferente e tenham acesso a informações diferentes no mesmo chat ou canal.However, in certain scenarios there is a requirement for certain users to act differently and have access to different information within the same chat or channel.

Por exemplo, se você enviar um cartão de relatório de incidentes em um chat ou canal, somente o usuário atribuído ao incidente deverá ver um botão Resolver.For example, if you send an incident reporting card in a chat or channel, only the user who is assigned the incident must see a Resolve button. Por outro lado, o criador de incidentes deve ver um botão Editar e todos os outros usuários só poderão exibir detalhes do incidente.On the other hand, the incident creator must see an Edit button and all other users must only be able to view details of the incident. Isso é possível por exibições específicas do usuário que estão habilitadas pela refresh propriedade.This is made possible by User Specific Views that is enabled by the refresh property.

A imagem a seguir mostra um exemplo de uma extensão de mensagens de tíquete (ME) onde diferentes usuários no chat são mostrados diferentes ações com base no requisito:The following image shows an example of a ticketing messaging extension (ME) where different users in the chat are shown different actions based on the requirement:

Exibições específicas do usuário

Para obter mais informações, consulte sample for User Specific Views.For more information, see sample for User Specific Views.

Suporte ao Fluxo de Trabalho SequencialSequential Workflow support

Com o suporte ao Fluxo de Trabalho Sequencial, os usuários podem progredir através de uma série de fluxos de trabalho sem enviar cartões diferentes separadamente.With Sequential Workflow support, users can progress through a series of workflows without sending different cards separately. Isso é possível pela capacidade de Action.Execute retornar um Cartão Adaptável em resposta a uma ação.This is made possible by the ability of Action.Execute to return an Adaptive Card in response to an action. Além disso, qualquer usuário no chat ou canal pode progredir por meio de seu fluxo de trabalho sem modificar o cartão para outros usuários no chat.Also, any user in the chat or channel can progress through their workflow without modifying the card for other users in the chat.

A imagem a seguir ilustra um exemplo de bot de ordenação de alimentos:The following image illustrates a food ordering bot example:

Sequential Workflow

A imagem a seguir mostra os vários estados para diferentes usuários no chat ou no canal:The following image shows the various states for different users in the chat or channel:

Estados de bot de bufê

Para obter mais informações, consulte sample for Sequential Workflow.For more information, see sample for Sequential Workflow.

Exibições atualizadasUp to date views

Você pode criar Cartões Adaptáveis que são atualizados automaticamente.You can create Adaptive Cards that update automatically. Por exemplo, pode ser uma solicitação de aprovação enviada por um usuário.For example, it can be an approval request sent by a user. Após a aprovação, o cartão deve exibir automaticamente detalhes sobre o tempo de aprovação da solicitação e quem aprovou a solicitação.After approval, the card must automatically display details about the request approval time and who approved the request. O modelo de atualização permite que você forneça tais exibições atualizadas.The refresh model enables you to provide such up to date views. A imagem a seguir mostra um fluxo de aprovação em várias etapas e como as exibições para diferentes usuários são mostradas.The following image shows a multi-step approval flow and how the views for different users is shown.

Exibições específicas do usuário atualizadas

Para obter mais informações, consulte exemplo de exibições atualizadas.For more information, see sample for up to date views.

Agora, você pode entender como os Cartões Adaptáveis podem ser transformados com o novo modelo de Ações Universais para oferecer uma experiência de usuário exclusiva e aprimorada.Now, you can understand how Adaptive Cards can be transformed with the new Universal Actions model to provide a unique and enhanced user experience.

Cartões adaptáveis e o novo modelo de Ações UniversaisAdaptive Cards and the new Universal Actions model

Cartões adaptáveis são uma combinação de conteúdo, como texto e elementos gráficos, e ações que podem ser executadas por um usuário.Adaptive Cards are a combination of content, such as text and graphics, and actions that can be performed by a user. Para obter mais informações, consulte Adaptive Cards.For more information, see Adaptive Cards. As novas Ações Universais para Cartões Adaptáveis permitem uma manipulação comum das ações do Cartão Adaptável em plataformas e aplicativos.The new Universal Actions for Adaptive Cards enables a common handling of the Adaptive Card actions across platforms and applications. Para obter mais informações, consulte Modelo de Ação Universal.For more information, see Universal Action Model.

Trabalhar com ações universais para cartões adaptáveis o documento leva você pelas etapas para usar os recursos de Ações Universais para Cartões Adaptáveis para sua solução.Work with Universal Actions for Adaptive Cards document takes you through the steps to use the capabilities of Universal Actions for Adaptive Cards for your solution.

Confira tambémSee also

Próxima etapaNext step