Forstå datakort i Canvas-apps

I denne artikel forklares det, hvad et datakort er, hvordan du ændrer det kontrolelement, som brugerne indtaster data i, hvornår et kort skal låses op, og hvordan formularen gemmer ændringer i Dataverse igen.

Datakort er byggestenene i Power Apps formularer. Hvert datakort vises og indsamler en værdi for et enkelt felt, f.eks. Navn, Stilling eller Telefonnummer.

På følgende skærmbillede vises en formular med et datakort for Kontonavn valgt.

En visningsformular viser én post. Ved at redigere formularer kan brugerne opdatere en eksisterende post eller oprette en ny. I begge typer formularer er hvert datakort forbundet til præcis ét felt (én kolonne) i datakilden – ofte en Dataverse-tabel.

Et datakort er en objektbeholder, der indeholder feltnavnet, den påkrævede valideringsfunktion og det kontrolelement, som brugerne interagerer med. Et datakort indeholder følgende:

• Påkrævet indikator (stjerne eller stjerne):Viser, at feltet skal have en værdi.
• Titel: Den etiket, der vises for brugerne af feltet.
• Datakortværdi: Inputkontrolelementet (f.eks. et tekstfelt eller en rulleliste), hvor brugerne angiver eller redigerer værdien
• Fejlmeddelelse: Viser valideringsfejl, normalt efter formularen er sendt.

Forudsætninger

Hvis du ikke kender formularer, kan du starte med at læse add-form.md og working-with-forms.md.

Tilpasse et kort

Et datakort indeholder de kontrolelementer, som brugerne får vist – normalt en mærkat, f.eks. titlen, et inputkontrolelement, f.eks. tekstinput eller rullemenu, og en fejlmeddelelse. Hvis du vil tilpasse, hvordan et felt ser ud, skal du vælge kontrolelementet på kortet, f.eks. tekstinput og justere dets størrelse, placering eller egenskaber.

Omarranger felter på en formular

Power Apps tilbyder foruddefinerede kort til strenge, tal og andre datatyper. Du kan redigere formularen og omarrangere felter, så du kan ændre layoutet uden at låse kort op.

1. Åbn din app til redigering i Power Apps Studio.

2. Vælg formularen, og vælg derefter Felter.

3. Vælg Flere handlinger , og selet derefter Flyt op eller Flyt ned. Du kan også markere og derefter trække felter til den ønskede rækkefølge.

   

Skift kontroltype for et kort

Du kan nemt ændre et korts kontroltype. Det kan f.eks. være en god idé at ændre et tekstkort med en enkelt linje til et tekstkort med flere linjer, så brugerne har mere plads til at angive oplysninger.

1. Åbn din app til redigering i Power Apps Studio.

2. Vælg formularen, og vælg derefter Felter.

3. Vælg Udvid feltdetaljer , som er pil ned ud for det felt, du vil redigere.

4. Vælg rullelisten for Kontrolelementtype, og vælg derefter en anden kontrolelementtype. Skift f.eks. fra Rediger tekst til Rediger tekst med flere linjer.

   

Tilpas størrelsen på et kort

Du kan flytte og tilpasse størrelsen på kontrolelementer på et låst kort.

Du redigerer kontrolelementerne på et kort uden at ændre, hvilket felt kortet opretter forbindelse til.

1. I formularen skal du vælge det datakort, du vil ændre størrelsen på, f.eks . Kontonavn.

2. Træk for at flytte tekstinputtet på kortet, og brug håndtagene til at tilpasse størrelsen på det. Dette forbedrer afstand og læsbarhed uden at låse kortet op.

   

Låse et kort op

Hvis du vil foretage ændringer, f.eks. slette et kontrolelement eller tilføje et nyt kontrolelement, skal du låse kortet op.

Når du føjer et felt til en formular, opretter Power Apps et datakort for dig og konfigurerer de grundlæggende formler, der forbinder kortet med datakilden. Som standard låser Power Apps disse kort, så du ikke ved et uheld afbryder forbindelsen. Hvis du har brug for mere kontrol, f.eks. et brugerdefineret layout, ekstra kontrolelementer eller forskellige formler, kan du låse kortet op.

På følgende skærmbillede vises en formular med et datakort, der er låst.

Nøgleindstillingen er DataField. Den fortæller Power Apps, hvilket felt (kolonne) dette kort er ansvarlig for. Når formularen sendes, bruger Power Apps kortets DataField værdi til at vide, hvilket felt der skal opdateres.

1. Hvis du vil låse et kort op, skal du vælge kortet

2. I ruden Egenskaber skal du vælge Avanceret.

3. Vælg låseikonet, eller vælg Lås op for at ændre egenskaber for at låse egenskaber op, f.eks . DataField, DisplayName eller Required.

4. Når du har låst kortet op, skal du redigere de genererede formler og tilføje eller fjerne kontrolelementer på kortet.

   Låste egenskaber	Ulåste egenskaber

Du tager nu kontrol over dette kort og kan ændre det yderligere, så det passer til dine behov. Men du mister muligheden for at ændre kortet fra én repræsentation til en anden (f.eks. enkeltlinjetekst til tekst med flere linjer), som du gjorde før. Du har transformeret det foruddefinerede kort til et "brugerdefineret kort", som du nu styrer.

Interagere med en formular

Når du låser et kort op, kan du styre, hvordan værdier flyttes mellem formularen og kontrolelementerne på kortet.

En nyttig måde at tænke på en rediger formular på er: dataflows ind for at vise den aktuelle post (standard), og dataflows ud , når du sender formularopdateringerne. Kortet er placeret i midten – dets egenskaber fortæller formularen, hvilket felt det repræsenterer, og hvilken værdi der skal gemmes.

Egenskaben DataField

Kortets egenskab DataField er indstillingen "dette kort redigerer dette felt". Det hjælper Power Apps med at beslutte, hvad der skal valideres, hvilken værdi der kræves, og hvilket felt der skal opdateres, når du sender formularen.

Indgående oplysninger

Når en formular viser en post, vises den pågældende post som ThisItem. Tænk på ThisItem som den aktuelle række, du redigerer. Den indeholder alle felter for den pågældende datapost.

I Dataverse-baserede formularer stemmer kortets DataField typisk overens med feltets logiske navn. Kortets standardformel refererer ofte til den aktuelle post, f.eks. ThisItem.FieldName, og inputkontrolelementet på kortet læser normalt denne værdi via Parent.Default. Dette mønster holder inputkontrolelementet uafhængigt af datakilden og giver kortet mulighed for at indkapsle, hvordan feltværdien flyder ind.

De fleste kort angiver egenskaben Default til den aktuelle posts værdi, f.eks. ThisItem.FieldName. Du kan eventuelt transformere denne værdi, f.eks. formatere tekst, før den vises i inputtet.

På kortet bruger inputkontrolelementet normalt Parent.Default , så det viser altid den værdi, kortet indeholder. Denne fremgangsmåde bevarer kortet "selvstændigt". Hvis du senere ændrer kortets standardformel, behøver du ikke at omskrive formler på kortet.

Som standard angiver datakildens metadata egenskaberne DefaultValue og controls/control-card.md baseret på egenskaben controls/control-card.md . Du kan tilsidesætte disse formler med din egen logik ved hjælp af funktionen functions/function-datasourceinfo.md til at integrere datakildens metadata.

Udgående oplysninger

Når brugeren vælger Gem, kalder dette typisk SubmitForm. Formularen indsamler værdier fra hvert datakort og skriver dem tilbage til datakilden. Det bruger hvert korts DataField til at vide , hvilket felt der skal opdateres.

Hvis du vil gemme ændringer fra en redigeringsformular, skal du udløse SubmitForm(FormName) (f.eks. fra knappen Gem ). Hvis du vil rydde input efter en vellykket afsendelse, skal du følge med ResetForm(FormName). Hvis du vil oprette en ny post i stedet for at redigere en eksisterende post, skal du angive formularens egenskab DefaultMode til FormMode.New , før brugeren begynder at angive data.

Formularen læser også egenskaben Update for hvert kort – dette er den værdi, der gemmes for det pågældende felt. Hvis du har brug for at rydde op i en værdi, før du gemmer, f.eks. fjerne ekstra mellemrum, konvertere tekst til et tal eller fortryde en formateringsændring, du har foretaget i Standard, er Opdater som regel det rigtige sted at gøre det.

Valid er grundlæggende "er dette felt i orden at sende?", Power Apps bruger datakildereglerne og kortets Required indstilling til at bestemme dette. Hvis værdien ikke er gyldig, indeholder kortets egenskab Error en meddelelse, som du kan vise til brugeren, ofte via mærkaten Fejlmeddelelse på kortet.

Hvis et korts DataField er tomt, er kortet ikke bundet til et felt – det er blot en objektbeholder, du kan bruge til layout. I så fald påvirker værdierne Update og Valid ikke, hvad der gemmes, når du sender formularen.

Analysere et eksempel

Se nærmere på, hvad der er i et typisk dataindtastningskort. Følgende skærmbilleder fordeler kontrolelementerne ud, så du kan se hvert stykke tydeligt.

På det næste billede er kontrolelementerne på kortet mærket, så du kan matche det, du ser på lærredet, med det, der er i trævisningen.

Her er de vigtigste kontrolelementer, du normalt ser på et kort:

Disse kontrolelementer opretter normalt ikke direkte forbindelse til Dataverse. I stedet læser de simple værdier fra det overordnede kort ved hjælp af Parent, og kortet håndterer forbindelsen til datakilden. Følgende formler er almindelige eksempler.