Freigeben über


Verwenden Sie Power Fx in einer angepassten Seite für Ihre modellbasierte App

Dieser Artikel beschreibt, wie die allgemeinen Microsoft Power Fx Funktionen zwischen einer eigenständigen Canvas App und einer angepassten Seite unterschiedlich funktionieren. Der Grund dafür ist, dass eine angepasste Seite eine Komponente innerhalb der modellbasierten App ist. Andere Microsoft Power Fx-Formeln verhalten sich weiterhin auf die gleiche Weise.

Wichtig

Benutzerdefinierte Seiten sind eine neue Funktion mit erheblichen Produktänderungen und weisen derzeit eine Reihe bekannter Einschränkungen auf, die in Bekannte Probleme mit benutzerdefinierten Seiten beschrieben werden.

Benachrichtigungen zu einer benutzerdefinierten Seite hinzufügen

Eine Benachrichtigung kann dem Benutzer in einer benutzerdefinierten Seite angezeigt werden, indem die Benachrichtigungsfunktion aufgerufen wird. Wenn die Benachrichtigungen angezeigt werden, werden sie über der Standardseite angedockt, um sichtbar zu bleiben, bis sie deaktiviert werden. Wenn ein Zeitüberschreitungs-Intervall angegeben ist, verschwindet die Benachrichtigung nach dem Zeitüberschreitungs-Intervall. Es wird empfohlen, kein Zeitüberschreitungs-Intervall von 10 zu verwenden, da dies nicht mehr als Zeitüberschreitungs-Intervall betrachtet wird. Weitere Informationen: Funktion benachrichtigen.

Notify( "Custom page notification message" )

Benachrichtigungsleiste für benutzerdefinierte Seitenbenachrichtigungen

Notify( "Custom page notify warning message", NotificationType.Warning )

benutzerdefinierte Seite für Warnungsbenachrichtigungen

In diesem Abschnitt finden Sie Beispiele für die Navigation von einem modellbasierten App-Formular zu einer angepassten Seite, für die Navigation von einer angepassten Seite zu anderen angepassten Seiten oder für ein modellbasiertes App-Formular mit Power Fx.

Die Navigieren-Funktion ermöglicht es den Benutzern, entweder von modellgesteuerten App-Formularen oder benutzerdefinierten Seiten aus zu navigieren. Diese Funktion ist nur anwendbar, wenn die benutzerdefinierte Seite in einer modellgesteuerten App ausgeführt wird. Während der Erstellung einer angepassten Seite oder der Vorschau im Canvas Designer hat diese Funktion keine Wirkung.

Um von einer benutzerdefinierten Seite zu einer anderen zu navigieren, übergeben Sie den Anzeigename der benutzerdefinierten Seite als ersten Parameter.

Navigate( CustomPage2  )

Um zur Standardansicht der Tabelle zu navigieren, übergeben Sie als ersten Parameter den Tabellennamen.

Navigate( Accounts )

Wichtig

Stellen Sie sicher, dass Sie der benutzerdefinierten Seite die Microsoft Dataverse-Tabelle accounts hinzufügen, bevor Sie sie veröffentlichen und testen.

Um zu einem bestimmten Systemansicht der Tabelle zu navigieren, übergeben Sie die GUID der Ansicht.

Navigate( 'Accounts (Views)'.'My Active Accounts' )

Um zum Standardformular der Tabelle zu navigieren, übergeben Sie den Datensatz als ersten Parameter.

Navigate( Gallery1.Selected )

Um einen Dataverse-Datensatz an ein bestimmtes Formular weiterzuleiten, geben Sie den Formularnamen im Attribut „Seite“ des zweiten Parametes an.

Navigate( 
  AccountGallery.Selected, 
  { Page: 'Accounts (Forms)'.Account  } )

Um einen Dataverse-Datensatz an ein bestimmte benutzerdefinierte Seite weiterzuleiten, geben Sie den benutzerdefinierten Seitennamen im Attribut „Seite“ des zweiten Parametes an.

Navigate( 
  AccountGallery.Selected, 
  { Page: 'Account Record Page'  } )

Auf der benutzerdefinierten Zielseite wird der Datensatz mit der Funktion Parameter abgerufen, um die Werte etn und id zu erhalten.

Unten sehen Sie ein Beispiel für das Laden des Datensatzes auf ein EditForm-Steuerelement.

AccountEditForm.DataSource = Accounts
AccountEditForm.Item = 
  LookUp( Accounts, accountid = GUID( Param("id") ) )

Um zum Standardformular der Tabelle im Erstellungsmodus zu navigieren, übergeben Sie einen Dataverse-Datensatz, der aus der Funktion Standard erstellt wurde. Dadurch wird das Standardformular mit dem Datensatz als neuer Datensatz geöffnet. Die Funktion Standard verwendet den Tabellennamen, um den Datensatz zu erstellen.

Navigate( Defaults( Accounts ) )

Um zu einem neuen Datensatz mit voreingestellten Feldern zu navigieren, verwenden Sie die Funktion Patch, um Felder auf dem Standarddatensatz für die Tabelle festzulegen.

Navigate(
    Patch(
        Defaults(Accounts), { 'Account Name': "My company", Phone: "555-3423" } ) 
  )

Um zurück zur letzten Seite zu navigieren oder einen Dialog zu schließen, wird die Zurück -Funktion in einer benutzerdefinierten Seite aufgerufen. Die Zurück Funktion schließt die aktuelle Seite und kehrt zur letzten modellgesteuerten App oder benutzerdefinierten Seite in der modellgesteuerten App zurück. Wenn die benutzerdefinierte Seite mehrere Anzeigen hat, gehen Sie zum Artikel Zurück navigieren, wenn die benutzerdefinierte Seite mehrere Anzeigen hat.

Back()

Die Standardkonfiguration für eine benutzerdefinierte Seite ist eine Anzeige. In diesem Fall schließt der Zurück Funktionsaufruf die benutzerdefinierte Seite, es sei denn, die benutzerdefinierte Seite ist die letzte im Seitenstapel in der modellgesteuerten App. Die letzte Seite bleibt offen.

Ein App-Hersteller kann mehrere Bildschirme auf einer benutzerdefinierten Seite aktivieren. Diese sollten wie ganzseitige Steuerelemente innerhalb der benutzerdefinierten Seite betrachtet werden, die gestapelt werden können. Beim Öffnen einer benutzerdefinierten Seite kann die zu verwendende Anzeige nicht angegeben werden. Wenn eine benutzerdefinierte Seite mehrere Anzeigen enthält, ist der Hersteller für die Verwaltung der Bildschirmstapelung verantwortlich. Das Aufrufen der Funktion Navigieren zu einer Anzeige wird dem Anzeigenstapel mit der benutzerdefinierten Seite hinzugefügt. Jeder Zurück Funktionsaufruf entfernt eine Anzeige aus dem Anzeigenstapel. Wenn nur eine Anzeige im Anzeigenstapel vorhanden ist, wird die benutzerdefinierte Seite geschlossen.

Aktivieren mehrerer Bildschirme

Standardmäßig verwendet eine angepasste Seite einen einzigen Bildschirm, um die Trennung der App in einen Bildschirm pro Seite zu fördern. Sie können dies ändern, indem Sie Einstellungen > Anzeige > Mehrere Bildschirme aktivieren aktivieren.

Angepasste Seite ermöglicht mehrere Bildschirme

Bekannte Probleme

  • Die Funktion Navigate bietet keine Unterstützung für das Öffnen eines Modells oder einer angepassten Seite in einem Dialog. Die gesamte Navigation von einer benutzerdefinierten Seite wird inline geöffnet.
  • Die Funktion Navigate unterstützt das Öffnen nicht:
    • Eine Dashboard-Sammlung oder ein bestimmtes Dashboard.
    • Ein spezifisches modellbasiertes App Formular.
  • Eine angepasste Seite kann in einer modellbasierten App mit mehreren Sitzungen nur in der aktuellen App-Registerkarte der aktuellen Sitzung geöffnet werden.

Siehe auch

Zu einer benutzerdefinierten Seite mithilfe Client-API navigieren

Übersicht über die benutzerdefinierte Seite der modellgesteuerten App