Adicionar variáveis a um cartão

Importante

A partir de 29 de agosto de 2025, os Cartões para o Power Apps serão preteridos e não terão mais suporte. Como resultado, quaisquer Cartões para Power Apps que tenham sido criados e compartilhados no Microsoft Teams não funcionarão. Os usuários não poderão criar novos cartões ou executar os existentes.

Recomendamos migrar qualquer funcionalidade que você dependa de Cartões para Power Apps antes da data de descontinuação. Considere a transição para Cartões Adaptativos no Copilot Studio ou cartões adaptativos para Microsoft Teams de funcionalidade semelhante. Mais informações: Substituição de Cartões do Power Apps

As variáveis armazenam dados para reutilização. Os dados podem ser de diferentes tipos, como coleção, texto ou um número. As variáveis têm nomes exclusivos, que é como você as referencia nas fórmulas do Power Fx. Insira, modifique e remova-os no designer de cartões.

O valor de uma variável pode ser temporário, redefinido para cada sessão do cartão ou permanente, e isso é compartilhado em todas as sessões de uma instância de cartão específica. As variáveis temporárias são diferentes para cada sessão de cartão, mesmo para um único usuário, o que significa que, se você tiver a mesma instância de cartão enviada a você em um chat e um canal, uma variável temporária pode ser diferente nessas duas sessões.

Por exemplo, você criou um cartão que conta quantas vezes o usuário pressiona um botão durante uma sessão. Você criaria uma variável numérica temporária para armazenar o número de pressionamentos de botão na instância atual do cartão. Se também quisesse capturar o nome do último usuário a pressionar um botão para uma instância de cartão, você usaria uma variável de texto permanente. Se, além disso, quisesse salvar os dados entre instâncias de cartão, você usaria uma conexão de dados.

As variáveis também podem ser personalizáveis, o que significa que o valor é definido pelo remetente, seja na página de reprodução antes de enviar como um link ou no Power Automate como parte da ação Criar um instância do cartão.

Pré-requisitos

• Uma conta do Power Apps
• Um cartão

Criar uma variável

1. Entre no Power Apps. Selecione Cartões e um cartão. Se a guia Cartões não estiver visível, selecione Mais e fixe a guia Cartões.

2. No painel esquerdo do designer de cartões, selecione Variáveis

3. Selecione + Nova variável.

4. Na janela Nova variável, defina estes valores:

   • Nome: o nome de sua variável (obrigatório)
   • Tipo: o tipo de variável (obrigatório)
   • Valor padrão: o valor padrão da variável
   • Persistência: se a variável é temporária (reinicia toda vez que o cartão é aberto) ou permanente
   • Personalização: se a variável é personalizável pelo remetente para que atue como uma variável de entrada

   Não é possível alterar o nome ou o tipo de uma variável. Se você precisar alterá-los, crie uma variável.

   Você também pode personalizar as opções do remetente e, em Informações adicionais sobre a variável, o Título e a Descrição da variável. Essas informações podem ser úteis para testar, depurar e usar sua variável com fluxos do Power Automate.

   

5. Selecione Salvar.

Uso do valor padrão para tabelas e registros

O valor padrão é usado para definir a estrutura das variáveis de coleção e registro. Existem duas maneiras de definir o valor padrão de um registro ou variável de tabela:

• Usar o editor de colunas
• Usar Power Fx / JSON

Você pode alternar entre usar o editor de colunas ou o Power Fx / JSON usando o botão de alternância à direita.

Usar uma expressão do Power Fx é útil quando você deseja que a variável armazene dados de um fonte de dados, como o Dataverse. Por exemplo, se você quiser um registro que contenha uma linha específica da tabela Account, poderá definir o valor padrão como First(Account).

As variáveis são fortemente tipadas e, portanto, definir o valor padrão bloqueia a variável nesses tipos.

Edite e exclua variáveis

Para editar ou excluir uma variável, selecione as reticências (...) à direita da variável e selecione Editar ou Excluir.

Usar variáveis em cartões

Há diversas maneiras de usar variáveis em cartões. Saiba mais sobre como trabalhar com variáveis no Power Apps.

Um uso comum para variáveis é em expressões do Power Fx. Consulte a variável pelo nome em sua fórmula. Para obter um exemplo, acesse o tutorial de cartão simples. Suas variáveis também são reconhecidas na barra de fórmulas.

Atualização do valor de uma variável

As variáveis podem ser atualizadas usando a função Set , exceto as variáveis de tabela adicionadas usando a função Collect .