Ações Universais para Cartões Adaptáveis
As Ações Universais para Cartões Ajustáveis evoluíram a partir do feedback dos programadores de que, apesar de o esquema e a composição dos Cartões Ajustáveis ser universal, o processamento de ações não era. Mesmo que um programador quisesse enviar o mesmo cartão para locais diferentes, teria de processar as ações de forma diferente.
As Ações Universais para Cartões Ajustáveis trazem o bot como o back-end comum para processar ações e introduzem um novo tipo de ação, Action.Execute, que funciona em todas as aplicações, como o Teams e o Outlook.
Este documento ajuda-o a compreender como pode utilizar o modelo de Ações Universais para melhorar a experiência do utilizador de interagir com Cartões Ajustáveis entre plataformas e aplicações.
Melhorar as experiências dos utilizadores com As Ações Universais para Cartões Ajustáveis
As Ações Universais para Cartões Ajustáveis melhoram a experiência do utilizador ao ativar os seguintes cenários:
- Ações Universais
- Exibições Específicas do Usuário
- Suporte de Fluxo de Trabalho Sequencial
- Vistas atualizadas
Ações Universais
Antes das Ações Universais para Cartões Ajustáveis, diferentes anfitriões forneceram diferentes modelos de ação da seguinte forma:
- O Teams ou os bots utilizaram
Action.Submit, uma abordagem que adia o modelo de comunicação real para o canal subjacente. - O Outlook utilizado
Action.Httppara comunicar com o serviço de back-end especificado explicitamente no payload cartão ajustável.
A imagem seguinte mostra o atual modelo de ação inconsistente:
Com as Ações Universais para Cartões Ajustáveis, pode utilizar Action.Execute o processamento de ações em diferentes plataformas.
Action.Execute funciona em todos os hubs, incluindo o Teams e o Outlook e não Action.Submitsubstitui o . Por exemplo, se pretender que um sistema externo efetue uma ação e o resultado da ação tiver de ser enviado de volta para a sua conversa através da Extensão de Mensagens, Action.Execute não é suportado.
Para cartões de desfraldamento de ligações , como cartões de destaque e miniaturas, tem de chamar Action.Submit.
Além disso, um Cartão Ajustável pode ser devolvido como resposta para um Action.Execute pedido de invocação acionado.
A imagem seguinte mostra o novo modelo de Ação Universal:
Agora, pode enviar o mesmo cartão para o Teams e o Outlook e mantê-los sincronizados uns com os outros através do bot subjacente. Qualquer ação executada em qualquer uma das plataformas é refletida para a outra com esta compilação uma vez, implementar em qualquer lugar (Ações Universais para Cartões Ajustáveis).
A imagem seguinte ilustra as Ações Universais para Cartões Ajustáveis para o Teams e o Outlook:
Exibições Específicas do Usuário
Hoje em dia, todos os utilizadores no chat ou canal do Teams veem exatamente as mesmas ações de visualização e botão no Cartão Ajustável. No entanto, em determinados cenários, existe um requisito para determinados utilizadores agirem de forma diferente e terem acesso a informações diferentes no mesmo chat ou canal.
Por exemplo, se enviar um cartão de relatório de incidentes numa conversa ou canal, apenas o utilizador a quem foi atribuído o incidente tem de ver um botão Resolver . Por outro lado, o criador do incidente tem de ver um botão Editar e todos os outros utilizadores só têm de conseguir ver os detalhes do incidente. Isto é possível graças às Vistas Específicas do Utilizador que são ativadas pela refresh propriedade .
A imagem seguinte mostra um exemplo de uma extensão de mensagens de permissão (ME) onde diferentes utilizadores no chat são mostrados diferentes ações com base no requisito:
Para obter mais informações, veja exemplo de Vistas Específicas do Utilizador.
Suporte de Fluxo de Trabalho Sequencial
Com o suporte do Fluxo de Trabalho Sequencial, os utilizadores podem progredir através de uma série de fluxos de trabalho sem enviar cartões diferentes separadamente. Isto é possível graças à capacidade de Action.Execute devolver um Cartão Ajustável em resposta a uma ação. Além disso, qualquer utilizador no chat ou canal pode progredir através do fluxo de trabalho sem modificar o cartão para outros utilizadores no chat.
A imagem seguinte ilustra um exemplo de bot de ordenação de alimentos:
A imagem seguinte mostra os vários estados para diferentes utilizadores no chat ou canal:
Para obter mais informações, veja exemplo de Fluxo de Trabalho Sequencial.
Vistas atualizadas
Pode criar Cartões Ajustáveis que são atualizados automaticamente. Por exemplo, pode ser um pedido de aprovação enviado por um utilizador. Após a aprovação, o cartão tem de apresentar automaticamente detalhes sobre o tempo de aprovação do pedido e quem aprovou o pedido. O modelo de atualização permite-lhe fornecer essas vistas atualizadas. A imagem seguinte mostra um fluxo de aprovação de vários passos e como as vistas para diferentes utilizadores são apresentadas.
Para obter mais informações, veja exemplo de vistas atualizadas.
Agora, pode compreender como os Cartões Ajustáveis podem ser transformados com o novo modelo de Ações Universais para proporcionar uma experiência de utilizador única e melhorada.
Cartões Ajustáveis e o novo modelo de Ações Universais
Os Cartões Ajustáveis são uma combinação de conteúdo, como texto e gráficos, e ações que podem ser executadas por um utilizador. Para obter mais informações, Cartões Adaptáveis. As novas Ações Universais para Cartões Ajustáveis permitem um processamento comum das ações do Cartão Ajustável entre plataformas e aplicações. Para obter mais informações, veja Modelo de Ação Universal.
Pode começar por atualizar cenários com o guia de início rápido e tirar partido das Ações Universais.