Nocións acerca dos cartóns de datos nas aplicacións de lenzo

Os controis de visualización de formularios e editar formularios nas aplicacións de lenzo son contedores para rexistros enteiros. Cada formulario ten varios controis de tarxetas, que son os bloques de construción do formulario. Cada tarxeta mostra ou permítelle editar un único campo do rexistro e enlaza a ese campo a través da súa propiedade DataField . O formulario mostra o rexistro completo e cada tarxeta céntrase nun campo, polo que controlas como se mostran ou actualizan os datos.

Abre a túa aplicación para editala en Power Apps Studio. Na vista en árbore, seleccione un control de formulario. No panel Propiedades , escolla que campos mostrar, como mostrar cada campo e a orde para mostralos. Por exemplo, a seguinte captura de pantalla mostra un control Editar formulario nunha aplicación construída a partir dunha lista chamada Assets, onde se personalizan os campos para adaptarse ás súas necesidades.

Comeza coas tarxetas lendo , engade un formulario e comprende os formularios de datos. Este artigo explica como funcionan as tarxetas e como personalizar ou crear as túas.

Tarxetas predefinidas

Power Apps ofrece un conxunto predefinido de tarxetas para cadeas, números e outros tipos de datos, para que poidas adaptar a túa aplicación a necesidades de datos específicas. No panel dereito, verá os tipos dispoñibles e pode cambiar a tarxeta dun campo.

Neste exemplo, seleccionouse unha tarxeta de texto dunha soa liña, pero o texto da URL é máis longo que o que cabe nunha liña. Cambia isto por unha tarxeta de texto de varias liñas para que os usuarios teñan máis espazo para editar.

Non se mostran varios campos desta fonte de datos, pero podes mostrar ou ocultar un campo seleccionando a súa caixa de verificación. Este exemplo mostra como mostrar o campo SecurityCode .

Personalizar un cartón

As tarxetas teñen outros controis. Nun control Editar formulario , o usuario introduce datos nun control estándar Introducción de texto que engade desde a pestana Inserir .

Este artigo explica como cambiar o aspecto dunha tarxeta cambiando os controis nela.

1. En primeiro lugar, volve á tarxeta que se inseriu máis recentemente para o campo SecurityCode . Seleccione esta tarxeta seleccionándoa unha vez:

   

2. Seleccione o control de entrada de texto dentro da tarxeta seleccionando o propio control de entrada.

   

3. Move o control dentro da tarxeta arrastrando a caixa de selección e cambia o seu tamaño arrastrando os mangos ao longo do bordo da caixa de selección.

Cambia o tamaño, move e fai outras modificacións nos controis dunha tarxeta, pero non podes eliminala sen desbloqueala antes.

Desbloquear unha tarxeta

Ademais de conter controis, as propias tarxetas son controis con propiedades e fórmulas, que permiten unha personalización avanzada. Cando escolles mostrar un campo nun formulario, o panel da dereita crea automaticamente a tarxeta e xera as fórmulas necesarias, aforrando tempo e esforzo. Podemos ver estas fórmulas na pestana Avanzado do panel da dereita:

Inmediatamente ves unha das propiedades máis importantes da tarxeta: a propiedade DataField . Esta propiedade indica o campo da orixe de datos que o usuario ve e pode editar nesta tarxeta.

Na pestana Avanzado , o banner na parte superior indica que as propiedades desta tarxeta están bloqueadas. Tamén aparece unha icona de bloqueo xunto ás propiedades DataField, DisplayName e Requirido . O panel da dereita creou estas fórmulas e o bloqueo impide cambios accidentais nestas propiedades.

Seleccione o banner na parte superior para desbloquear a tarxeta e así poder modificar estas propiedades:

Modifica o DisplayName para poñer un espazo entre Recurso e ID. Ao facer este cambio, imos modificando o que se xerou para nós. No panel dereito, esta tarxeta ten unha etiqueta diferente:

Agora tomaches o control desta tarxeta e podes modificala aínda máis para adaptala ás túas necesidades. Pero perdeches a capacidade de cambiar a tarxeta dunha representación a outra (por exemplo, texto dunha liña a texto de varias liñas) como fixeches antes. Transformaches a tarxeta predefinida nunha "tarxeta personalizada" que agora controlas.

Importante

Non pode volver a bloquear unha tarxeta se a desbloqueou. Para reverter unha tarxeta a un estado bloqueado, elimínea e volva inserila no panel da dereita.

Pode cambiar o aspecto e o comportamento dunha tarxeta desbloqueada de varias formas, como engadir e eliminar os controis dentro dela. Por exemplo, pode engadir unha forma de estrela desde o menú Iconas da pestana Inserir .

A estrela agora forma parte da tarxeta e viaxará con ela se, por exemplo, reordena as tarxetas dentro do formulario.

Como outro exemplo, desbloquea a tarxeta ImaxeURL e despois engádelle un control Imaxe desde a pestana Inserir :

Na barra de fórmulas, establece a Imaxe propiedade deste control en Caixa de texto.Texto, onde Caixa de texto é o nome do control que se introduce contén o URL:

Agora podes ver as imaxes e editar os seus URL. Poderiamos usar Parent.Default como propiedade Image , pero non se actualizaría se o usuario cambiase a URL.

Podemos facer o mesmo na segunda pantalla desta aplicación, onde usamos un control Mostrar formulario para mostrar os detalles dun rexistro. Neste caso, é posible que queiramos ocultar a etiqueta (establece a propiedade Visible da etiqueta, non a tarxeta, como false) porque o usuario non editará o URL nesa pantalla:

Interactuar cun formulario

Despois de desbloquear unha tarxeta, pode cambiar o xeito en que interactúa co formulario que a contén.

Aquí tes pautas sobre como funcionan os controis coa súa tarxeta e como funcionan as tarxetas co formulario. Estas directrices axúdanche a comprender como crear fórmulas que fan referencia a outros controis, incluíndo tarxetas e controis dentro das tarxetas. Sexa creativo: podes crear unha aplicación de moitas maneiras para satisfacer as túas necesidades específicas.

Propiedade DataField

A propiedade máis importante da tarxeta é a propiedade DataField . Esta propiedade controla a validación, determina que campo se actualiza e xestiona outros aspectos da tarxeta.

Información entrante

Como contedor, o formulario fai ThisItem dispoñible para todas as tarxetas que contén. Este rexistro contén todos os campos do rexistro de interese actual.

A propiedade predeterminada de cada tarxeta debe establecerse en ThisItem.FieldName. Nalgúns casos, pode transformar este valor a medida que aparece. Por exemplo, pode querer formatar unha cadea ou traducir o valor dun idioma a outro.

Cada control da tarxeta debe facer referencia a Parent.Default para obter o valor do campo. Esta estratexia encapsula a tarxeta, permitindo que a propiedade Predeterminada da mesma cambie sen afectar as súas fórmulas internas.

De xeito predeterminado, as propiedades DefaultValue e obrigatorias tómanse dos metadatos da fonte de datos en función da propiedade DataField . Podes anular estas fórmulas coa túa propia lóxica, integrando os metadatos da fonte de datos mediante a función DataSourceInfo .

Información saínte

Despois de que o usuario modifique un rexistro mediante os controis das tarxetas, a función Enviar formulario garda eses cambios na fonte de datos. Cando se executa esa función, o control de formulario le os valores da propiedade DataField de cada tarxeta para saber que campo cambiar.

O control do formulario tamén le o valor da propiedade Actualizar de cada tarxeta. Este valor gárdase na fonte de datos deste campo. Este é o lugar para aplicar outra transformación, quizais para inverter a transformación que se aplicou na fórmula Predeterminada da tarxeta.

A propiedade Valid prodúcese a partir dos metadatos da fonte de datos, baseándose na propiedade DataField . Tamén se basea na propiedade Requirido e se a propiedade Actualizar contén un valor. Se o valor da propiedade Actualizar non é válido, a propiedade Erro ofrece unha mensaxe de erro sinxela.

Se a propiedade DataField dunha tarxeta está en branco, a tarxeta actúa como contenedor para os controis. As súas propiedades Válidas e Actualización non participan cando se envía o formulario.

Dissección dun exemplo

Exploremos os controis que constitúen unha tarxeta básica de entrada de datos. O espazo entre os controis aumenta para mostrar cada un con máis claridade, axudándoche a comprender como cada compoñente contribúe á funcionalidade da tarxeta:

Neste gráfico etiquetáronse os controis dentro da tarxeta de datos:

Catro controis fan que a tarxeta funcione:

Nome	Tipo	Descripción
TextRequiredStar	Control de etiqueta	Mostra unha estrela, que se usa habitualmente nos formularios de entrada de datos para indicar que se require un campo.
TextFieldDisplayName	Control de etiqueta	Mostra o nome fácil de usar do campo. Este nome pode diferir do que está no esquema da fonte de datos.
Texto de entrada	Control de entrada de texto	Mostra o valor inicial do campo e permite ao usuario cambiar ese valor.
TextErrorMessage	Control de etiqueta	Mostra unha mensaxe de erro fácil de usar para o usuario se se produce un problema coa validación. Tamén garante que o campo teña un valor se é necesario.

Para encher estes controis con datos, as súas propiedades son impulsadas desde as propiedades da tarxeta a través destas fórmulas clave. As fórmulas fan referencia a un campo específico. Pola contra, toda a información provén da tarxeta.

Propiedade de control	Fórmula	Descripción
TextRequiredStar.Visible	Pai.Requerido	A estrela só aparece se o campo é obrigatorio. Necesario é unha fórmula xerada por vostede ou polos metadatos da orixe de datos.
TextFieldDisplayName.Text	Parent.DisplayName	O control da caixa de texto mostra o nome fácil de usar, que proporciona vostede ou os metadatos da fonte de datos, e que está definido na propiedade DisplayName da tarxeta.
InputText.Default	Pai.Predeterminado	O control de entrada de texto mostra inicialmente o valor do campo da orixe de datos, como foi fornecido polo valor predeterminado da tarxeta.
TextErrorMessage.Text	Pai.Erro	Se se produce un problema de validación, a propiedade Erro da tarxeta proporciona unha mensaxe de erro adecuada.

Nota

A propiedade Parent.Error é unha propiedade só de saída que non pode establecer mediante unha fórmula. Esta propiedade non aparece na lista de propiedades situadas preto da esquina superior esquerda nin nas pestanas Propiedades ou Avanzado preto do bordo dereito. A barra de fórmulas suxire esta propiedade se estás escribindo unha fórmula que fai referencia á propiedade.

Para extraer información destes controis e empurrala de novo na fonte de datos, use as seguintes fórmulas clave:

Nome do control	Fórmula	Descripción
DataCard.DataField	"Correo electrónico de aprobación"	O nome do campo que o usuario pode amosar e editar nesta tarxeta.
DataCard.Actualización	InputText.Text	O valor para validar e enviar de novo á fonte de datos cando se executa SubmitForm .