Înțelegeți cardurile de date din aplicațiile proiectate pe pânză

Controalele Card sunt elementele constructive ale controalelor Editare formular și Afișare formular în aplicațiile proiectate pe pânză. Formularul reprezintă întreaga înregistrare și fiecare card reprezintă un singur câmp al înregistrării respective.

Puteți interacționa cu cardurile cel mai ușor în panoul din dreapta, după ce selectați un control de formular în spațiul de lucru de proiectare. În acel panou, puteți alege care câmpuri să fie afișate, cum să afișați fiecare câmp și în ce ordine să le afișați. Acest exemplu arată un control Editare formular într-o aplicație creată de la o listă cu numele Active.

Pentru a începe cu cardurile, consultați adăugați un formular și înțelegeți formularele de date. Restul acestui articol detaliază mai mult modul în care funcționează cardurile și modul în care vă puteți personaliza sau chiar crea propriile carduri.

Carduri predefinite

Power Apps oferă un set predefinit de carduri pentru șiruri, numere și alte tipuri de date. În panoul din dreapta, puteți vedea variațiile disponibile și puteți schimba cardul folosit pentru un câmp:

În acest exemplu, este selectat un card de text cu o singură linie, dar textul URL este mai lung decât se poate afișa pe o singură linie. Să schimbăm într-un card text cu mai multe linii pentru a oferi utilizatorilor noștri mai mult spațiu de editat:

Mai multe câmpuri ale acestei surse de date nu sunt afișate, dar puteți afișa sau ascunde un câmp selectând caseta de selectare. Acest exemplu ilustrează modul de a afișa câmpul Cod de securitate.

Personalizați un card

Cardurile cuprind alte controale. Într-un control Editare formular, utilizatorul introduce date într-un control standard Introducere text pe care îl adăugați din fila Inserare.

Haideți să parcurgem un exemplu despre cum să schimbați aspectul unui card, manipulând controalele din acesta.

1. Mai întâi, să revenim la cardul pe care l-am introdus cel mai recent, pentru câmpul Cod de securitate. Selectați acest card făcând clic sau atingându-l o dată:

   

2. Selectați controlul Introducere text în interiorul cardului făcând clic sau atingând controlul de intrare.

   

3. Mutați acest control în interiorul cardului trăgând caseta de selecție și redimensionați controlul trăgând mânerele de-a lungul marginii casetei de selecție:

   

Puteți redimensiona, muta și efectua alte modificări la controale de pe un card, dar nu îl puteți șterge fără să îl deblocați mai întâi.

Deblocarea unui card

Pe lângă faptul că conțin controale, cardurile în sine sunt controale care au proprietăți și formule la fel ca orice alt control. Când alegeți să afișați un câmp pe un formular, panoul din dreapta creează automat cardul pentru dvs. și generează formulele necesare. Putem vedea aceste formule în fila Complex din panoul din dreapta:

Vedem imediat una dintre cele mai importante proprietăți ale cardului: proprietatea Câmp de date. Această proprietate indică ce câmp al sursei de date vede utilizatorul și poate edita în acest card.

Pe fila Complex, bannerul din partea de sus indică faptul că proprietățile acestui card sunt blocate. O pictogramă de blocare apare, de asemenea, lângă proprietățile Câmp de date, Numele afișat și Necesar. Panoul din dreapta a creat aceste formule, iar blocarea previne modificări accidentale ale acestor proprietăți.

Faceți clic sau atingeți bannerul din partea de sus pentru a debloca cardul, astfel încât să puteți modifica aceste proprietăți:

Să modificăm Numele afișat pentru a pune un spațiu între Activ și ID. Prin această modificare, modificăm ceea ce a fost generat pentru noi. În panoul din dreapta, acest card are o etichetă diferită:

Am preluat controlul asupra acestui card și îl putem modifica în continuare pentru a se potrivi nevoilor noastre. Dar am pierdut capacitatea de a schimba cardul de la o reprezentare la alta (de exemplu, text de o singură linie în text de mai multe linii) așa cum am făcut înainte. Am transformat cardul predefinit într-un „card personalizat” pe care îl controlăm acum.

Important

Nu puteți rebloca un card dacă îl deblocați. Pentru a readuce un card la o stare de blocare, scoateți-l și introduceți-l în panoul din dreapta.

Puteți modifica aspectul și comportamentul unui card deblocat într-o varietate de moduri, cum ar fi adăugarea și ștergerea controalelor din cadrul acesteia. De exemplu, puteți adăuga o formă de stea din meniul Pictograme de pe fila Inserare.

Steaua este acum o parte a cardului și va călători cu el dacă, de exemplu, reordonați cardurile în formular.

Ca alt exemplu, deblocați cardul URLImagine, apoi adăugați un control Imagine la acesta de la fila Inserare:

În bara de formule, setați proprietatea Imagine a acestui control la Casetă de text,Text, unde Casetă de text este numele controlului Introducere text care deține adresa URL:

Și acum putem vedea imaginile și edita adresele lor URL. Rețineți că am fi putut folosi Parent.Default ca proprietate Imagine, dar nu s-ar fi actualizat dacă utilizatorul ar modifica adresa URL.

Putem face același lucru și pe cel de-al doilea ecran al acestei aplicații, unde folosim un control Afișare formular pentru a afișa detaliile unei înregistrări. În acest caz, este posibil să dorim să ascundem eticheta (setați proprietatea Vizibil a etichetei, nu a cardului, la fals) deoarece utilizatorul nu va edita adresa URL pe ecranul respectiv:

Interacționarea cu un formular

După deblocarea unui card, puteți schimba modul în care interacționează cu formularul care îl conține.

Mai jos sunt câteva instrucțiuni pentru modul în care controalele ar trebui să funcționeze cu cardul lor și cum ar trebui să funcționeze cardurile cu formularul. Acestea sunt doar orientări. Ca în cazul oricărui control din Power Apps, puteți crea formule care fac referire la orice alt control din Power Apps și acest lucru nu este mai puțin valabil pentru carduri și controale din carduri. Fiți creativ: puteți crea o aplicație în mai multe moduri.

Proprietatea Câmp de date

Cea mai importantă proprietate de pe card este proprietatea Câmp de date. Această proprietate dirijează validarea, ce câmp este actualizat și alte aspecte ale cardului.

Informații care intră

Ca recipient, formularul face disponibil Acest element pentru toate cardurile din cadrul acestuia. Această înregistrare conține toate câmpurile pentru înregistrarea curentă de interes.

Proprietatea Mod implicit a fiecărui card ar trebui să fie setată pe Acest element,Numele domeniului. În anumite circumstanțe, este posibil să doriți să transformați această valoare la intrare. De exemplu, poate doriți să formatați un șir sau să traduceți valoarea dintr-o limbă în alta.

Fiecare control de pe card ar trebui să facă referire la Parent.Default pentru a ajunge la valoarea câmpului. Această strategie oferă un nivel de încapsulare pentru card, astfel încât proprietatea cardulului Mod implicit se poate schimba fără a schimba formulele interne ale cardului.

În mod implicit, proprietățile Valoare implicită și Necesar sunt preluate din metadatele sursei de date bazate pe proprietatea Câmp de date. Puteți înlocui aceste formule cu propria logică, integrând metadatele sursei de date utilizând funcția DataSourceInfo.

Informații care ies

După ce utilizatorul modifică o înregistrare folosind controale în carduri, funcția SubmitForm salvează modificările la sursa de date. Când funcția respectivă rulează, controlul formularului citește valorile fiecărei proprietăți a cardului Câmp de date pentru a ști ce câmp să schimbe.

De asemenea, controlul formularului citește valoarea fiecărei proprietăți a cardului Actualizare. Această valoare va fi stocată în sursa de date pentru acest câmp. Acesta este locul în care puteți aplica o altă transformare, poate pentru a inversa transformarea care a fost aplicată în formula cardului Mod implicit.

Proprietatea Valid este condusă de la metadatele din sursa de date, bazate pe proprietatea Câmp de date. De asemenea, se bazează pe proprietatea Necesar și dacă proprietatea Actualizare conține o valoare. Dacă valoarea de pe proprietatea Actualizare nu este valabilă, proprietatea Eroare furnizează un mesaj de eroare ușor de utilizat.

Dacă proprietatea Câmp de date a unui card este gol, cardul este doar un recipient de controale. Proprietățile sale Valid și Actualizare nu participă la trimiterea formularului.

Disecarea unui exemplu

Să ne uităm la controalele care alcătuiesc un card de bază de introducere a datelor. Spațiul dintre controale a fost mărit pentru a se arăta mai clar:

În acest grafic, controalele din cardul de date au fost etichetate:

Patru controale fac ca acest card să funcționeze:

Nume	Tip	Descriere
TextRequiredStar	Controlul Etichetă	Afișează o stea, care este frecvent utilizată pe formularele de introducere a datelor pentru a indica faptul că un câmp este obligatoriu.
TextFieldDisplayName	Controlul Etichetă	Afișează numele ușor de utilizat al acestui câmp. Acest nume poate diferi de ceea ce este în schema sursei de date.
Introdure text	Controlul Introdure text	Afișează valoarea inițială a câmpului și permite utilizatorului să modifice acea valoare.
TextErrorMessage	Controlul Etichetă	Afișează utilizatorului un mesaj de eroare ușor de utilizat dacă apare o problemă cu validarea. De asemenea, se asigură că câmpul are o valoare dacă este necesar.

Pentru a popula aceste controale cu date, proprietățile lor pot fi conduse de la proprietățile cardului, prin aceste formule cheie. Rețineți că formulele se referă la un câmp specific. În schimb, toate informațiile provin de pe card.

Proprietate control	Formulă	Descriere
TextRequiredStar.Visible	Parent.Required	Steaua apare doar dacă este obligatoriu câmpul. Obligatorie este o formulă condusă de dvs. sau de metadatele din sursa de date.
TextFieldDisplayName.Text	Parent.DisplayName	Controlul căsuței de text arată numele ușor de utilizat, pe care îl furnizați dvs. sau metadatele sursei de date și care este setat pe proprietatea cardului Numele afișat.
InputText.Default	Parent.Default	Controlul de introducere text arată inițial valoarea câmpului din sursa de date, astfel cum este furnizat de valoarea implicită a cardului.
TextErrorMessage.Text	Parent.Error	Dacă apare o problemă de validare, proprietatea cardului Eroare furnizează un mesaj de eroare adecvat.

Notă

Proprietatea Parent.Error este o proprietate exclusivă pentru ieșire pe care nu o puteți seta utilizând o formulă. Prin urmare, această proprietate nu va apărea în lista de proprietăți lângă colțul din stânga sus sau în filele Proprietăți sau Complex lângă marginea dreaptă. Bara de formule sugerează această proprietate dacă scrieți o formulă care ar putea face referire la proprietate.

Pentru a extrage informațiile din aceste controale și a o introduce înapoi în sursa de date, avem următoarele formule cheie:

Numele controlului	Formulă	Descriere
DataCard.DataField	"ApproverEmail"	Numele câmpului pe care utilizatorul îl poate afișa și edita în acest card.
DataCard.Update	InputText.Text	Valoarea de validat și introdus înapoi în sursa de date când submitForm rulează.

Notă

Ne puteți spune care preferințele dvs. lingvistice pentru documentație? Răspundeți la un chestionar scurt. (rețineți că acest chestionar este în limba engleză)

Chestionarul va dura aproximativ șapte minute. Nu sunt colectate date personale (angajament de respectare a confidențialității).