Upotreba dodatka Power Fx s naredbama (pretpregled)

[Ova tema spada u dokumentaciju predizdanja i podložna je promjenama.]

Ovaj odjeljak pokriva aspekte programa Power Fx koji su specifični za davanje naredbi. Mogu se koristiti i mnoge druge funkcije koje se danas koriste u aplikacijama od gotovih gradivnih elemenata. Imajte na umu da postoje razlike jer je davanje naredbi za aplikacije stvorene prema modelu.

  • Podržane su sve postojeće funkcije protoka podataka.

  • Podržane su imperativne funkcije koje rade s podacima.

  • Podržane su imperativne funkcije za jednostavno Potvrdi i Obavijesti.

  • Popis funkcija koje nisu podržane potražite u odjeljku Funkcije dodatka Power Fx koje nisu podržane.

    Važno

    • Ovo je značajka pretpregleda i možda nije dostupna u svim regijama.
    • Značajke pretpregleda nisu namijenjene u proizvodne svrhe i mogu imati ograničene funkcije. Te su značajke dostupne prije službenog izdavanja da bi se klijentima omogućio prijevremeni pristup i slanje povratnih informacija.

Automatsko spremanje

  • Mnoge JavaScript naredbe započinju spremanjem međuspremnika za obrasce. To je zato što olakšava rad s ostatkom koda.
  • Prema zadanim postavkama, međuspremnik za obrasce sprema se u ime proizvođača aplikacije.
    • Obrazac se sprema prije pokretanja naredbe.
    • Svi problemi koji se jave tijekom operacije spremanja rješavaju se unutar korisničkog sučelja obrasca.

Odabrano svojstvo

Polje Tip Opis
Stavka Zapis izvora podataka Jedan od zapisa odabranih iz izvora podataka
Sve stavke Tablica zapisa iz izvora podataka Svi zapisi odabrani iz izvora podataka
  • Svojstvo Odabrano daje domaćin naredbe.
  • Stavka i Sve stavke nazivi su donekle u skladu s kontrolom ComboBox i galerijom, ali ovo je novi uzorak.
  • Ako nije odabran zapis, Stavka se vraća prazna (JePrazna vraća se istinita) i Sve stavke vraća praznu tablicu (Jeprazna vraća se istinita).
  • Null DataSource za reference zapisa (polimorfne vrste zapisa). Mogu se pozvati generičke funkcije, poput Spremi ili JeVrsta/KaoVrsta.
  • Stavka je uvijek prazna ako OdabirMaks <> 1. Time se sprječava upisivanje formula na samo jednu stavku i skaliranje na više od jedne.

Zakrpajte trenutačno odabrani zapis

Patch(Accounts, Self.Selected.Item, {'Account Name': "Changed Account name"})

Napomena

Ako povezana tablica još nije u knjižnici naredbenih komponenti, morat ćete je otvoriti u studiju radnog područja i tamo dodati izvor podataka.

Patch(Tasks,Defaults(Tasks),{Regarding:Self.Selected.Item},{Subject:"Subject of the Task"})

Provjerite i uredite svojstvo datuma

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)}))

Vidljivo svojstvo: Prikažite naredbu samo ako je jedan ili više zapisa odabrano u prikazu rešetke

CountRows(Self.Selected.AllItems) > 0

Upravljajte vidljivošću na temelju zapisa podataka

//Button will be visible for accounts with Account Rating > 20
Self.ThisContext.SelectedItem.'Account Rating'>20

Napomena

Dodatne mogućnosti potražite u referenci KLIJENTSKOG API-ja za korištenje JavaScripta. Dodatne informacije: navigirajte (referenca API-ja klijenta)

Da biste prešli na prilagođenu stranicu radnog područja unutar aplikacije utemeljene na modelu, proslijedite naziv stranice kao prvi argument.

Navigate( myCustomPage )

Za prelazak na zadani prikaz tablice proslijeđeno je ime tablice kao prvi argument.

Navigate( Accounts )

Da biste prešli na određenu sistemski prikaz tablice, prođite pored enuma Prikazi tablice.

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

Za prelazak na zadani obrazac tablice, proslijedite zapis kao prvi argument.

Navigate( Gallery1.Selected )

Za prelazak na zadani obrazac tablice, proslijedite Dataverse zapis nastao iz funkcije zadanih postavki. Ovo će otvoriti zadani obrazac sa zapisom kao novim zapisom. Funkcija Zadane postavke uzima naziv tablice za stvaranje zapisa.

Navigate( Defaults( Accounts ) )

Potvrđivanje funkcije

Funkcija Confirm prikazuje dijaloški okvir pri vrhu trenutnog zaslona. Dostupna su dva gumba: gumb za potvrdu i gumb za poništavanje koji su zadani za lokalizirane verzije "U redu" i "Poništi". Korisnik mora potvrditi ili otkazati prije nego što se dijaloški okvir odbaci i funkcija se vrati. Osim gumba dijaloškog okvira, odustani se može odabrati i pomoću tipke Esc ili drugih gesta koje su specifične za platformu.

Parametar Message prikazan je u tijelu dijaloškog okvira. Ako je poruka vrlo dugačka, bit će skraćena ili će se prikazati traka za pomicanje.

Koristite parametar OptionsRecord za određivanje opcija za dijaloški okvir. Nisu sve opcije dostupne na svakoj platformi i njima se rukuje po principu "najboljeg napora".

Napomena

Opcije u donjoj tablici trenutačno nisu dostupne s aplikacijama od gotovih gradivnih elemenata.

Polje mogućnosti Opis
Gumb za potvrđivanje Tekst za prikaz na gumbu potvrdi, zamjenjujući zadani, lokalizirani tekst " U redu".
CancelButton Tekst za prikaz na gumbu otkaži, zamjenjujući zadani, lokalizirani tekst "Otkaži".
Naziv Tekst koji će se prikazati kao naslov dijaloškog okvira. Za prikaz ovog teksta može se koristiti veći, podebljaniji font od fonta poruke. Ako je ova vrijednost vrlo duga, bit će skraćena.
Podnaslov Tekst koji će se prikazati kao podnaslov dijaloškog okvira. Za prikaz ovog teksta može se koristiti veći, podebljaniji font od fonta poruke. Ako je ova vrijednost vrlo duga, bit će skraćena.

Confirm vraća istinito ako je odabran gumb za potvrđivanje, u suprotnom neistinito.

Koristite funkciju Notify za prikaz natpisa pri vrhu aplikacije koji ne treba odbaciti.

Napomena

Funkcija Notify trenutačno nije dostupna s aplikacijama od gotovih gradivnih elemenata.

Sintaksa

Potvrdi( Poruka [, OptionsRecord ] )

  • Message- obavezno. Poruka koja se prikazuje korisniku.
  • OptionsRecord - opcionalno. Omogućite napredne opcije za dijaloški okvir. Nisu sve opcije dostupne na svakoj platformi i njima se rukuje po principu najboljeg napora. U aplikacijama od gotovih gradivnih elemenata trenutačno nijedna od ovih opcija nije podržana.

Primjeri

Jednostavan dijaloški okvir za potvrdu u kojem se od korisnika traži da potvrdi brisanje zapisa prije nego što se ukloni. Osim ako korisnik pritisne gumb U redu, zapis se neće izbrisati.

If( Confirm( "Are you sure?" ), Remove( ThisItem ) )

Isti dijaloški okvir kao i posljednji primjer, ali dodaje naslovni tekst.

If( Confirm( "Are you sure?", {Title: "Delete Confirmation"} ), Remove( ThisItem ) )

Prikazuje poruku sličnu mogućnosti Notify, ali je modalna i zahtijeva od korisnika da odabere gumb za nastavak. Koristite u situacijama u kojima je važno da korisnik potvrdi poruku prije nastavka. U ovom slučaju nije važno koji je gumb odabran.

Confirm( "There was a problem, please review your order." )

Dodajte obavijesti aplikaciji stvorenoj prema modelu

Obavijest se može prikazati korisnicima aplikacije pozivanjem funkcije obavijesti.

Notify( "Model-driven app notification message" )

Drugi primjeri

Pokreni URL

Launch("https://www.bing.com");

Pristup 1:N svojstvo

Self.Selected.Item.'Recurring Appointments'
Self.Selected.Item.'Parent Account'.'Account Name'="parent"

Funkcije dodatka Power Fx nisu podržane

Sljedeće funkcije dodatka Power Fx trenutno nisu podržane naredbama u aplikacijama utemeljenima na modelu.

  • Natrag()
  • Očisti()
  • Sakupi()
  • Onemogući()
  • EditForm()
  • Omogući()
  • Exit()
  • Pozovikontrolu()
  • LoadData()
  • NewForm()
  • Param()
  • ReadNFC()
  • RequestHide()
  • Vrati()
  • SaveData()
  • Vrati izvorno()
  • ScanBarcode()
  • Skup()
  • SubmitForm()
  • UpdateContext()
  • Oblik prikaza()

Pogledajte

Objašnjenje formula ponašanja

Referenca formule

Pregled Power Fx-a