Power Fx gebruiken op een aangepaste pagina voor uw modelgestuurde app

In dit artikel worden de verschillen in de werking beschreven van gemeenschappelijke Microsoft Power Fx-functies in een zelfstandige canvas-app en op een aangepaste pagina. Die verschillen ontstaan omdat een aangepaste pagina een onderdeel is in de modelgestuurde app. Andere Microsoft Power Fx-formules blijven op dezelfde manier werken.

Belangrijk

Aangepaste pagina's zijn een nieuwe functie met aanzienlijke productwijzigingen en hebben momenteel een aantal bekende beperkingen die worden beschreven in: Bekende problemen met aangepaste pagina's.

Meldingen toevoegen aan een aangepaste pagina

Een melding kan aan app-gebruikers worden getoond in een aangepaste pagina door de Meldingsfunctie aan te roepen. Wanneer de meldingsberichten verschijnen, worden ze boven de standaardpagina gedokt om zichtbaar te blijven totdat ze worden uitgeschakeld. Als er een time-outinterval is voorzien, verdwijnt het meldingsbericht na het time-outinterval. Het wordt aanbevolen om geen time-outinterval van 10 te gebruiken, omdat dit niet langer als een time-outinterval wordt beschouwd. Meer informatie: Meld functie.

Notify( "Custom page notification message" )

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

Navigeren naar een aangepaste pagina

Deze sectie bevat voorbeelden van het navigeren van een formulier in een modelgestuurde app naar een aangepaste pagina, het navigeren van een aangepaste pagina naar andere aangepaste pagina's of een modelgestuurd app-formulier met Power Fx.

Navigeren van een aangepaste pagina

De Navigeer functie stelt de gebruikers in staat om te navigeren vanuit modelgestuurde app-formulieren of aangepaste pagina's. Deze functie is alleen van toepassing wanneer de aangepaste pagina wordt uitgevoerd binnen een modelgestuurde app. Tijdens het maken van aangepaste pagina's of het bekijken van een voorbeeld in de canvasontwerper heeft deze functie geen effect.

Navigeren naar een andere aangepaste pagina

Om van de ene aangepaste pagina naar de andere te navigeren, geeft u de weergavenaam van de aangepaste pagina door als de eerste parameter.

Navigate( CustomPage2  )

Navigeren naar de standaardweergave van de tabel

Als u naar de standaardweergave van de tabel wilt navigeren, geeft u de tabelnaam door als eerste parameter.

Navigate( Accounts )

Belangrijk

Zorg ervoor dat u de Microsoft Dataverse-tabel met accounts toevoegt aan de aangepaste pagina voordat u publiceert en test.

Navigeren naar de specifieke systeemweergave van de tabel

Om naar een specifieke systeemweergave van de tabel te navigeren, geeft u de GUID van de weergave door.

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

Navigeer naar het standaardformulier van de tabel

Als u naar het standaardformulier van de tabel wilt navigeren, geeft u de record als eerste parameter door.

Navigate( Gallery1.Selected )

Navigeren naar een specifiek formulier van een tabel

Als u een Dataverse-record aan een specifiek formulier wilt doorgeven, geeft u de formuliernaam in het paginakenmerk van de tweede parameter door.

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

Navigeren naar een specifieke aangepaste pagina met recordinvoer

Als u een Dataverse-record aan een specifieke aangepaste pagina wilt doorgeven, geeft u de naam van de aangepaste pagina in het paginakenmerk van de tweede parameter door.

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

Op de aangepaste doelpagina wordt de record opgehaald met de functie Param om de waarden etn en id op te halen.

Hieronder ziet u een voorbeeld van het laden van de record in een EditForm-besturingselement.

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

Navigeren naar het standaardformulier van de tabel in de aanmaakmodus

Als u naar het standaardformulier van de tabel wilt navigeren, geeft u een Dataverse-record door die is gemaakt op basis van de functie Defaults. Hiermee wordt het standaardformulier geopend met het record als een nieuw record. De Defaults-functie neemt de tabelnaam om het record te maken.

Navigate( Defaults( Accounts ) )

Navigeren naar het standaardformulier van de tabel in de aanmaakmodus met standaardwaarden voor velden

Als u naar een nieuwe record wilt gaan waarbij voor sommige velden standaardwaarden zijn ingesteld, gebruikt u de functie Patch om velden op de standaardrecord voor de tabel in te stellen.

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

Navigeer terug naar de vorige pagina of sluit een dialoogvenster

Om terug te gaan naar de laatste pagina of om een dialoogvenster te sluiten, de Terug functie wordt aangeroepen in een aangepaste pagina. De Terug functie sluit de huidige pagina en keert terug naar de laatste modelgestuurde app of aangepaste pagina in de modelgestuurde app. Als de aangepaste pagina meerdere schermen heeft, zie het artikel Terug navigeren wanneer een aangepaste pagina meerdere schermen heeft.

Back()

Terug navigeren wanneer een aangepaste pagina meerdere schermen heeft

De standaardconfiguratie voor een aangepaste pagina is om één scherm te hebben. In dit geval, sluit de Terug functieaanroep de aangepaste pagina, tenzij de aangepaste pagina de laatste is in de paginastapel in de modelgestuurde app. De laatste pagina blijft open.

Een app-maker kan meerdere schermen inschakelen op een aangepaste pagina. Deze moeten worden beschouwd als besturingselementen voor volledige pagina's binnen de aangepaste pagina die kunnen worden gestapeld. Het openen van een aangepaste pagina heeft geen mogelijkheid om het te gebruiken scherm te specificeren. Wanneer een aangepaste pagina meerdere schermen bevat, is de maker verantwoordelijk voor het beheer van de schermstapeling. Aanroepen van de Navigeren functie naar een scherm wordt toegevoegd aan de schermstapel met de aangepaste pagina. Elke Terug functieaanroep verwijdert een scherm uit de schermstapel. Wanneer er slechts één scherm in de schermstapel is, wordt de aangepaste pagina gesloten.

Meerdere schermen inschakelen

Standaard gebruikt een aangepaste pagina één scherm om scheiding van de app in een scherm per pagina aan te moedigen. U kunt deze optie activeren door Instellingen > Weergave > Meerdere schermen inschakelen in te schakelen.

Bekende problemen

• De functie Navigate biedt geen ondersteuning voor het openen van een model of aangepaste pagina in een dialoogvenster. Alle navigatie vanaf een aangepaste pagina wordt inline geopend.
• De navigatiefunctie ondersteunt niet het openen van:
  • Een dashboardverzameling of een specifiek dashboard.
  • Een specifiek formulier van een modelgestuurde app
• Een aangepaste pagina kan alleen worden geopend in het huidige app-tabblad van de huidige sessie in een modelgestuurde app met meerdere sessies.

Zie ook

Navigeren naar een aangepaste pagina met client-API

Overzicht modelgestuurde app aangepaste pagina