Razumevanje podatkovnih kartic v aplikacijah s platnom

Kontrolniki Card so gradniki kontrolnikov Edit form in Display form v aplikacijah s platnom. Obrazec predstavlja celoten zapis, vsaka kartica pa posamezno polje tega zapisa.

S karticami lahko najlažje komunicirate v desnem podoknu, ko v delovnem prostoru za oblikovanje izberete kontrolnik obrazca. V tem podoknu lahko izberete, katera polja naj bodo prikazana, kako naj se prikaže posamezno polje in v kakšnem vrstnem redu naj se prikažejo. Ta primer prikazuje kontrolnik Edit form v aplikaciji, ustvarjeni iz seznama, poimenovanega Assets.

Če želite začeti upravljati s karticami, glejte dodajanje obrazca in razumevanje obrazcev s podatki. Preostanek tega članka podrobneje opisuje, kako delujejo kartice in kako jih lahko prilagodite ali celo ustvarite.

Vnaprej določene kartice

Power Apps nudi vnaprej določen nabor kartic za nize, številke in druge vrste podatkov. V desnem podoknu si lahko ogledate razpoložljive različice in spremenite kartico, ki se uporablja za posamezno polje:

V tem primeru je izbrana enovrstna kartica z besedilom, vendar je besedilo URL-ja daljše od tistega, ki se še lahko prikaže v eni vrstici. Spremenimo jo v večvrstično kartico z besedilom, da uporabnikom omogočimo več prostora za urejanje:

Ne prikaže se več polj tega vira podatkov, vendar lahko polje pokažete ali skrijete tako, da izberete ustrezno potrditveno polje. Ta primer prikazuje, kako pokazati polje SecurityCode.

Prilagajanje kartice

Kartice vsebujejo druge kontrolnike. V kontrolniku Edit form uporabnik vnese podatke v standardni kontrolnik Text input, ki ga dodate na zavihku Vstavi.

Poglejmo si primer, kako spremeniti videz kartice z upravljanjem kontrolnikov v sami kartici.

1. Najprej se vrnimo h kartici, ki smo jo nazadnje vstavili za polje SecurityCode. Izberite to kartico, tako da jo enkrat kliknete ali tapnete:

   

2. Izberite kontrolnik Text input znotraj kartice, tako da kliknete ali tapnete sam kontrolnik za vnos.

   

3. Premaknite kontrolnik znotraj kartice, tako da povlečete izbirno polje, in spremenite velikost kontrolnika, tako da povlečete rob izbirnega polja:

   

V kartici lahko spreminjate velikost kontrolnikov, jih premikate in kako drugače spremenite, vendar same kartice ne morete izbrisati, ne da bi jo najprej odklenili.

Odklepanje kartice

Poleg tega, da kartice vsebujejo kontrolnike, tudi same kartice delujejo kot kontrolniki z istimi lastnostmi in formulami kot drugi kontrolniki. Ko bi radi prikazali polja na obrazcu, se vam bo v desnem podoknu samodejno ustvarila kartica in potrebne formule. Te formule lahko vidimo v zavihku desnega podokna Napredno:

Najprej se nam prikaže ena najpomembnejših lastnosti kartice: lastnost DataField. Ta lastnost označuje, katero polje vira podatkov lahko uporabnik vidi in ureja v tej kartici.

Pasica na vrhu zavihka Napredno kaže, da so lastnosti te kartice zaklenjene. Poleg lastnosti DataField, DisplayName in Required se prikaže tudi ikona zaklepanja. Desno podokno je ustvarilo te formule, ključavnica pa prepreči naključne spremembe teh lastnosti.

Kliknite ali tapnite pasico na vrhu, da odklenete kartico in spremenite naslednje lastnosti:

Spremenimo DisplayName, da vstavimo presledek med Sredstvo in ID. S to spremembo spreminjamo tisto, kar je bilo ustvarjeno za nas. V desnem podoknu ima ta kartica drugačno oznako:

Zdaj smo prevzeli nadzor nad to kartico in jo lahko dodatno prilagodimo svojim potrebam. Izgubili pa smo možnost spreminjanja kartice iz ene predstavitve v drugo (na primer iz enovrstične v večvrstično besedilo), kot smo to storili prej. Vnaprej določeno kartico smo spremenili v »kartico po meri«, ki jo zdaj nadzorujemo.

Pomembno

Če odklenete kartico, je ne morete nazaj zakleniti. Če želite kartico ponovno zakleniti, jo odstranite in ponovno vstavite v desno podokno.

Videz in vedenje odklenjene kartice lahko spremenite na različne načine, na primer z dodajanjem in brisanjem kontrolnikov znotraj nje. Dodate lahko na primer zvezdico iz menija Ikone na zavihku Vstavi.

Zvezdica je zdaj del kartice in se bo z njo premikala, če boste na primer preurejali kartice znotraj obrazca.

Podobno lahko tudi odklenete kartico ImageURL in ji dodate kontrolnik Image na zavihku Vstavi:

V vnosni vrstici nastavite lastnost Image tega kontrolnika na TextBox.Text, kjer je TextBox ime kontrolnika Text input, ki vsebuje URL:

Zdaj lahko vidimo slike in urejamo njihove URL-je. Upoštevajte, da bi lahko uporabili tudi Parent.Default kot lastnost Image, vendar se ta ne bi posodobila, če bi uporabnik spremenil URL.

Enako lahko storimo na drugem zaslonu te aplikacije, kjer uporabljamo kontrolnik Display form za prikaz podrobnosti zapisa. V tem primeru bomo morda želeli skriti oznako (nastavite lastnost Visible oznake in ne kartice na false), ker uporabnik ne bo urejal URL-ja na tem zaslonu:

Interakcija z obrazcem

Ko odklenete kartico, lahko spremenite način njene interakcije z obrazcem, v katerem se nahaja.

Spodaj je nekaj smernic, kako naj bi kontrolniki delovali s svojo kartico in kako naj bi kartice delovale z obrazcem. To so le smernice. Tako kot pri vsakem kontrolniku v aplikaciji Power Apps lahko ustvarite formule, ki se nanašajo na drug kontrolnik v aplikaciji Power Apps, kar velja tudi za kartice in kontrolnike znotraj kartic. Pokažite svojo ustvarjalnost: aplikacijo lahko ustvarite na več načinov.

Lastnost DataField

Najpomembnejša lastnost kartice je DataField. Ta lastnost poganja preverjanje veljavnosti, katero polje je posodobljeno in druge vidike kartice.

Pritekanje informacij

Obrazec kot vsebnik ponudi možnost uporabe ThisItem vsem karticam znotraj njega. Ta zapis vsebuje vsa polja za trenutni interesni zapis.

Lastnost vsake kartice Default mora biti nastavljena na ThisItem.FieldName. V določenih okoliščinah boste morda želeli to vrednost ob vstopu pretvoriti. Morda boste na primer želeli formatirati niz ali prevesti vrednost iz enega jezika v drugega.

Vsak kontrolnik znotraj kartice se mora sklicevati na Parent.Default, da pride do vrednosti polja. Ta strategija zagotavlja raven enkapsulacije za kartico, tako da se lahko lastnost kartice Default spremeni brez spreminjanja notranjih formul kartice.

Privzeto sta lastnosti DefaultValue in Required vzete iz metapodatkov vira podatkov, ki temeljijo na lastnosti DataField. Te formule lahko preglasite s svojo logiko, in sicer tako, da integrirate metapodatke vira podatkov z uporabo funkcije DataSourceInfo.

Odtekanje informacij

Ko uporabnik spremeni zapis s kontrolniki v karticah, funkcija SubmitForm shrani te spremembe v vir podatkov. Ko se ta funkcija zažene, kontrolnik obrazca prebere vrednosti lastnosti DataField posamezne kartice, da ugotovi, katero polje spremeniti.

Kontrolnik obrazca prebere tudi vrednost lastnosti Update posamezne kartice. Ta vrednost bo shranjena v vir podatkov za to polje. Tu lahko uporabimo drugo pretvorbo, morda za preobrnitev pretvorbe, ki je bila uporabljena v formuli kartice Privzeto.

Lastnost Valid se poganja iz metapodatkov vira podatkov, ki temeljijo na lastnosti DataField. Poleg tega temelji tudi na lastnosti Required in na tem, ali lastnost Update vsebuje vrednost. Če vrednost lastnosti Update ni veljavna, lastnost Error zagotovi uporabniku prijazno sporočilo o napaki.

Če je lastnost kartice DataField prazna, to pomeni, da je kartica le vsebnik kontrolnikov. Njune lastnosti Valid in Update ne sodelujeta pri pošiljanju obrazca.

Podrobna preučitev primera

Oglejmo si kontrolnike, ki sestavljajo osnovno kartico za vnos podatkov. Prostor med kontrolniki se je povečal, da so posamezni kontrolniki bolj jasno prikazani:

V tem grafičnem prikazu so kontrolniki znotraj podatkovne kartice označeni, kot je navedeno v nadaljevanju:

Delovanje te kartice omogočajo štirje kontrolniki:

Imenu	Vnesi	Opis
TextRequiredStar	Kontrolnik Label	Prikaže zvezdico, ki se navadno uporablja na obrazcih za vnos podatkov za označitev obveznega polja.
TextFieldDisplayName	Kontrolnik Oznaka	Prikaže uporabniku prijazno ime tega polja. To ime se lahko razlikuje od tistega, kar je v shemi vira podatkov.
InputText	Kontrolnik Input text	Prikaže začetno vrednost polja in uporabniku omogoči spreminjanje te vrednosti.
TextErrorMessage	Kontrolnik Label	Prikaže uporabniku prijazno sporočilo o napaki, če pride do težave pri preverjanju veljavnosti. Prav tako zagotavlja, da ima polje vrednost, če je ta potrebna.

Če želite te kontrolnike zapolniti s podatki, lahko njihove lastnosti izpeljete iz lastnosti kartice prek teh ključnih formul. Upoštevajte, da se formule nanašajo na določeno polje. Namesto tega vse informacije prihajajo s kartice.

Lastnost kontrolnika	Formula	Opis
TextRequiredStar.Visible	Parent.Required	Zvezdica se prikaže samo, če je polje obvezno. »Obvezno« je formula, ki jo poganjate vi ali metapodatki vira podatkov.
TextFieldDisplayName.Text	Parent.DisplayName	Kontrolnik besedilnega polja prikazuje uporabniku prijazno ime, ki ga zagotovite vi ali metapodatki vira podatkov in ki je nastavljeno na lastnosti kartice DisplayName.
InputText.Default	Parent.Default	Kontrolnik za vnos besedila na začetku prikazuje vrednost polja iz vira podatkov, kot jo določa privzeta vrednost kartice.
TextErrorMessage.Text	Parent.Error	Če pride do težave s potrjevanjem veljavnosti, bo lastnost kartice Error javila ustrezno sporočilo o napaki.

Opomba

Lastnost Parent.Error je lastnost rezultata, ki je ne morete nastaviti s formulo. Zato se ta lastnost ne bo prikazala na seznamu lastnosti v bližini zgornjega levega kota ali v zavihkih Lastnosti ali Napredno v bližini desnega roba. V vnosni vrstici bo ta lastnost predlagana, če pišete formulo, ki bi se lahko sklicevala na to lastnost.

Če želite izvleči informacije iz teh kontrolnikov in jih poslati nazaj v vir podatkov, lahko uporabite naslednje ključne formule:

Ime kontrolnika	Formula	Opis
DataCard.DataField	"ApproverEmail"	Ime polja, ki ga uporabnik lahko prikaže in ureja v tej kartici.
DataCard.Update	InputText.Text	Vrednost, ki se preveri in pošlje nazaj v vir podatkov med izvajanjem funkcije SubmitForm.

Opomba

Ali nam lahko poveste, kateri je vaš prednostni jezik za dokumentacijo? Izpolnite kratko anketo. (upoštevajte, da je v angleščini)

Z anketo boste porabili približno sedem minut. Ne zbiramo nobenih osebnih podatkov (izjava o zasebnosti).