Ações Universais para Cartões Adaptáveis

As Ações Universais para Cartões Adaptáveis evoluíram dos comentários do desenvolvedor de que, embora o layout e a renderização dos Cartões Adaptáveis fossem universais, o tratamento de ações não era. Mesmo que um desenvolvedor queira enviar o mesmo card para lugares diferentes, ele precisa lidar com as ações de maneira diferente.

As Ações Universais para Cartões Adaptáveis trazem o bot como o back-end comum para lidar com ações e introduzem um novo tipo de ação, Action.Execute, que funciona em todos os aplicativos, como Teams e 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 interação com Cartões Adaptáveis em plataformas e aplicativos.

Aprimorar as experiências do usuário com Ações Universais para Cartões Adaptáveis

As Ações Universais para Cartões Adaptáveis aprimoram a experiência do usuário habilitando os seguintes cenários:

Ações Universais

Antes das Ações Universais para Cartões Adaptáveis, hosts diferentes forneciam modelos de ação diferentes da seguinte maneira:

  • Equipes ou bots usados Action.Submit, uma abordagem que adia o modelo de comunicação real para o canal subjacente.
  • Outlook usado Action.Http para se comunicar com o serviço de back-end explicitamente especificado no conteúdo do Cartão Adaptável.

A imagem a seguir mostra o modelo de ação inconsistente atual:

Modelo de ação inconsistente

Com as Ações Universais para Cartões Adaptáveis, você pode usar Action.Execute para manipulação de ações em diferentes plataformas.

Action.Execute funciona em todos os hubs, incluindo Teams e Outlook, e não substitui Action.Submito . Por exemplo, se você quiser que um sistema externo faça uma ação e o resultado da ação deva ser enviado de volta para sua conversa usando a Extensão de Mensagens, Action.Execute não há suporte.

Para cartas de desenrolamento de link , como cartas de herói e miniatura, você deve pagar Action.Submit.

Além disso, um Cartão Adaptável pode ser retornado como uma resposta a uma Action.Execute solicitação de invocação disparada.

A imagem a seguir mostra o novo modelo de Ação Universal:

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

Agora você pode enviar o mesmo card para o Teams e o Outlook e mantê-los sincronizados entre si usando o bot subjacente. Qualquer ação realizada em qualquer plataforma é refletida na outra com esse modelo de build uma vez, implantar em qualquer lugar (Ações Universais para Cartões Adaptáveis).

A imagem a seguir mostra as Ações Universais para Cartões Adaptáveis para o Teams e o Outlook:

Exibições Específicas do Usuário

Hoje, todos os usuários no chat ou canal do Teams veem exatamente as mesmas ações de exibição e botão no Cartão Adaptável. No entanto, em determinados cenários, há um requisito para que determinados usuários ajam de forma diferente e tenham acesso a informações diferentes no mesmo chat ou canal.

Por exemplo, se você enviar um card de relatório de incidentes em um chat ou canal, somente o usuário atribuído ao incidente deverá ver um botão Resolver. Por outro lado, o criador do incidente deve ver um botão Editar e todos os outros usuários devem poder exibir apenas detalhes do incidente. Isto é possível graças às Vistas Específicas do Usuário que são ativadas pela refresh propriedade.

A imagem a seguir mostra um exemplo de uma ME (extensão de mensagem de ticketing) em que diferentes usuários no chat veem ações diferentes com base no requisito:

Para obter mais informações, consulte o exemplo para Exibições Específicas do Usuário.

Suporte ao fluxo de trabalho sequencial

Com o suporte ao fluxo de trabalho sequencial, os usuários podem progredir em uma série de fluxos de trabalho sem enviar cartões diferentes separadamente. Isso é possível graças à capacidade de Action.Execute retornar um Cartão Adaptável em resposta a uma ação. Além disso, qualquer usuário no chat ou canal pode avançar no fluxo de trabalho sem modificar o card para outros usuários no chat.

A imagem a seguir ilustra um exemplo de bot de pedidos de comida:

Fluxo de trabalho sequencial

A imagem a seguir mostra os vários estados para diferentes usuários no chat ou canal:

Estados do bot de catering

Para obter mais informações, consulte o exemplo de Fluxo de Trabalho Sequencial.

Exibições atualizadas

Você pode criar Cartões Adaptáveis que são atualizados automaticamente. Por exemplo, pode ser uma solicitação de aprovação enviada por um usuário. Após a aprovação, o card deve exibir automaticamente detalhes sobre a hora de aprovação da solicitação e quem aprovou a solicitação. O modelo de atualização permite que você forneça essas exibições atualizadas. A imagem a seguir mostra um fluxo de aprovação em várias etapas e como os modos de exibição de diferentes usuários são mostrados.

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

Para obter mais informações, consulte o exemplo para obter exibições atualizadas.

Agora, você pode entender como os Cartões Adaptáveis podem ser transformados com o novo modelo de Ações Universais para fornecer uma experiência de usuário exclusiva e aprimorada.

Cartões Adaptáveis e o novo modelo de Ações Universais

Os 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. Para obter mais informações, Cartões Adaptáveis. As novas Ações Universais para Cartões Adaptáveis permitem um tratamento comum das ações do Cartão Adaptável entre plataformas e aplicativos. Para obter mais informações, consulte Modelo de Ação Universal.

Você pode começar atualizando cenários usando o guia de início rápido e aproveitar as Ações Universais.

Próxima etapa

Trabalhar com Ações Universais para Cartões Adaptáveis

Confira também

  • Last updated on