Freigeben über


ModelDrivenFormIntegration-Steuerelementeigenschaften und -aktionen

Canvas-Apps, die in modellgesteuerten Formularen eingebettet sind, enthalten ein spezielles Steuerelement namens ModelDrivenFormIntegration. Dieses Steuerelement ist dafür verantwortlich, kontextbezogene Daten aus dem hostmodellgesteuerten Formular in die eingebettete Canvas-App zu übertragen.

Von Bedeutung

Damit sie mit dem ModelDrivenFormIntegration-Steuerelement interagieren können, muss die Canvas-App erstellt werden. Wählen Sie dazu über den klassischen Formular-Designer Anpassen in den Eigenschaften des Canvas-App-Steuerelements für das modellgesteuerte Formular aus. Weitere Informationen: Einbetten einer Canvas-App mit der klassischen Oberfläche

In diesem Artikel werden die Eigenschaften und Aktionen erläutert, die für das ModelDrivenFormIntegration Steuerelement verfügbar sind. Dieses Steuerelement steht zur Anpassung in Power Apps Studio zur Verfügung, wenn Sie die Canvas-App mithilfe der Benutzeroberfläche der Steuerelementeigenschaften der Canvas-App im klassischen Formulardesigner erstellen.

modModeldrivenformintegration-Steuerelement in Power Apps Studio

Eigenschaft oder Aktion Description
DataSource Sollte auf die Datenquelle festgelegt werden, die mit der übergeordneten Tabelle des modellgesteuerten Hostformulars verknüpft ist.
Wird beim Einbetten einer neuen Canvas-App automatisch festgelegt. Beim Einbetten einer vorhandenen Canvas-App kann die ModelDrivenFormIntegration-Datenquelle aus der Canvas-App-Strukturansicht konfiguriert werden.
Der Wert für DataSource sollte immer auf die Tabelle des Formulars verweisen, in das die App eingebettet ist. Der Wert sollte nicht gefiltert oder geändert werden.
Element Die schreibgeschützte Eigenschaft, die es der eingebetteten Canvas-App ermöglicht, über das modellgesteuerte Hostformular auf die Zeile zuzugreifen.
Wenn Sie beispielsweise den Wert einer Spalte mit dem Namen AccountNumber und den Anzeigenamen Firmennummer abrufen möchten, können Sie ModelDrivenFormIntegration.Item.accountnumber oder ModelDrivenFormIntegration.Item.'Account Number' verwenden.
OnDataRefresh Die Formel in dieser Eigenschaft wird ausgewertet, wenn das hostmodellgesteuerte Formular Daten speichert.
Verwenden Sie sie, um die Datenquelle zu aktualisieren, die mit der übergeordneten Tabelle des hostmodellgesteuerten Formulars verbunden ist, und um andere Aktionen auszuführen, z. B. Festlegen oder Aktualisieren von Variablen.
Wenn Sie sie beispielsweise auf die folgende Formel festlegen, wird die Datenquelle "Konten" aktualisiert und eine Variable mit dem Namen "CurrentAccountNumber" auf den Wert der Spalte "Kontonummer" der aktuellen Zeile festgelegt.
Refresh(Accounts); Set(CurrentAccountNumber, ModelDrivenFormIntegration.Item.'Account Number')
Die OnDataRefresh-Aktion sollte nur verwendet werden, um Daten in der eingebetteten Canvas-App zu aktualisieren. Es wird nicht empfohlen, die OnDataRefresh-Aktion zum Speichern von Änderungen in der eingebetteten Canvas-App zu verwenden. Weitere Informationen: Speichern von Daten in einer eingebetteten Canvas-App
RefreshForm Aktualisiert die Daten im hostmodellgesteuerten Formular.
Ausführliche Informationen finden Sie unter Ausführen vordefinierter Aktionen im Hostformular .
SaveForm Speichert die Daten im hostmodellgesteuerten Formular.
Ausführliche Informationen finden Sie unter Ausführen vordefinierter Aktionen im Hostformular .
NavigateToMainForm Navigiert das hostmodellgesteuerte Formular zu einem Hauptformular und zeigt die angegebene Zeile an.
Ausführliche Informationen finden Sie unter Ausführen vordefinierter Aktionen im Hostformular .
NavigateToView Navigiert das modellgesteuerte Hostformular zu einer Ansicht.
Ausführliche Informationen finden Sie unter Ausführen vordefinierter Aktionen im Hostformular .
OpenQuickCreateForm Öffnet das Standardmäßige Schnellerstellungsformular für eine Tabelle.
Ausführliche Informationen finden Sie unter Ausführen vordefinierter Aktionen im Hostformular .
Daten Eine schreibgeschützte Eigenschaft, die vom Framework verwendet wird, um bestimmte Schlüsseldaten vom modellgesteuerten Hostformular an die eingebettete Canvas-App zu senden.
Verwenden Sie diese Eigenschaft nicht. Verwenden Sie "Item", um auf die Zeile aus dem vom Hostmodell gesteuerten Formular zuzugreifen.

ModelDrivenFormIntegration-Steuerelementdaten sind beim Starten der App nicht verfügbar.

Die ModelDrivenFormIntegration.Item Eigenschaft wird nicht garantiert mit Daten aufgefüllt, wenn die App gestartet wird. Die App sollte entweder so konzipiert sein, dass sie mit einem Ausdruck wie !IsBlank(ModelDrivenFormIntegration.Item) auf diese Daten wartet, oder die App sollte den Datensatz explizit mit einem Ausdruck wie LookUp(Accounts, Account = GUID(First(ModelDrivenFormIntegration.Data).ItemId)) abfragen.

Siehe auch

Einbetten einer Canvas-App in ein modellgesteuertes Formular
Hinzufügen einer eingebetteten Canvas-App zu einem modellgesteuerten Formular
Ausführen vordefinierter Aktionen auf dem Hostformular in einer eingebetteten Canvas-App
Eine eingebettete Canvas-App freigeben
Richtlinien für die Arbeit mit eingebetteten Canvas-Apps