Partilhar via


Descrição geral dos cartões adaptativos do Microsoft Teams

Os cartões adaptativos são um método independente de plataforma para partilhar e apresentar blocos de informações sem a complexidade da personalização de CSS ou HTML para os compor. Cria cartões adaptativos no formato JSON, com integrações que as aplicações e serviços cloud podem trocar de forma aberta. Quando fornecido a um anfitrião específico, como o Microsoft Teams, o ficheiro JSON é transformado numa IU nativa que se adapta automaticamente ao anfitrião. Assim, os designers de processos podem agora fornecer padrões de IU consistentes sempre que precisarem de mostrar informações como parte de um processo/automatização empresarial.

Como os cartões adaptativos se adaptam ao anfitrião, são veículos perfeitos para partilhar informações entre o Microsoft Teams e outros serviços.

Captura de ecrã de cartões adaptativos.

Ações atualmente disponíveis para os fluxos

As ações seguintes permitem aos criadores criar cartões adaptativos para o Microsoft Teams. À medida que os cenários de integração evoluem, outros anfitriões também serão suportados pelo Power Automate, que expandirá as suas oportunidades para tirar partido dos cartões adaptativos nas subscrições de cloud da Microsoft.

Nota

Os cartões adaptativos não estão disponíveis dentro do ambiente DoD (Departamento de Defesa).

Direcionar conteúdo para membros do Teams ou utilizadores do Microsoft Entra

Publique o seu próprio cartão ajustável como o bot do Flow para um utilizador

Esta ação publica um cartão adaptativo como um bot de fluxo para um utilizador específico. Neste caso, necessita de fornecer um endereço de e-mail do destinatário. Em seguida, o cartão aparece nos feeds de chat e/ou de atividades desse destinatário durante a execução do fluxo. Não existe nenhum requisito para que o utilizador faça parte de uma instância do Teams para receber estes tipos de cartões adaptativos. Neste caso, apenas os botões de URL funcionam ao redirecionar para o URL configurado no fluxo.

Publicar um cartão ajustável como bot do Flow para um utilizador do Teams e aguardar resposta

Esta ação publica um cartão ajustável como bot do Flow para um utilizador específico, como o caso apresentado anteriormente neste artigo. No entanto, neste caso, a execução do fluxo não continuará após a publicação até que o destinatário responda às entradas necessárias no cartão. O fluxo continua depois da resposta do destinatário. O fluxo devolve conteúdo dinâmico de uma (1) resposta por destinatário e por cartão.

Direcionar o conteúdo para os canais do Teams

  • Publique o seu próprio cartão ajustável como o bot do fluxo para um canal
    Esta ação publica um cartão adaptativo como um bot do fluxo num canal do Teams específico. Nesse caso, é-lhe pedido para fornecer a instância do Teams e um canal onde o cartão é publicado. O criador do fluxo tem de ter acesso à instância do Teams para publicar lá um cartão adaptativo. Neste caso, apenas os botões de URL funcionam ao redirecionar para o URL configurado no fluxo.

  • Publicar um cartão adaptativo como o bot do fluxo num canal do Teams e aguardar por uma resposta
    Esta ação publica um cartão ajustável como um bot do fluxo num canal do Teams específico, tal como no caso acima. Neste caso, o fluxo não continua até que alguém no canal responda a entradas requeridas no cartão. O fluxo continua assim que alguém no canal do Teams responda, mas apenas devolve conteúdo dinâmico de uma (1) resposta por destinatário e por cartão. Quando utilizar este cartão, o fluxo aguarda uma resposta de qualquer membro do Teams.

Problemas conhecidos

  • Não é possível recolher dados de cartões adaptativos, a menos que sejam criados com uma das ações aguardar resposta. Os cartões adaptativos que não aguardam devolvem um erro para todas as ações de botão, exceto OpenURL. Saiba mais sobre botões OpenURL.

  • A seleção de botões Action.Submit num cartão que não inclui o sufixo aguardar resposta mostra um erro.

  • Os cartões adaptativos criados com as ações aguardar resposta só podem ser submetidos uma vez por cartão. A execução do fluxo continua após a primeira resposta e quaisquer outras submissões serão ignoradas.

  • Apenas as informações na caixa de entrada Atualizar mensagem são mostradas no cartão de substituição depois de os consumidores submeterem o cartão.

    Estão disponíveis detalhes adicionais, como o ID de utilizador da pessoa que submete o cartão, no conteúdo dinâmico nas ações após a ação aguardar resposta. No entanto, poderá ser necessário incluir o conector Utilizadores do Office 365 para completar as informações de perfil desejadas do utilizador que submeteu o cartão.

  • Depois de os cartões adaptativos de aguardar resposta serem submetidos, o cartão é reposto e, em seguida, aparece exatamente igual, a menos que a área da mensagem de substituição/atualização esteja configurada. As mensagens de atualização são uma melhor prática. São recomendadas para atualizar outras e impedir que os consumidores tentem submeter o cartão mais do que uma vez.

    Captura de ecrã de uma mensagem de atualização.

As entradas Atualizar Mensagem e Deve atualizar o cartão terão de ser configuradas se desejar um cartão de substituição.

  • O Power Automate utiliza as caraterísticas e serviços exclusivos dos cartões adaptativos da Microsoft para processar os cartões em qualquer anfitrião. Este artigo destina-se a esclarecer as especificidades relacionadas com ações de fluxo. Também pode utilizar a documentação completa para criar cartões adaptativos.