Power Fx:n käyttäminen komentojen avulla

Tässä artikkelissa käsitellään Power Fx:n ominaisuuksia, jotka liittyvät komentojen käyttämiseen. Lisäksi monia muita tällä hetkellä pohjaan perustuvassa sovelluksessa käytettäviä funktioita voidaan käyttää. Erot on kuitenkin pidettävä mielessä, sillä mallipohjaisissa sovelluksissa käytetään komentoja.

• Kaikkia aiempia tietovuotoimintoja tuetaan. Mitä tietovuot ovat?
• Tietoja koskevia imperatiivisia funktioita tuetaan.
• Yksinkertaisia toimintojen Confirm ja Notify imperatiivisia funktioita tuetaan.
• Luettelo funktioista, joita ei tueta: Funktiot, joita ei tueta.

Huomautus

Power Fx -komentojen julkaiseminen voi kestää muutaman minuutin. Taustatoimintojen käynnissä oleminen ei välttämättä ole ilmeistä, kun julkaisutoiminto vaikuttaa valmiilta. Voi olla tarpeen odottaa julkaisemisen jälkeen jonkin aikaa ja sitten ladata sovellus uudelleen, jotta muutokset näkyisivät. Tämä kestää yleensä pitempään, kun Power Fx -pohjainen komento julkaistaan sovellusta varten ensimmäistä kertaa.

OnSelect

Määrittää logiikan, joka suoritetaan, kun painike valitaan sovelluksessa.

Näkyvä

Määrittää logiikan, jonka perusteella painike näytetään tai piilotetaan, kun sovellus suoritetaan.

Määritä näkyvyyslogiikka tällä komennolla. Valitse sitten Näkyvyys oikeanpuoleisesta komento-ominaisuuksien ruudusta ja valitse Näytä ehto kaavasta. Nyt tehdä valinnan Näkyvä lomakepalkin vasemmalla puolella ja sitten kirjoittaa Power Fx -lausekkeen lomakepalkin avulla.

Selected-ominaisuus

Kenttä	Tyyppi	Kuvaus
Kohde	Tietolähteen tietue	Jokin tietolähteestä valittu tietue.
AllItems	Tietolähteen tietuetaulukko	Kaikki tietolähteestä valitut tietueet.
Tila	Luettelointi	Valitun ohjausobjektin tila. Edit (=0), New (=1), View (=2)
Tallentamaton	Totuusarvo	Palauttaa arvon tosi, jos kohdassa Selected tai SelectedItems on tallentamattomia muutoksia. Palauttaa muuten arvon epätosi. Palauttaa aina arvon epätosi, jos AutoSave on määritetty arvoon tosi (oletusvalinta) komentokomponenttikirjastossa.

• Komennon isäntä antaa Selected-ominaisuuden.
• Vaikka Item- ja AllItems-nimet ovat jossain määrin yhdenmukaisia ComboBox- ja Valikoima-ohjausobjektin kanssa, kyse on uudesta mallista.
• Jos tietuetta ei ole valittu, Item palauttaa arvon Blank (IsBlank palauttaa arvon true) ja AllItems palauttaa tyhjän taulukon (IsEmpty palauttaa arvon true).
• Tietueviitteenä tyhjäarvoinen tietolähde (polymorfiset tietuetyypit). Yleisiä funktioita voidaan kutsua, kuten Tallenna, IsType- tai AsType-funktioita voidaan käyttää.
• Item on aina tyhjä, jos SelectionMax <> 1. Tämä estää kaavan kirjoittamisen vain yhdellä kohteelle ja sen, ettei jätetä skaalaamalla useammalle kuin yhdelle.

AutoSave

• Monien JavaScript-komentojen aluksi tallennetaan lomakepuskuri. Tämä tehdään, koska se helpottaa muun koodin käsittelyä.
• Lomakepuskuri tallennetaan oletusarvoisesti sovelluskehittäjän puolesta.
  • Lomake tallennetaan ennen komennon käynnistämistä.
  • Tallennustoiminnon aikana mahdollisesti esiintyvät ongelmat käsitellään lomakekäyttöliittymässä.

Patch-funktio

Korjaa (päivittää) valittuna olevan tietueen

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

Liittyvän tietueen luominen

Huomautus

Jos liittyvää taulukkoa ei ole vielä komentokomponenttikirjastossa, se on avattava pohjastudiossa, jonne on myös lisättävä tietolähde.

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

Päivämääräominaisuuden tarkistaminen ja muokkaaminen

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

Näkyvä-ominaisuus: komennon näyttäminen vain, jos ruudukkonäkymässä on valittu vähintään yksi tietue

CountRows(Self.Selected.AllItems) > 0

Näkyvyyden hallinta tietueen tietojen perusteella

//Button will be visible for accounts with Account Rating > 20
Self.Selected.Item.'Account Rating'>20

Siirry

Huomautus

Lisätietoja on asiakkaan ohjelmointirajapinnan viittauksessa JavaScriptin käyttämiseen. Lisätietoja: navigateTo (asiakasohjelman ohjelmointirajapintaviittaus)

Mukautetulle sivulle siirtyminen

Jos haluat siirtyä mallipohjaisen sovelluksen mukautetulle pohjasivulle, välitä sivun nimi ensimmäisenä argumenttina.

Navigate( myCustomPage )

Taulukon oletusnäkymään siirtyminen

Jos haluat siirtyä taulukon oletusnäkymään, välitä taulukon nimi ensimmäisenä argumenttina.

Navigate( Accounts )

Taulukon tiettyyn järjestelmänäkymään siirtyminen

Tiettyyn taulukon järjestelmänäkymään siirrytään, kun taulukon Views-luettelointi välitetään.

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

Taulukon oletuslomakkeeseen siirtyminen

Taulukon oletuslomakkeeseen siirrytään, kun tietue välitetään ensimmäisenä argumenttina.

Navigate( Gallery1.Selected )

Luontitilaisen taulukon oletuslomakkeeseen siirtyminen

Taulukon oletuslomakkeeseen siirrytään, kun Defaults-funktiolla luotu Dataverse-tietue välitetään. Tämä avaa tietueen sisältävän oletuslomakkeen uutena tietueena. Defaults-funktio luo tietueen ottamalla taulukon nimen.

Navigate( Defaults( Accounts ) )

Käyttäjäkokemuksen optimointi tietolähteen ja tietueen tietojen avulla

Käytä DataSourceInfo-toimintoa ja RecordInfo-toimintoa käyttäjäkokemuksen optimoimisessa näytettävien ja muokattavien tietojen avulla.

Käytä esimerkiksi RecordInfo-kohtaa, jos haluat määrittää, onko nykyisellä käyttäjällä tietueen muokkausoikeus, sekä näyttääksesi tai piilottaaksesi Muokkaa-painikkeen käyttämällä sen Näkyvä-ominaisuutta:

EditButton.Visible = 
   RecordInfo( Gallery1.Selected, RecordInfo.EditPermission )

Voit esimerkiksi määrittää DataSourceInfo-ominaisuuden avulla, onko nykyisellä käyttäjällä tietueen luontioikeudet, ja näyttää tai piilottaa Luo-painikkeen käyttämällä näkyvää ominaisuutta:

CreateButton.Visible = 
   DataSourceInfo( Accounts, DataSourceInfo.CreatePermission )

Vahvistuksen pyytäminen ennen toiminnon suorittamista

Näytä valintaikkuna nykyisen näytön yläosassa käyttämällä Vahvista-toimintoa.

Notify( Confirm( "Are you sure?", 
                 { ConfirmButton: "Yes", CancelButton: "No" } 
        ) 
)

Näyttää ilmoituksen tosi, jos Kyllä-painiketta painetaan, ja epätosi-ilmoituksen, jos Ei-painiketta painetaan.

Ilmoittaminen käyttäjälle

Ilmoitus voidaan näyttää sovelluksen käyttäjille kutsumalla Notify-funktio.

Huomautus

NotificationType.Success ei ole tällä hetkellä tuettu, ja tuloksena on ilmoitustyyppi, jossa on tietoja.

Notify( "Model-driven app notification message" )

Lisää esimerkkejä

URL-osoitteen käynnistäminen

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

1:N-ominaisuuden käyttäminen

Self.Selected.Item.'Recurring Appointments'

Liittyvän tietueen ominaisuuden tarkistus

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

Funktiot, joita ei tueta

Mallipohjaiset sovellukset eivät tällä hetkellä tue komentojen kanssa seuraavia Power Fx -funktioita.

• Back()
• Clear()
• Collect()
• Copy()
• Disable()
• Enable()
• Exit()
• InvokeControl()
• Language()
• LoadData()
• Param()
• Tulosta()
• ReadNFC()
• RequestHide()
• ResetForm()
• Revert()
• SaveData()
• ScanBarcode()
• Set()
• SubmitForm()
• UpdateContext()
• User()
• ViewForm()

Valintaluettelot, joita ei tueta

• Align
• AlignInContainer
• BarcodeType
• BorderStyle
• Color
• Direction
• DisplayMode
• Font
• FontWeight
• FormPattern
• GridStyle
• ImagePosition
• ImageRotation
• LabelPosition
• Asettelu
• LayoutAlignItems
• LayoutDirection
• LayoutJustifyContent
• LayoutMode
• LayoutOverflow
• ListItemTemplate
• MapStyle
• Overflow
• PDFPasswordState
• PenMode
• RemoveFlags
• ScreenTransition
• TeamsTheme
• TextFormat
• TextMode
• TextPosition
• Teemat
• Siirtymä
• VerticalAlign
• VirtualKeyboardMode
• Zoom

Muut alueet, joita ei tueta

• Nopeutus
• Sovellus
• Kompassi
• Yhteys
• Dataverse-tiedostotyypin sarakkeet
• Ympäristö
• Isäntä
• Asettelu
• Sijainti
• ScreenSize

Katso myös

Tietoja kaavojen toiminnasta

Kaavaviittaus

Power Fx:n yleiskatsaus