Utilitzar el Power Fx en una pàgina personalitzada per a l'aplicació basada en models

En aquest article s'explica com funcionen les funcions comunes Microsoft Power Fx de manera diferent entre una aplicació independent de llenç i una pàgina personalitzada. Això es deu al fet que una pàgina personalitzada és un component de l'aplicació basada en models. Altres Microsoft Power Fx fórmules es comporten de la mateixa manera.

Important

  • La funcionalitat base de les pàgines personalitzades s'ha traslladat a la disponibilitat general en totes les regions. No obstant això, algunes capacitats específiques o noves capacitats encara estan en visualització prèvia pública i estan marcades amb (vista prèvia).
  • Les característiques de visualització prèvia no estan dissenyades per a un entorn de producció i poden tenir una funcionalitat restringida. Aquestes característiques estan disponibles abans d’un llançament oficial de producte per tal que els clients el puguin utilitzar abans i enviar-nos els seus comentaris.
  • Les pàgines personalitzades són una característica nova amb canvis importants de productes i actualment tenen diverses limitacions conegudes destacades a Problemes coneguts de la pàgina personalitzada.

Afegir notificacions a una pàgina personalitzada

Per mostrar una notificació als usuaris en una pàgina personalitzada, feu una trucada a la funció Notifica. Quan apareguin els missatges de notificació, s'acoblaran a sobre de la pàgina per defecte per mantenir-se visibles fins que estiguin desactivats. Si es proporciona un interval de temps d'espera, el missatge de notificació desapareixerà després de l'interval de temps d'espera. Es recomana no utilitzar un interval de temps d'espera de 10, ja que ja no es considera un interval de temps d'espera. Més informació: Notificar funció.

Notify( "Custom page notification message" )

Pàgina personalitzada Notifica la barra de missatges d'informació

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

Pàgina personalitzada Notifica la barra de missatges d'advertiment

Aquesta secció proporciona exemples de navegació des d'un formulari d'aplicació basada en models a una pàgina personalitzada, navegant des d'una pàgina personalitzada a altres pàgines personalitzades o formulari d'aplicació basada en models mitjançant Power Fx.

La funció Navigate permet als usuaris navegar des de formularis d'aplicacions basades en models o pàgines personalitzades. Aquesta funció només és aplicable quan la pàgina personalitzada s'executa dins d'una aplicació basada en models. Durant la creació o visualització prèvia d'una pàgina personalitzada al dissenyador de llenç, aquesta funció no té efecte.

Per navegar d'una pàgina personalitzada a una altra, passeu el nom de visualització de la pàgina personalitzada com a primer paràmetre.

Navigate( CustomPage2  )

Per anar a la visualització per defecte de la taula, s'ha passat el nom de la taula com a primer paràmetre.

Navigate( Accounts )

Per anar a una visualització del sistema específica de la taula, passeu la visualitzacions de GUID.

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

Per anar al formulari per defecte de la taula, passeu el registre de la taula com a primer paràmetre.

Navigate( Gallery1.Selected )

Per anar a un formulari específic del registre, passeu la pàgina al segon paràmetre.

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

Per anar al formulari per defecte de la taula en mode de creació, passeu un registre Dataverse creat des de la funció Predeterminades. S'obrirà el formulari per defecte amb el registre com un registre nou. La funció Predeterminades pren el nom de la taula per crear el registre.

Navigate( Defaults( Accounts ) )

Per anar a un registre nou amb alguns camps per defecte, utilitzeu la funció Patch per definir camps al registre per defecte de la taula.

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

Per tornar a la darrera pàgina o tancar un diàleg, es fa una trucada a la funció Enrere en una pàgina personalitzada. La funció Enrere tanca la pàgina actual i torna a l'última aplicació basada en models o a la pàgina personalitzada de l'aplicació basada en models. Si la pàgina personalitzada té diverses pantalles, vegeu l'article Navegació enrere quan la pàgina personalitzada tingui diverses pantalles.

Back( )

La configuració per defecte d'una pàgina personalitzada és tenir una pantalla. En aquest cas, la crida a la funció Enrere tancarà la pàgina personalitzada a menys que la pàgina personalitzada sigui l'última de la pila de pàgines de l'aplicació basada en models. L'última pàgina es manté oberta.

Un creador d'aplicacions pot habilitar diverses pantalles en una pàgina personalitzada. Aquests s'han de considerar com a controls de pàgina completa dins de la pàgina personalitzada que es poden apilar. Obrir una pàgina personalitzada no té cap mitjà per especificar la pantalla que s'utilitzarà. Quan una pàgina personalitzada conté diverses pantalles, el creador s'encarrega de gestionar l'apilament de pantalles. Si crideu la funció Navega a una pantalla, s'afegirà a la pila de pantalla amb la pàgina personalitzada. Cada crida de funció Enrere eliminarà una pantalla de la pila de pantalles. Quan només hi ha una pantalla a la pila de pantalles, es tanca la pàgina personalitzada.

S'estan habilitant diverses pantalles

De manera predeterminada, una pàgina personalitzada utilitza una sola pantalla per afavorir la separació de l'aplicació en una pantalla per pàgina. Això es pot canviar habilitant Configuració > Visualitza Habilita > diverses pantalles.

La pàgina personalitzada habilita diverses pantalles

Confirma la funció

La funció Confirm mostra un quadre de diàleg a la part superior de la pantalla actual. Es proporcionen dos botons: el botó Confirma i el botó Cancel·la, per defecte, per a les versions localitzades de "D'acord" i "Cancel·la", respectivament. L'usuari ha de confirmar o cancel·lar abans que es descarti el quadre de diàleg i la funció retorni. A banda del botó de diàleg, la cancel·lació també es pot seleccionar amb la tecla Retorn o altres gestos específics de la plataforma.

El paràmetre Message es visualitza al cos del quadre de diàleg. Si el missatge és molt llarg, es truncarà o es proporcionarà una barra de desplaçament.

Utilitzeu el paràmetre OptionsRecord per especificar opcions per al quadre de diàleg. No totes les opcions estan disponibles a cada plataforma i es gestionen en les millors condicions possibles.

Nota

Les opcions de la taula següent no estan disponibles actualment amb les aplicacions del llenç.

Camp de l'opció Descripció
ConfirmButton Text que es visualitzarà al botó Confirma, substituint el text per defecte localitzat "D'acord".
CancelButton Text que es visualitzarà al botó Cancel·la, substituint el text per defecte localitzat "Cancel·la".
Càrrec Text que es mostrarà com a títol del quadre de diàleg. Un tipus de lletra més gran que el tipus de lletra del missatge es pot utilitzar per visualitzar aquest text. Si aquest valor és molt llarg, es truncarà.
Subtítol Text que es mostrarà com a subtítol del quadre de diàleg. Un tipus de lletra més gran que el tipus de lletra del missatge es pot utilitzar per visualitzar aquest text. Si aquest valor és molt llarg, es truncarà.

Confirm retorna cert si el botó de confirmació s'ha seleccionat; en cas contrari, retorna fals.

Sintaxi

Confirma( Missatge [, OptionsRecord ] )

  • Message - Obligatori. Missatge que es mostrarà a l'usuari.
  • OptionsRecord - Opcional. Proporcioneu opcions avançades per al diàleg. No totes les opcions estan disponibles a cada plataforma i es gestionen en les millors condicions possibles. En aquest moment, a les aplicacions del llenç, no s'admet cap d'aquestes opcions.

Problemes coneguts

  • La Navigate funció no té suport per obrir un model o una pàgina personalitzada a un diàleg. Tota la navegació des d'una pàgina personalitzada s'obre en línia.
  • La funció Navigate no admet l'obertura:
    • Una col·lecció d'escriptori digital o un escriptori digital específic.
    • Un formulari d'aplicació específic basat en models.
  • Una pàgina personalitzada només es pot obrir a la pestanya d'aplicació actual de la sessió actual en una aplicació basada en models de diverses sessions.

Consulteu també

Navegar cap a i des d'una pàgina personalitzada amb una API de client

Versió preliminar d'una pàgina personalitzada d'una aplicació basada en models