Freigeben über

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.

Anmerkung

Wenn Sie eine Liste in SharePoint erstellen oder anzeigen, werden Sie automatisch zu Microsoft-Listen weitergeleitet. Die Liste ist immer sowohl in SharePoint als auch in Microsoft Listen zu finden. Weitere Informationen finden Sie unter Was ist eine Liste in Microsoft 365?

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: Sobald das Element erfolgreich erstellt oder gespeichert wurde, wird das Formular zurückgesetzt und von SharePoint ausgeblendet.

    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.

Anmerkung

Sie können ein Formular zwar manuell von einer Umgebung in eine andere kopieren, aber es gibt derzeit keine automatisierte Methode in Power Apps, um ein Formular von einer Umgebung in eine andere zu kopieren.

Grundlegendes zum SharePointIntegration-Steuerelement

Das Steuerelement SharePointIntegration kommuniziert Benutzeraktionen zwischen SharePoint und Power Apps.

Screenshot eines SharePoint Integrationsobjekts, wie es in Power Apps zu sehen ist.

Anmerkung

Sie können nur auf die Eigenschaften des SharePointIntegration-Steuerelements zugreifen, wenn das Formular in SharePoint ausgeführt wird. Beim Anpassen des Formulars in Power Apps Studio ist dies nicht möglich. Diese Eigenschaften sind möglicherweise in OnStart oder OnVisible nicht verfügbar.

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

Eigenschaften Wirkung oder Beschreibung
Selected Das in der Liste ausgewählte Element.
OnNew Aktiviert, wenn ein Benutzer die Schaltfläche Neu auswählt oder das Formular Element erstellen in SharePoint öffnet.
OnView Aktiviert, wenn ein Benutzer ein Element auswählt oder das Formular Elementdetails in SharePoint öffnet.
OnEdit Aktiviert, wenn ein Benutzer die Schaltfläche Alle bearbeiten auswählt oder das Formular Element bearbeiten in SharePoint öffnet.
OnSave Aktiviert, wenn ein Benutzer die Schaltfläche Speichern in SharePoint auswählt.
OnCancel Aktiviert, wenn ein Benutzer die Schaltfläche Abbrechen in SharePoint auswählt.
SelectedListItemID Die Element-ID des ausgewählten Elements in einer Liste.
Datenquelle Die Liste, die den Datensatz enthält, der im Formular angezeigt, bearbeitet oder erstellt wird. Wenn Sie diese Eigenschaft ändern, funktionieren möglicherweise die Eigenschaften Selected und SelectedItemID nicht mehr.

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 der Wert SharepointIntegration.Selected auf eine Sammlung auf der OnView Eigenschaft festgelegt ist, wird nicht der neueste Wert angezeigt. Der empfohlene Weg, dieses Problem zu beheben, ist die Verwendung von SharepointIntegration.SelectedListItemID und dann ein LookUp in der Tabelle, um den selectedRecord zu erhalten.

    Zum Beispiel für die Eigenschaft OnView:

    • Anstelle von:

      Set( selectedItem,
SharePointIntegration.Selected );

    • Verwenden Sie:

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

  • Die Variablen der Sammlung werden beim Schließen des Formulars Power Apps nicht zurückgesetzt und der Status wird für die gesamte Sitzung beibehalten. Wenn es also Anwendungsfälle gibt, in denen die Variablen zurückgesetzt werden müssen, löschen Sie die Variablen in der Eigenschaft OnView 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.