Componentes do Ciclo Baseado em Cartões Adaptáveis

Observação

Os componentes do Ciclo Baseado em Cartões Adaptáveis requerem a versão 1.6 ou posterior dos Cartões Ajustáveis.

Os componentes do Ciclo Baseado em Cartões Adaptáveis permitem-lhe criar experiências de colaboração nas extensões de mensagens do Microsoft Teams que funcionam no Microsoft 365. Os componentes do Ciclo Baseado em Cartões Adaptáveis têm conteúdos acionáveis que permitem aos utilizadores efetuar atualizações em direto sem terem de mudar de contexto entre aplicações do Microsoft 365, como o Teams e o Outlook.

Os componentes de ciclo foram lançados pela primeira vez no Teams, seguidos por outras aplicações do Microsoft 365, como a aplicação Outlook, Whiteboard e Loop. Os componentes de ciclo permitem que os utilizadores colaborem e partilhem conteúdos em direto com outras pessoas na aplicação chat, e-mail, reunião, Quadro ou Loop. Uma vez que os componentes do Loop se mantêm sincronizados em diferentes aplicações do Microsoft 365, permitem que os utilizadores cocriem conteúdos e façam atualizações em tempo real nos respetivos conteúdos. Para obter mais informações, veja Descrição geral dos componentes do Loop no ecossistema do Microsoft 365.

Segue-se um exemplo de um componente do Ciclo Baseado em Cartões Ajustável:

Este artigo fornece uma descrição geral de como criar e testar os componentes do Ciclo Baseado em Cartões Ajustáveis.

Pré-requisitos

Antes de criar um componente do Ciclo Baseado em Cartões Ajustável, certifique-se de que cumpre os seguintes pré-requisitos:

1. Crie uma extensão de mensagem com um comando de pesquisa.

2. Adicione o suporte de desfraldamento da ligação à extensão de mensagem.

3. Utilize ações universais para cartões ajustáveis.

4. Expanda a extensão de mensagens do Teams através do Microsoft 365.

Criar componente de Ciclo Baseado em Cartões Adaptável

Para criar o componente Ciclo Baseado em Cartões Ajustável, siga estes passos:

1. Certifique-se de que o Cartão Ajustável cumpre as diretrizes de conceção para criar uma experiência baseada em Cartões Adaptável acionável e coerente para os seus utilizadores finais.
2. Para ativar o componente Loop, adicione o URL que identifica exclusivamente o cartão na propriedade metadata.webUrl no esquema cartão ajustável. A metadata.webUrl propriedade suporta portabilidade através do botão Copiar presente no cabeçalho do componente Ciclo.

Exemplo

Segue-se um exemplo JSON de um componente Do Ciclo Baseado em Cartões Ajustável com as metadata propriedades e webUrl :

{
  "type": "AdaptiveCard",
  "version": "1.6",
  "metadata": {
    "webUrl": "https://contoso.com/tab"
  },
  "body": [
    {
      ....
    },
  ]
  }

Parâmetros de consulta

Propriedade	Tipo	Descrição	Obrigatório
metadata	Metadata	Define várias propriedades de metadados normalmente não utilizadas para compor o cartão.	Não
webUrl	Cadeia de caracteres	URL que identifica exclusivamente o cartão e serve como uma contingência do browser que pode ser utilizada por alguns anfitriões.	Não

Testar o componente Loop

Pode testar o componente Loop nos ambientes de programador do Teams e do Outlook para a Web.

Testar no Microsoft Teams

Para configurar, distribuir e gerir a sua aplicação, utilize o Portal do Programador para Teams. Pode testar e depurar a sua aplicação no Portal do Programador com as seguintes opções:

• Página descrição geral: na página Descrição geral, em Validação da loja Teams, pode ver um instantâneo da configuração da sua aplicação e verificar se o pacote de aplicações é validado em relação a casos de teste da Microsoft Teams Store.
• Pré-visualização no Teams: o botão Pré-visualizar no Teams inicia rapidamente a sua aplicação no cliente do Teams para depuração.

Testar no Outlook para Web

Para ativar o componente Ciclo Baseado em Cartões Ajustável no Outlook para a Web, siga estes passos:

1. Crie uma extensão de mensagem baseada na pesquisa com o Campo de Aplicações do Teams.
2. Crie um inquilino para programadores do Microsoft 365 ou inicie sessão com as suas credenciais de inquilino de teste.

O Cartão Ajustável gerado pela sua aplicação é composto como um componente Loop.

Exemplo de código

Nome de exemplo	Descrição	Node.js	.NET	Manifesto
Extensão de mensagem com Componente de Ciclo Baseado em Cartões Adaptável	Este exemplo demonstra como criar uma extensão de mensagem com o componente Ciclo Baseado em Cartões Ajustável.	View	View	Exibir

Confira também

Estruturar o componente Loop