Forstå integrering av SharePoint-skjemaer

Artikkel
03/15/2023

Du kan nå enkelt tilpasse alle Microsoft Lister eller SharePoint-biblioteksskjemaer i Power Apps. I denne artikkelen forklarer vi i detalj hvordan disse skjemaene fungerer, og hvordan du kan tilpasse dem.

Hvis du har tilpasset et skjema for en liste, har du sikkert lagt merke til at det standardgenererte skjemaet fungerer for alle operasjoner, som oppretting, visning eller redigering av elementer. Dette skjer ved hjelp av genererte formler og SharePointIntegration-kontrollen.

Forstå det standardgenererte skjemaet

Det standardgenererte skjemaet består av følgende kontroller med tilhørende standarder:

FormScreen1 – Dette er skjermen som inneholder skjemaet.
SharePointForm1 – Dette er skjemaet som brukes til å opprette, vise eller redigere listeelementet.
- Datakilde – listen som skjemaet er tilpasset for.
- Element – det valgte elementet fra listen. For å gjøre det enkelt er dette satt som First() element i listen når du jobber i Power Apps Studio.
```
If( IsBlank(SharePointIntegration.Selected) || IsEmpty(SharePointIntegration.Selected),
    First('*YourListName*'),
    SharePointIntegration.Selected )
```
  Tips
  
  Formelmønsteret ovenfor (ved bruk av ... SharePointDatasourceName.Selected) fungerer for egenskapen Item for et skjema. Se delen nedenfor for et formelmønster for å angi verdien for en SharePoint-oppføring.
OnSuccess – Når elementet er opprettet eller lagret, blir skjemaet nullstilt, og SharePoint skjuler skjemaet.
```
ResetForm(SharePointForm1); RequestHide()
```
SharePointIntegration – Kontrollen som kommuniserer brukerhandlinger mellom SharePoint og Power Apps.
- Datakilde – listen som skjemaet er tilpasset for.
  
  'YourListName'
- OnNew – Setter SharePointForm1 i ny modus.
  
  NewForm(SharePointForm1)
- OnView – Setter SharePointForm1 i visningsmodus.
  
  ViewForm(SharePointForm1)
- OnEdit – Setter SharePointForm1 i redigeringsmodus.
  
  EditForm(SharePointForm1)
- OnSave – Sender endringene til SharePointForm1. Når skjemaet er sendt inn, blir SharePointForm1.OnSuccess-formelen utført.
  
  SubmitForm(SharePointForm1)
- OnCancel – Tilbakestiller endringene til SharePointForm1. SharePoint skjuler alltid skjemaet når en bruker velger Avbryt i SharePoint.
  
  ResetForm(SharePointForm1)

Disse standardene sikrer at skjemaet fungerer når det kjører i SharePoint. De endrer skjemamodusen i Power Apps når brukeren samhandler med det i SharePoint, og de sikrer at endringene blir sendt til SharePoint.

Hvordan SharePointIntegration-kontrollen fungerer

SharePointIntegration-kontrollen kommuniserer brukerhandlinger mellom SharePoint og Power Apps.

SharePoint-integreringsobjekt.

Obs!

Egenskapene for kontrollen for SharePointIntegration-kontrollen er bare tilgjengelige når skjemaet kjører i SharePoint, men ikke når skjemaet tilpasses i Power Apps Studio. Disse egenskapene er kanskje ikke tilgjengelige i OnStart eller OnVisible.

SharePointIntegration-kontrollen har følgende egenskaper:

Selected – Det valgte elementet fra listen.

OnNew – Handlinger som skal utføres når en bruker velger Ny-knappen eller åpner Opprett element-skjemaet i SharePoint.

OnView – Handlinger som skal utføres når en bruker velger et element eller åpner Elementdetaljer-skjemaet i SharePoint.

OnEdit – Handlinger som skal utføres når en bruker velger Rediger alle-knappen eller åpner Rediger element-skjemaet i SharePoint.

OnSave – Handlinger som skal utføres når en bruker velger Lagre-knappen i SharePoint.

OnCancel – Handlinger som skal utføres når en bruker velger Avbryt-knappen i SharePoint.

SelectedListItemID – Element-ID for det valgte elementet i en liste.

Datakilde – Listen som inneholder oppføringen som skjemaet skal vise, redigere eller opprette. Hvis du endrer denne egenskapen, kan det være at Selected og SelectedItemID slutter å virke.

Tilpassing av standardskjemaet

Nå som du har en bedre forståelse av det standardgenererte skjemaet og SharePointIntegration-kontrollen, kan du endre formlene for å tilpasse skjemaene enda mer. Her er noe du må huske på når du tilpasser skjemaene:

Bruk OnSave-formelen for SharePointIntegration-kontrollen for å tilpasse hva som skal skje når en bruker velger Lagre i SharePoint. Hvis du har flere skjemaer, må du passe på å bare sende endringene for det skjemaet som brukes i øyeblikket.

Tips

Angi forskjellige verdier for en variabel i formlene OnNew, OnView og OnEdit. Du kan bruke denne variabelen i OnSave-formelen for å finne ut hvilket skjema som brukes.
Pass på å inkludere RequestHide() i OnSuccess-formelen i alle skjemaene dine. Hvis du glemmer dette, kan ikke SharePoint vite når skjemaet skal skjules. Du bør også unngå å kjøre viktig kode etter at du har kalt RequestHide(), slik at all kode kjører mens skjemaet fremdeles er synlig og kan kjøre logikk.
Du kan ikke kontrollere skjulingen av et skjema når en bruker velger Avbryt i SharePoint, så sørg for at du tilbakestiller skjemaene dine i OnCancel-formelen i SharePointIntegration-kontrollen.
Egenskapene for kontrollen for SharePointIntegration er kanskje ikke tilgjengelige i OnStart eller OnVisible, og disse hendelsene utføres bare én gang mens listen lastes inn. Du kan bruke formlene OnNew, OnView eller OnEdit for å kjøre logikken før skjemaet vises til brukeren hver gang.

Vanlige problemer med SharePointIntegration-objektet

Når verdien for SharepointIntegration.Selected er satt til en samling på OnView-egenskapen vises ikke den nyeste verdien. Den anbefalte måten å løse dette problemet på er å bruke SharepointIntegration.SelectedListItemID og deretter gjøre et oppslag i tabellen for å få selectedRecord.

For eksempel OnView-egenskapen:
- I stedet for:
```
Set( selectedItem,
    SharePointIntegration.Selected );
```
- Bruk:
```
Set( selectedLookupItem,
    LookUp( YourSharepointIntegrationObject, 
            ID=SharePointIntegration.SelectedListItemID ) );
```
Samlingsvariabler tilbakestilles ikke når skjemaet Power Apps lukkes, og tilstanden beholdes for hele økten. Derfor fjerner du variablene i OnView-egenskapen for SharePointIntegration-objektet hvis det finnes brukstilfeller der variablene må tilbakestilles.
Ikke bruk imperative funksjoner som Launch() i SharePointIntegration-egenskapene ( for eksempel OnNew og OnView). Denne bruken kan føre til uventet virkemåte fordi livssyklushendelser i SharePointIntegration (for eksempel endringer av valg) kan utløse i bakgrunnen selv når skjemaet ikke vises.

Se også

Funksjonene EditForm, NewForm, SubmitForm, ResetForm og ViewForm – Form-funksjoner i Power Apps
RequestHide-funksjonen
SharePoint-integreringsscenarier

Obs!

Kan du fortelle oss om språkinnstillingene for dokumentasjonen? Ta en kort undersøkelse. (vær oppmerksom på at denne undersøkelsen er på engelsk)

Undersøkelsen tar rundt sju minutter. Det blir ikke samlet inn noen personopplysninger (personvernerklæring).

Del via