Kongsi melalui


Menggunakan Power Fx dengan perintah

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 aliran data?
  • Fungsi imperatif yang berfungsi dengan data akan disokong.
  • Fungsi imperatif untuk mudah Confirm dan Notify disokong.
  • Untuk senarai fungsi yang tidak disokong, pergi ke Fungsi tidak disokong.

Nota

Menerbitkan Power Fx arahan mungkin mengambil masa beberapa minit. Mungkin tidak jelas bahawa operasi latar belakang masih berjalan walaupun selepas operasi penerbitan kelihatan selesai. Anda mungkin perlu menunggu beberapa minit selepas menerbitkan, kemudian muat semula apl untuk melihat perubahan anda dicerminkan. Operasi ini biasanya mengambil masa yang lebih lama pada kali Power Fx pertama perintah berasaskan diterbitkan untuk aplikasi.

OnSelect

Mentakrifkan logik yang dilaksanakan apabila butang dipilih dalam apl.

Kelihatan

Mentakrifkan logik untuk menyembunyikan atau menunjukkan butang apabila menjalankan aplikasi.

Untuk menentukan logik keterlihatan, pilih arahan. Kemudian pilih Kebolehlihatan pada anak tetingkap sifat arahan kanan dan pilih Tunjukkan pada syarat daripada formula. Anda boleh memilih Boleh dilihat di sebelah kiri bar formula kemudian menulis 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 Selected disediakan oleh hos arahan.
  • Nama item dan AllItems agak konsisten dengan kawalan ComboBox dan kawalan Galeri, tetapi ini ialah corak baharu.
  • Jika tiada rekod dipilih,Item mengembalikan Kosong (IsBlank mengembalikan benar) dan AllItems mengembalikan jadual kosong (IsEmpty mengembalikan benar).
  • 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 berkaitan belum lagi dalam pustaka komponen perintah, anda 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: navigateTo (Rujukan API Klien)

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 tertentu jadual, hantar enum jadual Views .

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, hantar Dataverse rekod yang dicipta daripada fungsi Lalai . Ini membuka borang lalai dengan rekod sebagai rekod baharu. Fungsi Lalai mengambil nama jadual untuk mencipta rekod.

Navigate( Defaults( Accounts ) )

Optimumkan pengalaman pengguna dengan sumber data dan maklumat rekod

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 Visiblenya :

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 Visiblenya :

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.

Beritahu pengguna

Pemberitahuan boleh ditunjukkan kepada pengguna apl dengan memanggil fungsi Maklumkan.

Nota

NotificationType.Success tidak disokong pada masa ini dan menghasilkan jenis pemberitahuan maklumat.

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 yang tersedia dengan perintah

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

Fungsi tidak disokong

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

  • Kembali()
  • Kosongkan()
  • Kumpulkan()
  • Salinan ()
  • Nyahdayakan()
  • Dayakan()
  • Keluar()
  • InvokeControl()
  • Bahasa()
  • LoadData()
  • Param()
  • Cetak ()
  • 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