Kongsi melalui

Menggunakan Power Fx dengan perintah

  • Artikel

Artikel ini merangkumi aspek Power Fx yang khusus untuk memerintah. Banyak fungsi lain yang digunakan hari ini dalam aplikasi kanvas juga boleh digunakan. Perlu diingat terdapat perbezaan kerana perintah adalah untuk aplikasi berpandukan model.

  • Semua fungsi aliran data sedia ada disokong. Apakah itu aliran data?
  • Fungsi imperatif yang berfungsi dengan data akan disokong.
  • Fungsi imperatif untuk Confirm dan Notify mudah disokong.
  • Untuk senarai fungsi yang tidak disokong, pergi ke Fungsi tidak disokong.

Nota

Penerbitan perintah Power Fx mungkin mengambil masa beberapa minit. Ia mungkin tidak jelas bahawa operasi latar belakang masih berjalan walaupun selepas operasi terbit muncul telah dilengkapkan. Anda mungkin perlu menunggu beberapa minit selepas penerbitan, kemudian segar semula aplikasi untuk melihat perubahan anda ditunjukkan. Ini biasanya mengambil masa lebih lama kali pertama perintah berdasarkan Power Fx diterbitkan untuk aplikasi.

OnSelect

Mentakrifkan logik yang dilaksanakan apabila butang dipilih dalam aplikasi.

Kelihatan

Mentakrifkan logik untuk menyembunyikan atau menunjukkan butang apabila menjalankan aplikasi.

Untuk mentakrifkan logik keterlihatan, pilih arahan. Kemudian pilih Keterlihatan pada anak tetingkap sifat perintah kanan dan pilih Tunjukkan mengikut syarat daripada formula. Anda boleh memilih Kelihatan di sebelah kiri bar formula kemudian tulis Power Fx ungkapan menggunakan bar formula.

Sifat yang dipilih

Medan Taip Description
Padam Item Rekod DataSource Salah satu rekod yang dipilih daripada DataSource.
AllItems Jadual rekod daripada DataSource Semua rekod yang dipilih daripada DataSource.
Negeri Enum Keadaan kawalan yang dipilih. Edit (=0), Baharu (=1), Lihat (=2)
Tidak disimpan Boolean Mengembalikan benar jika Yang Dipilih atau SelectedItems mempunyai perubahan yang tidak disimpan. Jika tidak mengembalikan palsu. Sentiasa kembalikan palsu jika AutoSave ditetapkan kepada benar (pilihan lalai) dalam pustaka komponen perintah.
  • Sifat Dipilih disediakan oleh hos perintah.
  • Nama Item dan AllItems agak konsisten dengan kawalan ComboBox dan kawalan Galeri, tetapi ini ialah corak baharu.
  • Jika tiada rekod yang dipilih, Item mengembalikan Kosong (IsBlank mengembalikan true) dan AllItems mengembalikan jadual kosong (IsEmpty mengembalikan true).
  • DataSource Nol untuk rujukan rekod (jenis rekod polimorfik). Fungsi generik boleh dipanggil, seperti Save atau IsType/AsType boleh digunakan.
  • Item sentiasa kosong jika SelectionMax <> 1. Ini mencegah penulisan formula kepada hanya satu item dan tidak menskalakan lebih dari satu.

Autosimpan

  • Banyak perintah JavaScript bermula dengan menyimpan penimbal borang. Ini kerana ia menjadikan kod lain lebih mudah digunakan.
  • Secara lalai, penimbal borang disimpan bagi pihak pembuat aplikasi.
    • Borang disimpan sebelum perintah dimulakan.
    • Sebarang masalah yang berlaku semasa operasi simpan diuruskan dalam UI borang.

Fungsi tampalan

Tampalkan (kemas kini) rekod yang dipilih semasa

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

Nota

Jika jadual yang berkaitan belum ada dalam pustaka komponen perintah anda akan perlu membukanya dalam studio kanvas dan menambah sumber data di sana.

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

Semak dan edit sifat tarikh

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

Sifat boleh lihat: Hanya tunjukkan perintah jika satu atau lebih banyak rekod dipilih dalam pandangan grid

CountRows(Self.Selected.AllItems) > 0

Keterlihatan kawalan berdasarkan data rekod

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

Nota

Untuk pilihan tambahan, lihat rujukan API klien untuk menggunakan JavaScript. Maklumat lanjut: navigasi ke (Rujukan API klien)

Navigasi ke halaman tersuai

Untuk menavigasi ke halaman kanvas tersuai dalam aplikasi berpandukan model, hantarkan nama halaman sebagai argumen pertama.

Navigate( myCustomPage )

Untuk menavigasi ke pandangan lalai jadual, hantarkan nama jadual sebagai argumen pertama.

Navigate( Accounts )

Untuk menavigasi ke pandangan sistem khusus jadual, hantarkan enum Views jadual.

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

Untuk menavigasi ke borang lalai jadual, lulus rekod sebagai argumen pertama.

Navigate( Gallery1.Selected )

Untuk menavigasi ke borang lalai jadual, lulus rekod Dataverse yang dicipta daripada fungsi Lalai. Ini membuka borang lalai dengan rekod sebagai rekod baharu. Fungsi Lalai mengambil nama jadual untuk cipta rekod.

Navigate( Defaults( Accounts ) )

Mengoptimumkan pengalaman pengguna dengan sumber data dan rekod maklumat

Gunakan fungsi DataSourceInfo dan fungsi RecordInfo untuk mengoptimumkan pengalaman pengguna dengan maklumat tentang data yang dipaparkan dan dimanipulasi.

Contohnya, gunakan RecordInfo untuk menentukan sama ada pengguna semasa mempunyai keizinan untuk mengubah suai rekod dan menunjukkan atau menyembunyikan butang "Edit" dengan sewajarnya menggunakan sifat Boleh Dilihatnya :

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

Contohnya, gunakan DataSourceInfo untuk menentukan sama ada pengguna semasa mempunyai keizinan untuk mencipta rekod dan menunjukkan atau menyembunyikan butang "Cipta" dengan sewajarnya menggunakan sifat Kebolehlihatannya :

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

Minta pengesahan sebelum mengambil tindakan

Gunakan fungsi Sahkan untuk memaparkan kotak dialog di atas skrin semasa.

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

Memaparkan pemberitahuan benar jika butang Ya ditekan dan pemberitahuan palsu jika butang Tidak ditekan . ยท

Maklumkan kepada pengguna

Pemberitahuan boleh ditunjukkan pada pengguna aplikasi dengan memanggil Fungsi maklum.

Nota

NotificationType.Success tidak disokong pada masa ini dan akan mengakibatkan jenis pemberitahuan bermaklumat.

Notify( "Model-driven app notification message" )

Contoh lain

Lancarkan URL

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

Akses 1:Sifat N

Self.Selected.Item.'Recurring Appointments'

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

Fungsi tersedia dengan perintah

Untuk maklumat tentang formula yang disokong dengan arahan dalam aplikasi dipacu model, pergi ke Rujukan formula - aplikasi dipacu model.

Fungsi tidak disokong

Fungsi Power Fx berikut pada masa ini tidak disokong dengan arahan dalam aplikasi dipacu model.

  • Kembali()
  • Kosongkan()
  • Kumpulkan()
  • Salinan()
  • Nyahdayakan()
  • Dayakan()
  • Keluar()
  • InvokeControl()
  • Bahasa()
  • LoadData()
  • Param()
  • Cetakan()
  • ReadNFC()
  • RequestHide()
  • ResetForm()
  • Tukar kembali()
  • SaveData()
  • ScanBarcode()
  • Set()
  • SubmitForm()
  • UpdateContext()
  • Pengguna()
  • ViewForm()

Enum tidak disokong

  • Jajar
  • AlignInContainer
  • BarcodeType
  • BorderStyle
  • Warna
  • Arah
  • DisplayMode
  • Fon
  • FontWeight
  • FormPattern
  • GridStyle
  • ImagePosition
  • ImageRotation
  • LabelPosition
  • Tataletak
  • LayoutAlignItems
  • LayoutDirection
  • LayoutJustifyContent
  • LayoutMode
  • LayoutOverflow
  • ListItemTemplate
  • MapStyle
  • Limpahan
  • PDFPasswordState
  • PenMode
  • RemoveFlags
  • ScreenTransition
  • TeamsTheme
  • TextFormat
  • TextMode
  • TextPosition
  • Tema
  • Peralihan
  • VerticalAlign
  • VirtualKeyboardMode
  • Zum

Kawasan lain yang tidak disokong

  • Peningkatan
  • App
  • Compass
  • Connection
  • Dataverse lajur jenis fail
  • Persekitaran
  • Hos
  • Tataletak
  • Lokasi
  • ScreenSize

Lihat juga

Fahami formula tingkah laku

Rujukan formula

Gambaran Keseluruhan Power Fx