Forstå integration af SharePoint-formularer

Artikel
03/16/2023

Du kan nu nemt tilpasse tilpasse alle Microsoft Lister eller SharePoint-biblioteksformularer i Power Apps. I denne artikel gennemgås detaljerne for, hvordan disse formularer virker, og hvordan du kan tilpasse dem.

Hvis du har tilpasset en formular til en liste, har du sandsynligvis bemærket, at standardformularen fungerer for alle handlinger som f.eks. oprettelse, visning eller redigering af et element. Dette opnås ved hjælp af genererede formler og kontrolelementet SharePointIntegration.

Om den genererede standardformular

Den genererede standardformular består af følgende kontrolelementer og standardværdier:

FormScreen1 – Det er det skærmbillede, der indeholder formularen.
SharePointForm1 – Det er den formular, der skal bruges til at oprette, vise eller redigere listeelementet.
- Data Source – Den liste, som formularen er tilpasset for.
- Item – Det valgte element på listen. Når du arbejder i Power Apps Studio, er denne angivet til elementet First() på listen for nemheds skyld.
```
If( IsBlank(SharePointIntegration.Selected) || IsEmpty(SharePointIntegration.Selected),
    First('*YourListName*'),
    SharePointIntegration.Selected )
```
  Tip
  
  Ovenstående formelmønster (ved hjælp af ... SharePointDatasourceName.Selected) fungerer for egenskaben Item i en formular. I afsnittet nedenfor kan du se et formelmønster, hvor værdien for en SharePoint-post angives.
OnSuccess – Når elementet er oprettet eller gemt, bliver formularen nulstillet, og den skjules af SharePoint.
```
ResetForm(SharePointForm1); RequestHide()
```
SharePointIntegration – Dette kontrolelement er ansvarligt for at kommunikere brugerhandlinger mellem SharePoint og Power Apps.
- Data Source – Den liste, som formularen er tilpasset for.
  
  'YourListName'
- OnNew – Angiver SharePointForm1 til tilstanden New.
  
  NewForm(SharePointForm1)
- OnView – Angiver SharePointForm1 til tilstanden View.
  
  ViewForm(SharePointForm1)
- OnEdit – Angiver SharePointForm1 til tilstanden Edit.
  
  EditForm(SharePointForm1)
- OnSave – Sender ændringerne til SharePointForm1. Når formularen er indsendt, bliver formularen SharePointForm1.OnSuccess udført.
  
  SubmitForm(SharePointForm1)
- OnCancel – Nulstiller ændringerne i SharePointForm1. SharePoint skjuler altid formularen, når en bruger vælger Annuller i SharePoint.
  
  ResetForm(SharePointForm1)

Disse standardindstillinger sikrer, at formularen fungerer, når den anvendes i SharePoint. De ændrer formulartilstanden i Power Apps, når brugeren anvender den i SharePoint, og de sikrer, at ændringerne sendes til SharePoint.

Om kontrolelementet SharePointIntegration

Kontrolelementet SharePointIntegration kommunikerer brugerhandlinger mellem SharePoint og Power Apps.

SharePoint-integrationsobjekt.

Bemærk

Du kan kun få adgang til egenskaberne for kontrolelementet SharePointIntegration, når formularen kører i SharePoint, og ikke når formularen tilpasses i Power Apps Studio. Disse egenskaber er muligvis ikke tilgængelige i OnStart eller OnVisible.

Kontrolelementet SharePointIntegration har følgende egenskaber:

Selected - Det valgte element på listen.

OnNew - handlinger, der skal udføres, når en bruger vælger knappen Ny eller åbner formularen Opret element i SharePoint.

OnView - handlinger, der skal udføres, når en bruger vælger element eller åbner formularen Elementdetalje i SharePoint.

OnEdit - handlinger, der skal udføres, når en bruger vælger knappen Rediger alt eller åbner formularen Rediger element i SharePoint.

OnSave - handlinger, der skal udføres, når en bruger vælger knappen Gem i SharePoint.

OnCancel - handlinger, der skal udføres, når en bruger vælger knappen Annuller i SharePoint.

SelectedListItemID - Element-id for det valgte element på en liste.

DataSource – Den liste, der indeholder den post, som formularen vil vise, redigere eller oprette. Hvis du ændrer denne egenskab, vil egenskaberne Selected og SelectedItemID muligvis ikke virke længere.

Tilpasse standardformularen

Nu, hvor du forstår den genererede standardformular og kontrolelementet SharePointIntegration bedre, kan du ændre formlerne for at tilpasse dem yderligere. Her er nogle ting, du skal huske, når du tilpasser formularer:

Brug formularen OnSave for kontrolelementet SharePointIntegration til at tilpasse, hvad der sker, når en bruger vælger Gem i SharePoint. Hvis du har flere formularer, skal du sørge for kun at sende ændringerne for den formular, der aktuelt bruges.

Tip

Angiv forskellige værdier for en variabel i formlerne OnNew, OnView og OnEdit. Du kan bruge variablen i formlen i OnSave til at angive, hvilken formular der bruges.
Sørg for at inkludere RequestHide() i formlen OnSuccess for alle dine formularer. Hvis du glemmer dette, vil SharePoint ikke vide, hvornår det skal skjule formularen. Du skal også undgå at køre vigtig kode efter kald af RequestHide(), så al kode kører, mens formularen stadig er synlig og i stand til at køre logik.
Du kan ikke styre, hvornår en formular skal skjules, hvis brugeren vælger Annuller i SharePoint, så sørg for, at du nulstiller dine formularer i formlen i OnCancel for kontrolelementet SharePointIntegration.
Egenskaberne for kontrolelementet SharePointIntegration er muligvis ikke tilgængelige i OnStart eller OnVisible, og disse hændelser udføres kun én gang, mens listen indlæses. Du kan bruge formlerne OnNew, OnView eller OnEdit til at køre logikken, før formularen vises for brugeren hver gang.

Almindelige problemer med objektet SharePointIntegration

Når værdien i SharepointIntegration.Selected er angivet til en samling på egenskaben OnView, vises den seneste værdi ikke. Den anbefalede måde at løse dette problem på er at bruge SharepointIntegration.SelectedListItemID og derefter gennemføre et opslag i tabellen for at hente den valgte post.

For eksempel egenskaben OnView:
- I stedet for:
```
Set( selectedItem,
    SharePointIntegration.Selected );
```
- Brug:
```
Set( selectedLookupItem,
    LookUp( YourSharepointIntegrationObject, 
            ID=SharePointIntegration.SelectedListItemID ) );
```
Samlingsvariablerne nulstilles ikke, når formularen Power Apps lukkes, og tilstanden er vedvarende i hele sessionen. Det er derfor, at hvis der er brugssager, hvor variablerne skal nulstilles, skal variablerne ryddes i egenskaben OnView for objektet SharePointIntegration.
Brug ikke tvingende funktioner, f.eks. . Start() i egenskaberne SharePointIntegration (f.eks. OnNew og OnView). Denne brug kan medføre en uventet funktionsmåde, da livscyklushændelserne for SharePointIntegration (f.eks. ændringer af indstillinger) kan udløse i baggrunden, også selvom formularen ikke er synlig.

Se også

EditForm, NewForm, SubmitForm, ResetForm og ViewForm – formularfunktioner i Power Apps
Funktionen RequestHide
SharePoint-integrationsscenarier

Bemærk

Kan du fortælle os om dine sprogpræferencer for dokumentation? Tag en kort undersøgelse. (bemærk, at denne undersøgelse er på engelsk)

Undersøgelsen tager ca. syv minutter. Der indsamles ingen personlige data (erklæring om beskyttelse af personlige oplysninger).

Del via