Utilitzar el Power Fx amb ordres (versió preliminar)
[Aquest tema forma part de la documentació preliminar i està subjecte a canvis.]
Aquesta secció tracta sobre aspectes del Power Fx específics del comandament. Moltes altres funcions que s'utilitzen avui dins de les aplicacions del llenç també es poden utilitzar. Tingueu en compte que hi ha diferències, perquè el comandament és per a les aplicacions basades en models.
Totes les funcions de flux de dades existents estan admeses.
S'admeten funcions imperatius que funcionen amb dades.
S'admeten les funcions imperatius per a Confirmació i Notificació simples.
Per a una llista de funcions no admeses, aneu a les funcions del Power Fx no compatibles.
Important
- Aquesta característica és una característica de versió preliminar i pot ser que no estigui disponible a totes les regions.
- 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.
Desament automàtic
- Moltes ordres de JavaScript s'inicien desant la memòria intermèdia del formulari. Això es deu a que fa que la resta del codi sigui més fàcil de treballar.
- Per defecte, la memòria intermèdia del formulari es desa en nom del creador de l'aplicació.
- El formulari es desa abans d'iniciar l'ordre.
- Els problemes que es produeixen durant l'operació de desar es tracten dins de la interfície d'usuari del formulari.
Propietat seleccionada
| Camp | Type | Descripció |
|---|---|---|
| Element | Registre de DataSource | Un dels registres seleccionats de DataSource |
| AllItems | Taula de registres de DataSource | Tots els registres seleccionats de DataSource |
- L'amfitrió de l'ordre proporciona la propietat seleccionada.
- Els noms Item i AllItems són coherents amb el control ComboBox i el control de la galeria, però aquest és un nou patró.
- Si no hi ha cap registre seleccionat, Item retorna En blanc (IsBlank retorna cert) i AllItems retorna una taula buida (IsEmpty retorna cert).
- DataSource nul per a referències de registres (tipus de registres polimòrfics). Es poden fer trucades a funcions genèriques, com ara Desa o IsType/AsType.
- Item sempre està En blanc si SelectionMax <> 1. Això impedeix l'escriptura de fórmules en un sol element i no escalar a més d'un.
Connecta amb el registre seleccionat actual
Patch(Accounts, Self.Selected.Item, {'Account Name': "Changed Account name"})
Crea un registre relacionat
Nota
Si la taula relacionada encara no és a la biblioteca del component d'ordres, haureu d'obrir-la al taller de llenç i afegir-hi la font de dades.
Patch(Tasks,Defaults(Tasks),{Regarding:Self.Selected.Item},{Subject:"Subject of the Task"})
Comprovar i editar una propietat de data
If(Self.Selected.Item.'Last Date Included in Campaign'>DateAdd(Now(),-3), Patch(Accounts,Self.Selected.Item,{'Last Date Included in Campaign':Date(2021,10,19)}))
Propietat visible: mostra només l'ordre si se seleccionen un o més registres en una visualització de quadrícula
CountRows(Self.Selected.AllItems) > 0
Controlar la visibilitat a partir de les dades de registres
//Button will be visible for accounts with Account Rating > 20
Self.ThisContext.SelectedItem.'Account Rating'>20
Navega
Nota
Per obtenir opcions addicionals, vegeu la referència de l'API del client per utilitzar JavaScript. Més informació: navegar a (referència API de client)
Anar a una pàgina personalitzada
Per anar a una pàgina de llenç personalitzada dins d'una aplicació basada en models, passeu el nom de la pàgina com a primer argument.
Navigate( myCustomPage )
Anar a la visualització per defecte de la taula
Per anar a la visualització per defecte de la taula, s'ha passat el nom de la taula com a primer argument.
Navigate( Accounts )
Anar a la visualització del sistema específica de la taula
Per anar a un visualització del sistema específic de la taula, passa l'enum visualitzacions de la taula.
Navigate( 'Accounts (Views)'.'My Active Accounts' )
Anar al formulari per defecte de la taula
Per anar al formulari per defecte de la taula, passeu el registre de la taula com a primer argument.
Navigate( Gallery1.Selected )
Anar al formulari per defecte de la taula en mode de creació
Per anar al formulari per defecte de la taula, 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 ) )
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 més del botó de diàleg, la cancel·lació també es pot seleccionar amb la tecla Esc 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.
Utilitzeu la funció Notify per visualitzar un bànner a la part superior de l'aplicació que no s'ha de descartar.
Nota
La funció Notify no està disponible actualment amb les aplicacions del llenç.
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.
Exemples
Diàleg de confirmació simple on l'usuari ha de confirmar la supressió d'un registre abans que se suprimeixi. Tret que l'usuari premi el botó D'acord, el registre no se suprimirà.
If( Confirm( "Are you sure?" ), Remove( ThisItem ) )
El mateix diàleg que l'últim exemple, però hi afegeix el text del títol.
If( Confirm( "Are you sure?", {Title: "Delete Confirmation"} ), Remove( ThisItem ) )
Mostra un missatge semblant al de fa la funció Notify, però és modal i requereix que l'usuari seleccioni un botó per continuar. Utilitzeu en situacions en les quals és important que l'usuari reconeixi el missatge abans de continuar. En aquest cas, el botó que s'ha seleccionat no és important.
Confirm( "There was a problem, please review your order." )
Afegir notificacions a una aplicació basada en models
Per mostrar una notificació als usuaris de l'aplicació, feu una trucada a la funció Notifica.
Notify( "Model-driven app notification message" )
Altres exemples
Inicia un URL
Launch("https://www.bing.com");
Accedir a la propietat 1:N
Self.Selected.Item.'Recurring Appointments'
Comprovar la propietat d'un registre relacionat
Self.Selected.Item.'Parent Account'.'Account Name'="parent"
No s'admeten funcions del Power Fx
Les funcions següents del Power Fx actualment no són compatibles amb l'ordre a les aplicacions basades en models.
- Enrere()
- Esborra()
- Collect()
- Inhabilita()
- Edita el formulari()
- Habilita()
- Exit()
- Invoca el control()
- LoadData()
- Forma nova()
- Param()
- ReadNFC()
- RequestHide()
- Reverteix()
- Desadata()
- Reinicialitza el formulari()
- ScanBarcode()
- Estableix()
- Envia el formulari()
- UpdateContext()
- ViewForm()