Os controles Cartão são os blocos de construção dos controles Editar formulário e Exibir formulário. O formulário representa todo o registro, e cada cartão representa um único campo desse registro.
A maneira mais fácil de interagir com cartões é por meio do painel direito quando um controle de formulário foi selecionado no espaço de trabalho de design. Nesse painel, é possível escolher quais campos a serem mostrados, escolher como cada campo devem ser mostrado e reorganizá-los.
Para começar a usar cartões, consulte adicionar um formulário e entender formulários de dados. O restante deste tópico apresenta mais detalhes sobre como os cartões funcionam e como é possível personalizar ou até mesmo criar seu próprio cartão.
Cartões predefinidos
O PowerApps oferece um conjunto predefinido de cartões para cadeias de caracteres, números e outros tipos de dados. No painel direito, é possível ver as variações disponíveis e alterar o cartão usado para um campo:
Nesse exemplo, um cartão de texto de linha única foi selecionado, mas o texto da URL é maior do que pode ser mostrado em uma única linha. Vamos alterá-lo para um cartão de texto de várias linhas para dar aos usuários mais espaço para editar:
Observe também que vários campos dessa fonte de dados não estão sendo mostrados. Mostre e oculte um campo selecionando a caixa de seleção:
Personalizar um cartão
Os cartões abrangem outros controles. O usuário insere dados em um controle Entrada de texto padrão que você adicionar na guia Inserir.
Vamos examinar alguns exemplos de como alterar a aparência do cartão manipulando controles.
Primeiro, vamos voltar para o cartão que inserimos mais recentemente, no campo SecurityCode. Selecione este cartão clicando ou tocando nele uma vez:
Selecione o controle Entrada de texto dentro do cartão clicando ou tocando no próprio controle.
Mova esse controle para dentro do cartão arrastando a caixa de seleção e redimensione o controle arrastando as alças ao longo da borda da caixa de seleção:
É possível redimensionar, mover e fazer outras modificações no controle, mas não é possível excluí-lo sem desbloqueá-lo primeiro. A próxima seção descreve como desbloquear um cartão.
Insira um ou mais controles no cartão, como esta forma de estrela no menu Formas na guia Inserir:
Este novo controle agora faz parte do cartão e o acompanhará se, por exemplo, você reorganizar os cartões dentro do formulário.
Como outro exemplo, mostre uma imagem em um controle Imagem em vez da URL da imagem em um controle Entrada de texto, como mostra este gráfico
Na guia Inserir, adicione um controle de imagem no cartão ImageURL:
Na barra de fórmulas, defina a propriedade Image desse controle como TextBox.Text, em que TextBox é o nome do controle Texto de entrada que contém a URL:
Dica: pressione a tecla Alt para mostrar o nome de cada controle.
E agora é possível ver as imagens e editar suas URLs. Observe que poderíamos ter usado Parent.Default como a propriedade Imagem, mas ela não teria sido atualizada quando o usuário inserisse uma nova URL.
Podemos fazer a mesma coisa na segunda tela desse aplicativo, em que podemos usar um controle Exibir formulário para exibir os detalhes de um registro. Aqui, podemos querer ocultar o rótulo (defina a propriedade Visible do controle de caixa de texto, não o cartão, como false), porque o usuário não editará a URL nessa tela:
Desbloquear uma ficha
Além de conter controles, os cartões em si são controles que têm propriedades e fórmulas como qualquer outro controle. Quando você opta por exibir um campo em um formulário, o painel direito cria automaticamente o cartão para você e gera as fórmulas necessárias. Podemos ver essas fórmulas no painel Avançado, disponível na guia Exibir:
Vemos imediatamente uma das propriedades mais importantes do cartão: a propriedade DataField. Essa propriedade indica qual campo da fonte de dados que o usuário vê e pode editar nesse cartão.
No modo de exibição Avançado, na faixa grande na parte superior, indica que as propriedades desse cartão estão bloqueadas. Um ícone de cadeado também é exibido ao lado das propriedades DataField, Padrão e DisplayName. O painel direito criou essas fórmulas, e o bloqueio impede alterações acidentais nessas propriedades.
Clique ou toque na faixa na parte superior para desbloquear o cartão para que você possa modificar essas propriedades:
Vamos modificar o DisplayName para colocar um espaço entre Ativo e ID. Com essa alteração, vamos alterar o que foi gerado para nós. No painel direito, esse cartão tem um rótulo diferente:
Agora assumimos o controle desse cartão e podemos modificá-lo ainda mais de acordo com as nossas necessidades. Mas perdemos a capacidade de alterar o cartão de uma representação para outra (por exemplo, o texto de linha única para texto de várias linhas) como fizemos antes. Nos transformamos o cartão predefinido em um "cartão personalizado" que controlamos agora.
Uma nota de advertência: não será possível bloquear um cartão novamente se você o desbloquear. Para retornar a um estado bloqueado, remova o cartão e insira-o novamente no painel direito.
Interagir com o formulário
Depois de desbloquear o cartão, é possível alterar a maneira como ele interage com o formulário que o contém.
Abaixo há algumas diretrizes sobre como os controles devem funcionar com o cartão e como os cartões devem funcionar com o formulário. Essas são apenas diretrizes. Como em qualquer controle no PowerApps, é possível criar fórmulas que referenciam qualquer outro controle no PowerApps e isso também ocorre com cartões e controles dentro de cartões. Seja criativo: é possível criar um aplicativo de várias maneiras.
Propriedade DataField
A propriedade mais importante no cartão é a propriedade DataField. Essa propriedade realiza a validação, qual campo é atualizado e outros aspectos do cartão.
Fluxo de entrada de informações
Como um contêiner, o formulário disponibiliza ThisItem para todos os cartões dentro dele. Esse registro contém todos os campos do registro atual de seu interesse.
A propriedade Padrão de todo cartão deve ser definida como ThisItem.FieldName. Em determinadas circunstâncias, talvez convenha transformar esse valor na forma de entrada. Por exemplo, talvez convenha formatar uma cadeia de caracteres ou converter o valor de um idioma para outro.
Cada controle no cartão deve referenciar Parent.Default para obter o valor do campo. Essa estratégia fornece um nível de encapsulamento para o cartão para que a propriedade Padrão do cartão possa ser alterada sem alterar as fórmulas internas do cartão.
Por padrão, as propriedades DefaultValue e Obrigatório são extraídas dos metadados da fonte de dados com base na propriedade DataField. É possível substituir essas fórmulas por sua própria lógica, integrando os metadados da fonte de dados usando a função DataSourceInfo.
Fluxo de saída de informações
Depois que o usuário modifica um registro usando controles nos cartões, a função SubmitForm salva essas alterações na fonte de dados. Quando essa função é executada, o controle de formulário lê os valores da propriedade DataField de cada cartão para saber qual campo alterar.
O controle de formulário também lê o valor da propriedade Atualizar de cada cartão. Logo esse valor será armazenado na fonte de dados para esse campo. Este é o lugar para aplicar outra transformação, talvez para reverter a transformação aplicada na fórmula Padrão do cartão.
A propriedade Válido é direcionada dos metadados da fonte de dados, com base na propriedade DataField. Ela também é baseada na propriedade Obrigatório e se a propriedade Atualizar contiver um valor. Se o valor na propriedade Atualizar não for válido, a propriedade Erro fornecerá uma mensagem de erro amigável.
Se a propriedade DataField de um cartão estiver em branco, o cartão será apenas um contêiner de controles. Suas propriedades Válido e Atualizar não participam quando o formulário é enviado.
Dissecando um exemplo
Vamos examinar os controles que compõem um cartão básico de entrada de dados. O espaço entre controles foi aumentado para mostrar cada um de forma mais clara:
Mantenha pressionada a tecla Alt para mostrar os nomes dos controles que compõem este cartão:
Quatro controles fazem esse cartão funcionar:
| Nome | Tipo | Descrição |
| TextRequiredStar | Controle Rótulo | Exibe uma estrela, normalmente usada em formulários de entrada de dados para indicar que um campo é obrigatório. |
| TextFieldDisplayName | Controle Rótulo | Exibe o nome amigável desse campo. Esse nome pode ser diferente do que está no esquema da fonte de dados. |
| InputText | Controle Texto de entrada | Exibe o valor inicial do campo e permite que o usuário altere esse valor. |
| TextErrorMessage | Controle Rótulo | Exibe uma mensagem de erro amigável ao usuário se ocorre um problema com a validação. Também garante que o campo tem um valor caso seja obrigatório ter um. |
Para preencher esses controles com os dados, suas propriedades podem ser controladas com base nas propriedades do cartão, por meio dessas fórmulas principais. Observe que nenhuma dessas fórmulas se refere a um campo específico. Em vez disso, todas as informações são provenientes do cartão.
| Propriedade Controle | Fórmula | Descrição |
| TextRequiredStar.Visible | Parent.Required | A estrela será exibida somente se o campo for obrigatório. Obrigatório é uma fórmula controlada por você ou pelos metadados da fonte de dados. |
| TextFieldDisplayName.Text | Parent.DisplayName | O controle de caixa de texto mostra o nome amigável, que você ou os metadados da fonte de dados fornece e que está definido na propriedade DisplayName do cartão. |
| InputText.Default | Parent.Default | O controle de entrada de texto mostra inicialmente o valor do campo da fonte de dados, conforme fornecido pelo valor padrão do cartão. |
| TextErrorMessage.Text | Parent.Error | Se ocorrer um problema de validação, a propriedade Erro do cartão fornecerá uma mensagem de erro apropriada. |
Para extrair informações desses controles e retorná-las para a fonte de dados, temos as seguintes fórmulas principais:
| Nome do controle | Fórmula | Descrição |
| DataCard.DataField | "ApproverEmail" | O nome do campo ao qual o usuário pode exibir e editar nesse cartão. |
| DataCard.Update | InputText.Text | O valor a ser validado e retornado para a fonte de dados quando SubmitForm é executado. |