Inzicht in SharePoint-formulierenintegratie

Artikel
03/16/2023

U kunt nu gemakkelijk een lijst van Microsoft Lijsten of SharePoint-bibliotheekformulier aanpassen in Power Apps. In dit artikel vindt u meer informatie over de werking van de formulieren en de manier waarop u deze kunt aanpassen.

Als u een formulier voor een lijst hebt aangepast, hebt u waarschijnlijk al gemerkt dat u voor alle bewerkingen (zoals het maken, weergeven of bewerken van een item) het formulier kunt gebruiken dat standaard wordt gegenereerd. Dit is mogelijk dankzij gegenereerde formules en het besturingselement SharePointIntegration.

Het standaard gegenereerde formulier begrijpen

Het standaard gegenereerde formulier bestaat uit de volgende besturingselementen en de bijbehorende standaardwaarden:

FormScreen1: dit is het scherm dat het formulier bevat.
SharePointForm1: dit is het formulier dat wordt gebruikt voor het maken, weergeven of bewerken van het lijstitem.
- DataSource: de lijst waarvoor het formulier is aangepast.
- Item: het geselecteerde item in de lijst. Wanneer u in Power Apps Studio werkt, wordt deze waarde voor uw gemak ingesteld op het eerste item in de lijst, First().
```
If( IsBlank(SharePointIntegration.Selected) || IsEmpty(SharePointIntegration.Selected),
    First('*YourListName*'),
    SharePointIntegration.Selected )
```
  Tip
  
  Het bovenstaande formulepatroon (met ... SharePointDatasourceName.Selected) werkt voor de eigenschap Item van een formulier. Zie de sectie hieronder voor een formulepatroon om de waarde van een SharePoint-record in te stellen.
OnSuccess: nadat het item is gemaakt of is opgeslagen, wordt het formulier opnieuw ingesteld en wordt het formulier in SharePoint verborgen.
```
ResetForm(SharePointForm1); RequestHide()
```
SharePointIntegration: het besturingselement dat verantwoordelijk is voor de communicatie van gebruikersacties tussen SharePoint en Power Apps.
- DataSource: de lijst waarvoor het formulier is aangepast.
  
  'YourListName'
- OnNew: hiermee activeert u de modus Nieuw voor SharePointForm1.
  
  NewForm(SharePointForm1)
- OnView: hiermee activeert u de weergavemodus voor SharePointForm1.
  
  ViewForm(SharePointForm1)
- OnEdit: hiermee activeert u de bewerkingsmodus voor SharePointForm1.
  
  EditForm(SharePointForm1)
- OnSave: hiermee worden de wijzigingen opgeslagen in SharePointForm1. Wanneer het formulier wordt verzonden, wordt de formule SharePointForm1.OnSuccess uitgevoerd.
  
  SubmitForm(SharePointForm1)
- OnCancel: hiermee maakt u de wijzigingen in SharePointForm1 ongedaan. SharePoint verbergt altijd het formulier wanneer een gebruiker Annuleren selecteert in SharePoint.
  
  ResetForm(SharePointForm1)

Deze standaardinstellingen zorgen ervoor dat het formulier werkt wanneer dit in SharePoint wordt uitgevoerd. Met de instellingen wordt de Power Apps-formuliermodus gewijzigd wanneer de gebruiker het formulier gebruikt in SharePoint. Daarnaast zorgen deze instellingen ervoor dat de wijzigingen naar SharePoint worden verzonden.

Het besturingselement SharePointIntegration begrijpen

Het besturingselement SharePointIntegration communiceert gebruikersacties tussen SharePoint en Power Apps.

SharePoint-integratieobject.

Notitie

De eigenschappen voor het besturingselement SharePointIntegration zijn alleen toegankelijk wanneer het formulier wordt uitgevoerd in SharePoint, niet wanneer u het formulier aanpast in Power Apps Studio. Deze eigenschappen zijn mogelijk niet beschikbaar in OnStart of OnVisible.

Het besturingselement SharePointIntegration bevat de volgende eigenschappen:

Selected: het geselecteerde item in de lijst.

OnNew - Acties die moeten worden uitgevoerd wanneer een gebruiker de knop Nieuw selecteert of het formulier Item maken in SharePoint opent.

OnView - Acties die moeten worden uitgevoerd wanneer een gebruiker een item selecteert of het formulier Details van item in SharePoint opent.

OnEdit - Acties die moeten worden uitgevoerd wanneer een gebruiker de knop Alles bewerken selecteert of het formulier Item bewerken in SharePoint opent.

OnSave - Acties die moeten worden uitgevoerd wanneer een gebruiker de knop Opslaan in SharePoint selecteert.

OnCancel - Acties die moeten worden uitgevoerd wanneer een gebruiker de knop Annuleren in SharePoint selecteert.

SelectedListItemID: de item-id voor het geselecteerde item in een lijst.

DataSource: de lijst die de record bevat die via het formulier wordt weergegeven, bewerkt of gemaakt. Als u deze eigenschap wijzigt, werken de eigenschappen Selected en SelectedItemID mogelijk niet meer.

Het standaardformulier aanpassen

Nu u een beter inzicht hebt in het formulier dat standaard wordt gegenereerd en het besturingselement SharePointIntegration, kunt u de formules wijzigen om de formulieren verder aan te passen. Hier volgt een aantal zaken waarmee u rekening moet houden wanneer u formulieren aanpast:

Gebruik de formule OnSave van het besturingselement SharePointIntegration om aan te passen wat er gebeurt wanneer een gebruiker in SharePoint de optie Opslaan selecteert. Als u meerdere formulieren hebt, moet u ervoor zorgen dat u alleen de wijzigingen verzendt voor het formulier dat momenteel wordt gebruikt.

Tip

Stel verschillende waarden in voor een variabele in de formules OnNew, OnView en OnEdit. U kunt deze variabele in de formule OnSave gebruiken om te bepalen welk formulier wordt gebruikt.
Zorg dat u voor alle formulieren RequestHide() opneemt in de formule OnSuccess. Als u dit vergeet, kan het formulier niet worden verborgen met SharePoint. Vermijd ook het uitvoeren van belangrijke code na het aanroepen van RequestHide(), zodat alle code wordt uitgevoerd terwijl het formulier nog steeds zichtbaar is en logica kan uitvoeren.
U kunt niet bepalen of een formulier wordt verborgen wanneer een gebruiker in SharePoint de optie Annuleren selecteert, dus zorg ervoor dat u uw formulieren opnieuw instelt in de formule OnCancel van het besturingselement SharePointIntegration.
De eigenschappen voor het besturingselement SharePointIntegration zijn mogelijk niet beschikbaar in OnStart of OnVisible; deze gebeurtenissen voeren ook slechts één keer uit bij het laden van de lijst. U kunt de formules OnNew, OnView of OnEdit uitvoeren om logica uit te voeren voordat het formulier elke keer aan de gebruiker wordt weergegeven.

Veelvoorkomende problemen met het SharePointIntegration-object

Wanneer de waarde van SharepointIntegration.Selected is ingesteld op een verzameling in de eigenschap OnView, wordt de laatste waarde niet weergegeven. De aanbevolen manier om dit probleem op te lossen, is door gebruik te maken van SharepointIntegration.SelectedListItemID en vervolgens een zoekopdracht in de tabel uit te voeren om de geselecteerde record te krijgen.

Voor de eigenschap OnView bijvoorbeeld:
- In plaats van:
```
Set( selectedItem,
    SharePointIntegration.Selected );
```
- Gebruik:
```
Set( selectedLookupItem,
    LookUp( YourSharepointIntegrationObject, 
            ID=SharePointIntegration.SelectedListItemID ) );
```
Verzamelvariabelen worden niet gereset bij het sluiten van het Power Apps-formulier en de status blijft gedurende de hele sessie behouden. Daarom moet u, als er gevallen zijn waarbij de variabelen opnieuw moeten worden ingesteld, de variabelen in de eigenschap OnView van het SharePointIntegration-object wissen.
Gebruik geen imperatieve functies zoals Launch() in de SharePointIntegration-eigenschappen (zoals OnNew en OnView). Dit gebruik kan onverwacht gedrag veroorzaken, aangezien de levenscyclusgebeurtenissen van SharePointIntegration (zoals het wijzigen van selecties) op de achtergrond kunnen worden geactiveerd, zelfs wanneer het formulier niet zichtbaar is.

Zie ook

Functies EditForm, NewForm, SubmitForm, ResetForm en ViewForm - formulierfuncties in Power Apps
Functie RequestHide
Scenario's voor SharePoint-integratie

Notitie

Laat ons uw taalvoorkeuren voor documentatie weten! Beantwoord een korte enquête. (houd er rekening mee dat deze in het Engels is)

De enquête duurt ongeveer zeven minuten. Er worden geen persoonlijke gegevens verzameld (privacyverklaring).

Delen via