Grundlegendes zur Einbindung von SharePoint-Formularen

Sie können ein Formular für eine SharePoint Liste anpassen, wenn Sie eine Liste in Power Apps integrieren. In diesem Artikel erfahren Sie, wie diese Formulare funktionieren und wie Sie sie anpassen können.

Wenn Sie ein Formular für eine Liste anpassen, sehen Sie, dass das generierte Standardformular für alle Vorgänge, z.B. das Erstellen, Anzeigen oder Bearbeiten eines Elements, verwendet werden kann. Diese Funktionalität verwendet generierter Formulare und das SharePointIntegration-Steuerelement.

Grundlegendes zum generierten Standardformular

Das generierte Standardformular besteht aus den folgenden Steuerelementen und den entsprechenden Standardwerten. Formeln werden innerhalb der Standardwerte automatisch generiert.

• FormScreen1: Dieser Bildschirm enthält das Formular.

• SharePointForm1: Dieses Formular kann ein Listenelement erstellen, anzeigen oder bearbeiten.

  • Datenquelle: Die Liste, für die das Formular angepasst wurde. Eine SharePoint Liste fungiert beispielsweise als Datenquelle.

  • Element: Ein ausgewähltes Element aus einer Liste. Dieses Element wird der Einfachheit halber auf First() Element festgelegt, wenn Sie in Power Apps Studio arbeiten.

    If( IsBlank(SharePointIntegration.Selected) || IsEmpty(SharePointIntegration.Selected),
        First('*YourListName*'),
    SharePointIntegration.Selected )
    

    Trinkgeld

    Dieses Formelmuster verwendet ... SharePointDatasourceName.Selected und funktioniert für die Element-Eigenschaft eines Formulars. Unter Allgemeine Probleme mit dem SharePointIntegration-Objekt finden Sie ein Formelmuster zum Festlegen des Werts eines SharePoint Datensatzes.

• OnSuccess: Nachdem das Element erfolgreich erstellt oder gespeichert wurde, wird das Formular zurückgesetzt und SharePoint blendet das Formular aus.

  ResetForm(SharePointForm1); RequestHide()
  

• SharePointIntegration: Kommuniziert Benutzeraktionen zwischen SharePoint und Power Apps.

  Eigenschaften	Eigenschaft	Beispiel
  Datenquelle	Die Liste, für die das Formular angepasst wurde.	YourListName
  OnNew	Legt SharePointForm1 im Modus „Neu“ fest.	NewForm(SharePointForm1)
  OnView	Legt SharePointForm1 im Ansichtsmodus fest.	ViewForm(SharePointForm1)
  OnEdit	Legt SharePointForm1 im Bearbeitungsmodus fest.	EditForm(SharePointForm1)
  OnSave	Übermittelt die Änderungen an SharePointForm1. Bei erfolgreicher Übermittlung des Formulars wird die Formel SharePointForm1.OnSuccess ausgeführt.	SubmitForm(SharePointForm1)
  OnCancel	Macht die Änderungen an SharePointForm1 rückgängig. SharePoint blendet das Formular immer aus, wenn ein Benutzer Abbrechen in SharePoint auswählt.	ResetForm(SharePointForm1)

Diese Standardeinstellungen stellen sicher, dass das Formular funktioniert, wenn es in SharePoint ausgeführt wird. Der Standardwert ändert den Power Apps Formularmodus, wenn der Benutzer in SharePoint interagiert, und sie stellen sicher, dass die Änderungen an SharePoint übermittelt werden.

Grundlegendes zum SharePointIntegration-Steuerelement

Das Steuerelement SharePointIntegration kommuniziert Benutzeraktionen zwischen SharePoint und Power Apps.

Das SharePointIntegration-Steuerelement verfügt über diese Eigenschaften:

Anpassen des Standardformulars

Sie können die Formeln ändern, um die Formulare weiter anzupassen.

Befolgen Sie diese Taktiken, wenn Sie Formulare anpassen:

• Verwenden Sie die Formel OnSave des SharePointIntegration Steuerelements, um anzupassen, was passiert, wenn ein Benutzer Speichern in SharePoint auswählt. Wenn Sie über mehrere Formulare verfügen, stellen Sie sicher, dass nur die Änderungen für das derzeit verwendete Formular übermittelt werden.

  Trinkgeld

  Legen Sie in den Formeln OnNew, OnView und OnEdit unterschiedliche Werte für eine Variable fest. Sie können mit dieser Variablen in der Formel OnSave bestimmen, welches Formular verwendet wird.

• Schließen Sie in die Formel OnSuccess aller Formulare RequestHide() mit ein. Ohne diese Funkltion weiß SharePoint nicht, wann das Formular ausgeblendet werden soll. Vermeiden Sie es, wichtigen Code nach dem Aufruf von RequestHide() auszuführen. Der Code sollte ausgeführt werden, solange das Formular noch sichtbar ist und Logik ausführen kann.

• Sie können das Ausblenden eines Formulars nicht steuern, wenn ein Benutzer Abbrechen in SharePoint auswählt. Setzen Sie Ihre Formulare immer in der OnCancel-Formel des SharePointIntegration Steuerelements zurück.

• Eigenschaften für das SharePointIntegration Steuerelement sind möglicherweise in OnStart oder OnVisible nicht verfügbar. Diese Ereignisse werden nur einmal ausgeführt, während die Liste geladen wird. Logik lässt sich mithilfe der Formeln OnNew, OnView oder OnEdit ausführen, bevor das Formular dem Benutzer angezeigt wird.

Allgemeine Probleme mit dem SharePointIntegration Objekt

• Wenn Sie den Wert SharepointIntegration.Selected einer Auflistung für die OnView-Eigenschaft festlegen, wird der neueste Wert nicht angezeigt. Um dieses Problem zu beheben, verwenden Sie SharepointIntegration.SelectedListItemID und führen Sie dann einen Nachschlagevorgang in der Tabelle durch, um den ausgewählten Datensatz abzurufen.

  Zum Beispiel für die Eigenschaft OnView:

  • Anstelle von:

    Set( selectedItem,
    SharePointIntegration.Selected );
    

  • Verwenden Sie:

    Set( selectedLookupItem,
    LookUp( YourSharepointIntegrationObject, 
    ID=SharePointIntegration.SelectedListItemID ) );
    

• Sammlungsvariablen werden beim Schließen des Power Apps-Formulars nicht zurückgesetzt. Der Zustand wird für die gesamte Sitzung beibehalten. Wenn Sie die Variablen zurücksetzen müssen, löschen Sie sie in der OnView-Eigenschaft des SharePointIntegration Objekts.

• Verwenden Sie keine imperativen Funktionen wie Launch() in den SharePointIntegration Eigenschaften (zum Beispiel OnNew und OnView). Diese Verwendung kann zu unerwartetem Verhalten führen, da die SharePointIntegration Lebenszyklusereignisse (z. B. Änderungen der Auswahl) im Hintergrund ausgelöst werden können, auch wenn das Formular nicht sichtbar ist.

Grundlegendes zum Benutzerzugriff auf benutzerdefinierte Formulare

Sie können ein mit Power Apps angepasstes SharePoint-Formular nicht manuell freigeben. Stattdessen erbt jeder Benutzer, der mindestens Lese - oder Eingeschränkte Ansicht Zugriff auf die verknüpfte SharePoint-Liste hat, Zugriff auf das Formular. Benutzer, denen nur Berechtigungen für bestimmte Elemente in der Liste erteilt wurden, haben keinen Zugriff auf das angepasste Formular.

Verwandte Informationen

• Benutzerdefinierte SharePoint-Formulare mit Power Apps verschieben (Whitepaper)
• Funktionen „EditForm“, „NewForm“, „SubmitForm“, „ResetForm“ und „ViewForm“
• RequestHide-Funktion