Compreender cartões de dados nas aplicações de tela

Controlo de formulário de exibição e Controlo de formulário de edição em aplicações de tela são contêineres para registros inteiros. Cada formulário tem vários Controlos de cartão, que são os blocos modulares do formulário. Cada cartão mostra ou permite editar um único campo do registo e cria links para esse campo através da sua propriedade DataField. O formulário mostra o registro completo e cada cartão se concentra em um campo, para que você controle como os dados são mostrados ou atualizados.

Abra seu aplicativo para edição no Power Apps Studio. No modo de exibição de árvore, selecione um controle de formulário. No painel Propriedades , escolha quais campos mostrar, como mostrar cada campo e a ordem para mostrá-los. Por exemplo, a captura de tela a seguir mostra um controle Editar formulário em um aplicativo criado a partir de uma lista chamada Ativos, onde você personaliza campos para atender às suas necessidades.

Comece com cartões lendo adicionar um formulário e entender os formulários de dados. Este artigo explica como os cartões funcionam e como personalizar ou criar os seus próprios.

Cartões predefinidos

O Power Apps oferece um conjunto predefinido de cartões para cadeias de caracteres, números e outros tipos de dados, para que possa adaptar a sua aplicação às necessidades de dados específicas. No painel da direita, pode ver os tipos disponíveis e pode alterar o cartão para um campo.

Neste exemplo, um cartão de texto de linha única é selecionado, mas o texto da URL é maior do que o que cabe em uma linha. Altere isso para um cartão de texto de várias linhas para que os usuários tenham mais espaço para editar.

Vários campos nesta origem de dados não são apresentados, mas pode mostrar ou ocultar um campo, selecionando a caixa de verificação. Este exemplo mostra como mostrar o campo SecurityCode .

Personalizar um cartão

Os cartões têm outros controles. Num controlo de Editar formulário, o utilizador introduz dados num controlo de Introdução de texto padrão, que adiciona a partir do separador Inserir.

Este artigo explica como alterar a aparência de um cartão alterando os controles nele.

1. Em primeiro lugar, regresse ao cartão que foi inserido mais recentemente para o campo SecurityCode. Selecione este cartão selecionando-o uma vez:

   

2. Selecione o controle de entrada de texto dentro do cartão selecionando o próprio controle de entrada.

   

3. Mova o controle dentro do cartão arrastando a caixa de seleção e redimensione-o arrastando as alças ao longo da borda da caixa de seleção.

Redimensione, mova e faça outras modificações a controlos dentro de um cartão, mas não pode eliminá-lo sem o desbloquear primeiro.

Desbloquear um cartão

Para além dos controlos que contêm, os próprios cartões são controlos com propriedades e fórmulas, o que permite personalização avançada. Quando opta por apresentar um campo num formulário, o painel da direita cria automaticamente o cartão e gera as fórmulas necessárias, o que lhe poupa tempo e esforça. É possível ver estas fórmulas no separador Avançadas do painel da direita:

Vê de imediato uma das propriedades mais importantes do cartão: a propriedade DataField. Esta propriedade indica o campo da origem de dados que o utilizador vê e pode editar neste cartão.

No separador Avançadas, a faixa na parte superior do separador indica que as propriedades deste cartão estão bloqueadas. Um ícone de cadeado também é apresentado junto às propriedades DataField, DisplayName e Required. O painel da direita criou estas fórmulas e o cadeado impede alterações acidentais a essas propriedades.

Selecione a faixa na parte superior para desbloquear o cartão, de modo a que possa modificar estas propriedades:

Modifique a propriedade DisplayName para colocar um espaço entre Ativo e ID. Ao fazer esta alteração, estamos a alterar o que foi gerado automaticamente. No painel da direita, este cartão tem uma etiqueta diferente:

Agora, já assumiu o controlo deste cartão e podemos modificá-lo mais de acordo com as suas necessidades. Porém, perdeu a capacidade de alterar o cartão de uma representação para outra (por exemplo, texto de linha única para texto com várias linhas), tal como fez anteriormente. Transformou o cartão predefinido num "cartão personalizado" que agora controla.

Pode alterar o aspeto e o comportamento de um cartão desbloqueado de diversas formas, tal como ao adicionar e eliminar controlos no mesmo. Por exemplo, pode adicionar uma forma de estrela a partir do menu Ícones no separador Inserir.

A estrela faz agora parte do cartão e será movida com ele se, por exemplo, reordenar os cartões dentro do formulário.

Outro exemplo: desbloqueie o cartão ImageURL e, em seguida, adicione um controlo de Imagem ao mesmo a partir do separador Inserir:

Na barra de fórmulas, defina a propriedade Imagem deste controlo como TextBox.Texto, sendo que TextBox é o nome do controlo de Introdução de texto que contém o URL:

Agora, pode ver as imagens e editar os respetivos URLs. Poderíamos ter usado Parent.Default como a propriedade Image , mas ela não teria sido atualizada se o usuário alterasse a URL.

Podemos fazer o mesmo no segundo ecrã desta aplicação, onde utilizámos um controlo de Formulário de apresentação para mostrar os detalhes de um registo. Neste caso, podemos querer ocultar a etiqueta (definir a propriedade Visível da etiqueta, e não do cartão, como falso) porque o utilizador não irá editar o URL nesse ecrã:

Interagir com um formulário

Depois de desbloquear um cartão, pode alterar a forma como interage com o formulário que o contém.

Eis as diretrizes para como os controlos funcionam com o respetivo cartão e como os cartões funcionam com o formulário. Estas diretrizes ajudam-no a compreender como criar fórmulas que referenciam outros controlos, incluindo cartões e controlos dentro de cartões. Seja criativo — pode criar uma aplicação de várias maneiras para satisfazer as suas necessidades específicas.

Propriedade DataField

A propriedade mais importante no cartão é a propriedade DataField. Esta propriedade controla a validação, determina que campo é atualizado e gere outros aspetos do cartão.

Entrada de informações

Como contentor, o formulário torna ThisItem disponível para todos os cartões dentro do mesmo. Este registo contém todos os campos para o registo de interesse atual.

A propriedade Predefinição de cada cartão deve ser definida como ThisItem.FieldName. Em alguns casos, pode transformar este valor à medida que entra. Por exemplo, pode querer formatar uma cadeia ou traduzir o valor de um idioma para outro.

Cada controlo no cartão deve fazer referência a Parent.Default para obter no valor do campo. Esta estratégia encapsula o cartão, permitindo que a propriedade Predefinida do cartão seja alterada sem afetar as suas fórmulas internas.

Por predefinição, as propriedades DefaultValue e Obrigatório são obtidas a partir dos metadados da origem de dados com base na propriedade DataField. Pode substituir estas fórmulas pela sua própria lógica, integrando os metadados da origem de dados através da função DataSourceInfo.

Saída de informações

Depois de o utilizador modificar um registo através de controlos nos cartões, a função SubmitForm guarda essas alterações à origem de dados. Quando essa função é executada, o controlo de formulário lê os valores da propriedade DataField de cada cartão para saber que campo alterar.

O controlo de formulário também lê o valor da propriedade Atualizar de cada cartão. Este valor é armazenado na origem de dados para este campo. Este é o local onde aplicar outra transformação, talvez para inverter a transformação que foi aplicada na fórmula Predefinição do cartão.

A propriedade Válido é condicionada a partir dos metadados da origem de dados, com base na propriedade DataField. Também se baseia na propriedade Obrigatório e no facto de a propriedade Atualizar incluir ou não um valor. Se o valor na propriedade Atualizar não for válido, a propriedade Erro fornece uma mensagem de erro simples.

Se a propriedade DataField de um cartão estiver vazia, o cartão age como um contentor para controlos. As respetivas propriedades Válido e Atualizar não participam quando o formulário é submetido.

Analisar um exemplo em profundidade

Exploremos os controlos que compõem um cartão básico de entrada de dados. O espaço entre os controlos é aumentado para mostrar cada um com mais clareza, ajudando-o a compreender como cada componente contribui para a funcionalidade do cartão:

Neste gráfico, foram rotulados os controlos existentes na placa de dados:

Quatro controlos fazem o cartão funcionar:

Para preencher estes controlos com dados, as respetivas propriedades são condicionadas a partir das propriedades do cartão, através destas fórmulas chave. As fórmulas referem-se a um campo específico. Todas as informações provêm do cartão.

Para extrair informações destes controlos e enviá-las novamente para a origem de dados, use as fórmulas-chave seguintes: