Entendre les targetes de dades a les aplicacions de llenç

Els controls Targeta són els conjunts de creació dels controls Edita el formulari i Visualitza el formulari a les aplicacions de llenç. El formulari representa tot el registre i cada targeta representa un camp únic d'aquest registre.

Podeu interactuar amb les targetes més fàcilment a la subfinestra de la dreta després d'haver seleccionat un control de formulari a l'àrea de treball del disseny. En aquesta subfinestra, podeu triar quins camps es mostraran, com mostrar cada camp i en quin ordre. En aquest exemple es mostra un control Edita el formulari d'una llista anomenada Actius.

Per començar a treballar amb targetes, vegeu Afegir un formulari i Informació sobre els formularis de dades. La resta d'aquest article entra en més detalls sobre com funcionen les targetes i com podeu personalitzar o fins i tot crear les vostres pròpies.

Targetes predefinides

El Power Apps ofereix un conjunt predefinit de targetes per a cadenes, nombres i altres tipus de dades. A la subfinestra de la dreta, podeu veure les variacions disponibles i canviar la targeta utilitzada per a un camp:

En aquest exemple, se selecciona una targeta de text d'una sola línia, però el text de l'adreça URL és més llarg que el que es pot visualitzar en una sola línia. La canviarem a una targeta de text de múltiples línies per donar als usuaris més espai per editar:

No es mostren diversos camps d'aquesta font de dades, però es pot mostrar o amagar un camp seleccionant-ne la casella de selecció. En aquest exemple s'il·lustra com es mostra el camp SecurityCode.

Personalitzar una targeta

Les targetes inclouen altres controls. En un control Edita el formulari, l'usuari introdueix dades en un control Entrada de text estàndard que afegiu des de la pestanya Insereix.

Analitzem un exemple de com canviar la aparença d'una targeta manipulant-ne els controls.

1. En primer lloc, tornem a la targeta que hem introduït més recentment per al camp SecurityCode. Seleccioneu aquesta targeta fent-hi clic o tocant-la una vegada:

   

2. Seleccioneu el control Entrada de text dins de la targeta fent clic al control d'entrada mateix o tocant-lo.

   .

3. Moveu aquest control dins de la targeta arrossegant el quadre de selecció i redimensioneu el control arrossegant els controls al llarg de la vora del quadre de selecció:

   

Podeu redimensionar i moure els controls dins d'una targeta, així com fer-ne altres modificacions, però no podeu suprimir la targeta sense desbloquejar-la abans.

Desbloquejar una targeta

A banda de contenir controls, les targetes mateixes són controls que tenen propietats i fórmules com qualsevol altre control. Quan trieu mostrar un camp en un formulari, la subfinestra de la dreta crea automàticament la targeta i genera les fórmules necessàries. Podem veure aquestes fórmules a la pestanya Avançat de la subfinestra de la dreta:

Veurem immediatament una de les propietats més importants de la targeta: la propietat DataField. Aquesta propietat indica quin camp de la font de dades veu i pot editar l'usuari en aquesta targeta.

A la pestanya Avançat, el bàner de la part superior indica que les propietats d'aquesta targeta estan bloquejades. Una icona de bloqueig també apareix al costat de les propietats DataField, DisplayName i Required. La subfinestra de la dreta ha creat aquestes fórmules i el bloqueig impedeix canvis accidentals en aquestes propietats.

Feu clic o toqueu el bàner de la part superior per desbloquejar la targeta a fi que pugueu modificar aquestes propietats:

Modifiquem DisplayName per col·locar un espai entre Actiu i ID. En fer aquest canvi, estem alterant el que s'ha generat per a nosaltres. A la subfinestra de la dreta, aquesta targeta té una etiqueta diferent:

Ara hem pres el control d'aquesta targeta i la podem modificar més per ajustar-la a les nostres necessitats. Però hem perdut la capacitat de canviar la targeta d'una representació a una altra (per exemple, text d'una sola línia a text de múltiples línies), tal com hem fet abans. Hem transformat la targeta predefinida en una "targeta personalitzada" que ara controlem.

Important

No podeu tornar a bloquejar una targeta si la desbloquegeu. Per tornar una targeta a un estat bloquejat, suprimiu-la i torneu-la a inserir a la subfinestra de la dreta.

Podeu canviar l'aparença i el comportament d'una targeta desbloquejada de diverses maneres, per exemple, afegint-hi i suprimint-ne controls. Per exemple, podeu afegir una forma d'estrella al menú Icones de la pestanya Insereix.

L'estrella és ara part de la targeta i es desplaçarà amb aquesta si, per exemple, reordeneu les targetes dins del formulari.

Com a exemple addicional, desbloquegeu la targeta ImageURL i, a continuació, afegiu-hi el control Imatge des de la pestanya Insereix:

A la barra de fórmules, definiu la propietat Image d'aquest control com a TextBox.Text, on TextBox és el nom del control Entrada de text que conté l'adreça URL:

Ara podem veure les imatges i editar-ne les adreces URL. Heu de tenir en compte que podríem haver utilitzat Parent.Default com la propietat Image, però no s'hauria actualitzat si l'usuari hagués canviat l'adreça URL.

Podem fer el mateix a la segona pantalla d'aquesta aplicació, on fem servir un control Visualitza el formulari per visualitzar els detalls d'un registre. En aquest cas, pot ser que ens interessi ocultar l'etiqueta (definir la propietat Visible de l'etiqueta, no la targeta, com a fals) perquè l'usuari no editarà l'adreça URL en aquesta pantalla:

Interactuar amb un formulari

Després de desbloquejar una targeta, podeu canviar la manera com interactua amb el formulari que la conté.

A continuació es mostren algunes directrius sobre com han de funcionar els controls amb la targeta i com han de funcionar les targetes amb el formulari. Es tracta només de directrius. Igual que amb qualsevol control del Power Apps, podeu crear fórmules que facin referència a qualsevol altre control al Power Apps, de la mateixa manera que per a les targetes i els controls dins les targetes. Sigueu creatiu: podeu crear una aplicació de moltes maneres.

Propietat DataField

La propietat més important de la targeta és la propietat DataField. Aquesta validació controla la validació, els camps que s'actualitzen i altres aspectes de la targeta.

Flux d'entrada d'informació

Com a contenidor, el formulari posa ThisItem a disposició de totes les targetes que conté. Aquest registre conté tots els camps del registre actual que us interessa.

La propietat Default de cada targeta s'ha de definir com a ThisItem.FieldName. En determinades circumstàncies, és possible que vulgueu transformar aquest valor en entrar. Per exemple, pot ser que vulgueu donar format a una cadena o traduir el valor d'una llengua a una altra.

Cada control dins de la targeta ha de fer referència a Parent.Default per obtenir el valor del camp. Aquesta estratègia proporciona un nivell d'encapsulació de la targeta per tal que la propietat Default pugui canviar sense canviar les fórmules internes de la targeta.

Per defecte, les propietats DefaultValue i Required es prenen de les metadades de la font de dades en funció de la propietat DataField. Podeu substituir aquestes fórmules per la vostra pròpia lògica i integrar les metadades de la font de dades mitjançant la funció DataSourceInfo.

Flux de sortida d'informació

Quan l'usuari modifica un registre mitjançant els controls de les targetes, la funció SubmitForm desa aquests canvis a la font de dades. Quan aquesta funció s'executa, el control de formulari llegeix els valors de la propietat DataField de cada targeta per saber quin camp s'ha de canviar.

El control de formulari també llegeix el valor de la propietat Update de cada targeta. Aquest valor s'emmagatzemarà a la font de dades per a aquest camp. Aquest és el lloc on s'aplica una altra transformació, potser per revertir la transformació que es va aplicar a la propietat Default de la targeta.

La propietat Valid es controla des de les metadades de la font de dades, en funció de la propietat DataField. També depèn de la propietat Required i de si la propietat Update conté un valor. Si el valor de la propietat Update no és vàlid, la propietat Error proporciona un missatge d'error descriptiu.

Si la propietat DataField d'una targeta està en blanc, la targeta només és un contenidor de controls. Les seves propietats Valid i Update no participen quan s'envia el formulari.

Dissecció d'un exemple

Analitzem els controls que componen una targeta d'entrada de dades bàsica. L'espai entre els controls s'ha incrementat per mostrar-los de forma més clara:

En aquest gràfic, els controls dins de la targeta de dades s'han etiquetat:

Quatre controls fan que aquesta targeta funcioni:

Nom	Type	Descripció
TextRequiredStar	Control Etiqueta	Mostra una estrella que s'utilitza habitualment als formularis d'entrada de dades per indicar que un camp és obligatori.
TextFieldDisplayName	Control Etiqueta	Mostra el nom descriptiu d'aquest camp. Aquest nom pot diferir del que hi ha a l'esquema de la font de dades.
InputText	Control Text d'entrada	Mostra el valor inicial del camp i permet a l'usuari canviar-lo.
TextErrorMessage	Control Etiqueta	Mostra un missatge d'error descriptiu per a l'usuari si es produeix un problema amb la validació. També garanteix que el camp tingui un valor si se'n requereix un.

Per emplenar aquests controls amb dades, les seves propietats es poden controlar des de les propietats de la targeta mitjançant aquestes fórmules clau. Tingueu en compte que les fórmules fan referència a un camp específic. En comptes d'això, tota la informació prové de la targeta.

Propietat de control	Fórmula	Descripció
TextRequiredStar.Visible	Parent.Required	L'estrella només apareix si el camp és obligatori. L'element obligatori és una fórmula controlada per l'usuari o per les metadades de la font de dades.
TextFieldDisplayName.Text	Parent.DisplayName	El control de quadre de text mostra el nom descriptiu que proporciona l'usuari o les metadades de la font de dades i que es defineix a la propietat DisplayName de la targeta.
InputText.Default	Parent.Default	El control d'entrada de text inicialment mostra el valor del camp de la font de dades, tal com el proporciona el valor per defecte de la targeta.
TextErrorMessage.Text	Parent.Error	Si es produeix un problema de validació, la propietat Error de la targeta proporciona un missatge d'error apropiat.

Nota

La propietat Parent.Error és una propietat només de sortida que no podeu definir amb una fórmula. Per tant, aquesta propietat no apareixerà a la llista de propietats situades a prop de la part superior esquerra o a les pestanyes Propietats o Avançat situades a prop de la vora dreta. La barra de fórmules suggereix aquesta propietat si escriviu una fórmula que podria fer referència a la propietat.

Per extreure informació d'aquests controls i tornar-la a inserir a la font de dades, tenim les fórmules clau següents:

Nom del control	Fórmula	Descripció
DataCard.DataField	"ApproverEmail"	Nom del camp que l'usuari pot visualitzar i editar en aquesta targeta.
DataCard.Update	InputText.Text	Valor per validar i tornar-lo a inserir a la font de dades quan s'executa SubmitForm.

Nota

Ens podeu dir quines són les vostres preferències d'idioma per a la documentació? Responeu una breu enquesta. (tingueu en compte que l'idioma de l'enquesta és l'anglès)

Trigareu uns set minuts a completar l'enquesta. No es recopilen dades personals (declaració de privadesa).