Opprette et sammendragsskjema i en lerretsapp

Artikkel
03/15/2023

Følg trinnvise instruksjoner for hvordan du oppretter et sammendragsskjema i en lerretsapp for behandling av fiktive data i Gastronor-databasen. Dette emnet er en del av en serie som forklarer hvordan du oppretter en forretningsapp på relasjonsdata i Microsoft Dataverse. Du får best resultat ved å se på disse emnene i denne rekkefølgen:

Opprette et ordregalleri.
Opprette et sammendragsskjema (dette emnet).
Opprette et detaljgalleri.

Definisjon av skjermområder.

Forutsetninger

Installer Gastronor-databasen og -apper.
Se gjennom oversikten over lerretsappen for Gastronor.
Opprett ordregalleriet selv, eller åpne Gastronor-ordrer (lerret) – Start del 2-appen, som allerede inneholder dette galleriet.

Legge til en tittellinje

Opprett en tittellinje øverst i appen, som vil vise handlingsknapper på slutten av dette emnet.

I ruten Trevisning velger du Skjerm 1 for å sikre at du ikke kan legge til en kontroll ved en feiltakelse i ordregalleriet:
I kategorien Sett inn velger du Etikett for å sette inn en Etikett-kontroll:

Den nye etiketten skal bare vises én gang, over galleriet. Hvis den vises i hvert element i galleriet, må du slette den første forekomsten av etiketten, kontrollere at skjermbildet er valgt (som forrige trinn beskriver), og deretter sette inn etiketten på nytt.
Flytt og endre størrelse på den nye etiketten, slik at den dekker toppen av skjermen:
Dobbeltklikk teksten til etiketten, og skriv deretter inn Gastronor-ordrer:

Du kan eventuelt endre Text-egenskapen på formellinjen for å oppnå samme resultat:
Formater etiketten i kategorien Hjem:
- Øk skriftstørrelsen til 24 punkt.
- Gjør teksten fet.
- Gjør teksten hvit.
- Sentrer teksten.
- Legg til et mørkeblått fyll i bakgrunnen.

Legge til en Redigeringsskjema-kontroll

I denne delen skal du legge til kontroller for å vise et sammendrag av hvilke som helst ordrer som brukeren velger i galleriet.

I kategorien Sett inn setter du inn en Redigeringsskjema-kontroll:

Skjemaet vises som standard øverst i venstre hjørne, der andre kontroller kan gjøre det vanskelig å finne følgende:
Flytt og endre størrelse på skjemaet for å dekke det øvre høyre hjørnet på skjermen under tittellinjen:
I ruten Egenskaper velger du nedtrekkslisten Datakilde.
Velg datakilden Ordrer.

Legge til og ordne felt

I kategorien Egenskaper nær høyre kant velger du Rediger felt for å åpne Felt-ruten.
Hvis Felt-ruten ikke er tom, fjerner du feltene som allerede er satt inn.
Når feltlisten er tom, velger du Legg til felt, og deretter merker du av i avmerkingsboksene for feltene Kunde og Ansatt.
Rull ned til disse feltene vises, og merk deretter av i avmerkingsboksene:
- Notater
- Bestillingsdato
- Ordrenummer
- Ordrestatus
- Betalingsdato
Nederst i Felt-ruten velger du Legg til, og deretter lukker du Felt-ruten.

Skjemaet viser sju felt, som kan være i en annen rekkefølge:
Obs!

Hvis et felt viser et rødt feilikon, kan det ha oppstått et problem da data ble hentet fra kilden. Du kan rette opp feilen ved å oppdatere dataene:
1. Velg Datakilder på Vis-fanen.
2. Velg Datakilder i Data-ruten.
3. Ved siden av Ordrer velger du ellipsen (...) og deretter Oppdater, og deretter velger du Data-ruten.
Hvis kombinasjonsboksen for kunde- eller ansattnavnet fremdeles viser en feil, kan du kontrollere Primærtekst og SearchField for hver boks ved å merke den og deretter åpne Data-ruten. For kundeboksen bør begge feltene settes til nwind_company. For ansattboksen bør begge feltene settes til nwind_lastname.
Når skjemaet er valgt, endrer du antallet kolonner i skjemaet fra 3 til 12 i kategorien Egenskaper nær høyre kant.

Dette trinnet gir deg fleksibilitet når du ordner feltene:

Mange brukergrensesnittutforminger er avhengige av 12-kolonnersoppsett fordi de kan ha flere rader av kontrollene 1, 2, 3, 4, 6 og 12. I dette emnet skal du opprette rader som inneholder 1, 2 eller 4 kontroller.
Flytt og endre størrelse på feltene ved å dra i håndtakene, på samme måte som andre kontroller, slik at hver rad inneholder disse datakortene i den angitte rekkefølgen:
- Første rad: Ordrenummer, Ordrestatus, Ordredato og Betalingsdato
- Andre rad: Kunde og Ansatt
- Tredje rad: Notater
Obs!

Det kan hende du synes det er enklere å utvide Notater-, Kunde- og Ansatt-datakortene før du ordner dem.

Mer informasjon om hvordan du ordner felt i et skjema: Slik fungerer oppsett for dataskjemaer for lerretsapper.

Skjule tidskontroller

I dette eksemplet trenger du ikke klokkeslettdelen av datofeltene, fordi dette detaljnivået kan være distraherende for brukeren. Hvis du sletter dem, kan det oppstå problemer i formler som er avhengige av disse kontrollene for å oppdatere datoverdier eller bestemme posisjonen til en annen kontroll i datakortet. I stedet skjuler du tidskontrollene ved å angi Visible-egenskapen.

I ruten Trevisning velger du datakortet Ordredato.

Kortet kan ha et annet navn, men det inneholder Ordredate.
Hold nede Skift-tasten og merk kontrollene for time, minutt og kolonskilletegn som finnes i datakortet Ordredato.
Sett kontrollenes Visible-egenskap til usann.

Alle valgte kontroller forsvinner fra skjemaet:
Endre størrelsen på Datovelger-kontrollen slik at den viser fullføringsdatoen:

Deretter gjentar du de siste trinnene for feltet Betalingsdato.
I Trevisning-ruten velger du tidskontrollene i datakortet Betalingsdato:
Sett de valgte kontrollenes Visible-egenskap til usann:
Endre størrelse på datovelgeren i Betalingsdato-kortet:

Koble til ordregalleriet

I Trevisning-ruten skjuler du skjemaet for å gjøre det enklere å finne navnet på ordregalleriet, og deretter kan du endre navnet til Galleri 1 om nødvendig.
Angi sammendragsskjemaets Item-egenskap til dette uttrykket:
```
Gallery1.Selected
```
Skjemaet viser et sammendrag av ordren appbrukeren velger i listen.

Erstatte et datakort

Ordrenummer er en identifikator som Dataverse tilordnes automatisk når du oppretter en oppføring. Dette feltet har en Tekstinndata-kontroll for tekst som standard, men du kan erstatte den med en etikett, slik at brukeren ikke kan redigere dette feltet.

Velg skjemaet, velg Rediger felt i kategorien Egenskaper nær høyre kant, og velg deretter feltet Ordrenummer:
Åpne Kontrolltype-listen:
Velg datakortet Vis tekst:
Lukk Felt-ruten.

Brukeren kan ikke lenger endre ordrenummeret:
I kategorien Hjem endrer du ordrenummerets skriftstørrelse til 20 punkt, slik at det blir enklere å finne feltet.

Bruk en én-til-mange-relasjon

Ordrer-tabellen har en mange-til-én-relasjon til tabellen Ansatte-tabellen: Hver ansatt kan opprette mange ordrer, men hver ordre kan bare tilordnes til én ansatt. Når brukeren velger en ansatt i Kombinasjonsboks-kontrollen, angir Selected-egenskapen ansattes fullstendige oppføring fra tabellen Ansatte. Dette fører til at du kan konfigurere en Bilde-kontroll til å vise bildet av enhver ansatt brukeren velger i kombinasjonsboksen.

Velg Ansatt-datakortet:
I kategorien Avansert nær høyre kant låser du opp datakortet, slik at du kan redigere formler som tidligere var skrivebeskyttet:
På datakortet reduserer du bredden på kombinasjonsboksen for å få plass til ansattbildet:
I kategorien Sett inn velger du Media > Bilde:

Et bilde vises på datakortet, som utvides for å gi plass:
Endre størrelsen på bildet, og flytt det til høyre for kombinasjonsboksen:
Angi Image-egenskapen for bildet til denne formelen ved å erstatte tallet på slutten av DataCardValue hvis nødvendig:
```
DataCardValue7.Selected.Picture
```
Bildet av den valgte ansatte vises.
Mens du holder nede Alt-tasten velger du en annen ansatt i kombinasjonsboksen for å bekrefte at bildet også endres.

Legge til et Lagre-ikon

I ruten Trevisning velger du Skjerm 1, og velg deretter Sett inn > Ikoner > Merk av:

Merk av-ikonet vises øverst i venstre hjørne som standard, der andre kontroller kan gjøre det vanskelig å finne ikonet:
I kategorien Hjem endrer du Color-egenskapen for ikonet til hvit og endrer størrelse på ikonet, og flytt det nær høyre kant av tittellinjen:
I ruten Trevisning bekrefter du at skjemanavnet er Skjema 1, og deretter angir du ikonets OnSelect-egenskapen for denne formelen:
```
SubmitForm( Form1 )
```
Når brukeren velger ikonet, samler SubmitForm-funksjonen alle endrede verdier i skjemaet og sender dem til datakilden. Prikker vises øverst på skjermen etter hvert som dataene sendes, og ordregalleriet gjenspeiler endringene etter at prosessen er fullført.
Sett ikonets DisplayMode-egenskap til denne formelen:
```
If( Form1.Unsaved, DisplayMode.Edit, DisplayMode.Disabled )
```
Hvis alle endringer i skjemaet er lagret, blir ikonet deaktivert og vises i DisabledColor, som du nå skal angi.
Sett ikonets DisabledColor-egenskap til denne verdien:
```
Gray
```
Brukeren kan lagre endringer i en ordre ved å velge Merk av-ikonet, som deretter blir deaktivert og nedtonet til brukeren utfører en ny endring:

Legg til et Avbryt-ikon

I kategorien Sett inn velger du Ikoner > Avbryt:

Ikonet vises øverst i venstre hjørne som standard, der andre kontroller kan gjøre det vanskelig å finne ikonet:
I kategorien Hjem endrer du Color-egenskapen for ikonet til hvit og endrer størrelse på ikonet, og flytt det til venstre for Merk av-ikonet:
Sett Avbryt-ikonets OnSelect-egenskap til denne formelen:
```
ResetForm( Form1 )
```
ResetForm-funksjonen forkaster alle endringer i skjemaet og returnerer det til den opprinnelige tilstanden.
Sett Avbryt-ikonets DisplayMode-egenskap til denne formelen:
```
If( Form1.Unsaved Or Form1.Mode = FormMode.New, DisplayMode.Edit, DisplayMode.Disabled )
```
Denne formelen avviker noe fra formelen for Merk av-ikonet. Avbryt-ikonet deaktiveres hvis alle endringer er lagret eller skjemaet er i Nytt-modus, som du nå skal aktivere. I slike tilfeller forkaster ResetForm den nye oppføringen.
Sett Avbryt-ikonets DisabledColor-egenskap til denne verdien:
```
Gray
```
Brukeren kan avbryte endringer i en ordre, og Merk av- og Avbryt-ikonene deaktiveres og nedtones hvis alle endringene lagres:

Legge til et Legg til-ikon

I kategorien Sett inn velger du Ikoner > Legg til.

Ikonet Legg til vises øverst i venstre hjørne som standard, der andre kontroller kan gjøre det vanskelig å finne det:
I kategorien Hjem angir du Color-egenskap for Legg til-ikonet til hvit og endrer størrelse på ikonet, og flytt det til venstre for Avbryt-ikonet:
Sett Legg til-ikonets OnSelect-egenskap til denne formelen:
```
NewForm( Form1 )
```
Funksjonen NewForm viser en tom oppføring i skjemaet.
Sett Legg til-ikonets DisplayMode-egenskap til denne formelen:
```
If( Form1.Unsaved Or Form1.Mode = FormMode.New, DisplayMode.Disabled, DisplayMode.Edit )
```
Formelen deaktiverer Legg til-ikonet under disse betingelsene:
- Brukeren utfører endringer, men lagrer eller avbryter dem ikke, noe som er den motsatte atferd fra Merk av- og Avbryt-ikonene.
- Brukeren velger Legg til-ikonet, men gjør ingen endringer.
Sett Legg til-ikonets DisabledColor-egenskap til denne verdien:
```
Gray
```
Brukeren kan opprette en ordre hvis de ikke gjør noen endringer, eller når de lagrer eller avbryter eventuelle endringer de har gjort. (Hvis brukeren velger dette ikonet, kan de ikke velge det på nytt før de har gjort én eller flere endringer og deretter lagrer eller annullerer disse endringene):

Obs!

Hvis du oppretter og lagrer en ordre, kan det hende du må rulle ned i ordregalleriet for å vise den nye ordren. Den inneholder ikke en totalpris fordi du ikke har lagt til ordredetaljer ennå.

Legge til Papirkurv-ikon

I kategorien Sett inn velger du Ikoner > Papirkurv.

Ikonet Papirkurv vises øverst i venstre hjørne som standard, der andre kontroller kan gjøre det vanskelig å finne det:
I kategorien Hjem endrer du Color-egenskapen for Papirkurv-ikonet til hvit og endrer størrelse på ikonet, og flytt det til venstre for Legg til-ikonet:
Sett Papirkurv-ikonets OnSelect-egenskap til denne formelen:
```
Remove( Orders, Gallery1.Selected )
```
Funksjonen Fjern fjerner en oppføring fra en datakilde. I denne formelen fjerner funksjonen oppføringen som er valgt i ordregalleriet. Papirkurv-ikonet vises i nærheten av sammendragsskjemaet (ikke ordregalleriet) fordi skjemaet viser flere detaljer om oppføringen, slik at brukeren enkelt kan identifisere oppføringen som formelen blir slettet i.
Sett Papirkurv-ikonets DisplayMode-egenskap til denne formelen:
```
If( Form1.Mode = FormMode.New, DisplayMode.Disabled, DisplayMode.Edit )
```
Denne formelen deaktiverer Papirkurv-ikonet hvis brukeren oppretter en oppføring. Før brukeren lagrer oppføringen har ikke Fjern-funksjonen en oppføring å slette.
Sett Papirkurv-ikonets DisabledColor-egenskap til denne verdien:
```
Gray
```
Brukeren kan slette en ordre.

Sammendrag

For å oppsummere har du lagt til et skjema der brukeren kan vise og redigere et sammendrag av hver ordre, og du brukte disse elementene:

Et skjema som viser data fra Ordrer-tabellen: Form1.DataSource = Orders
En kobling mellom skjemaet og ordregalleriet: Form1.Item = Gallery1.Selected
En alternativ kontroll for Ordrenummer-feltet: Vis tekst
En mange-til-én-relasjon for å vise den ansattes bilde på Ansatt-datakortet: DataCardValue1.Selected.Picture
Et ikon for lagring av endringer i en ordre: SubmitForm( Form1 )
Et ikon for å avbryte endringer i en ordre: ResetForm( Form1 )
Et ikon for å opprette en ordre: NewForm( Form1 )
Et ikon for å slette en ordre: Remove( Orders, Gallery1.Selected )

Neste trinn

I neste emnet legger du til et annet galleri for å vise produktene i hver ordre, og du endrer disse detaljene ved å bruke Patch-funksjonen.

Opprett detaljgalleriet