Bagikan melalui

Menggunakan Power Fx dengan perintah

Artikel ini mencakup aspek Power Fx yang khusus untuk perintah. Banyak fungsi lain yang digunakan saat ini dalam aplikasi kanvas juga dapat digunakan. Perlu diingat ada perbedaan karena perintah adalah untuk aplikasi berbasis model.

  • Semua fungsi aliran data yang ada didukung. Apa itu aliran data?
  • Fungsi imperatif yang bekerja dengan data didukung.
  • Fungsi imperatif untuk sederhana Confirm dan Notify didukung.
  • Untuk daftar fungsi yang tidak didukung, buka Fungsi tidak didukung.

Catatan

Menerbitkan Power Fx perintah mungkin memakan waktu beberapa menit. Mungkin tidak jelas bahwa operasi latar belakang masih berjalan bahkan setelah operasi publikasi tampaknya selesai. Anda mungkin perlu menunggu beberapa menit setelah memublikasikan, lalu me-refresh aplikasi untuk melihat perubahan Anda tercermin. Operasi ini biasanya memakan waktu lebih lama saat pertama kali Power Fx perintah berbasis diterbitkan untuk aplikasi.

OnSelect

Menentukan logika yang dijalankan saat tombol dipilih dalam aplikasi.

Terlihat

Mendefinisikan logika untuk menyembunyikan atau menampilkan tombol saat menjalankan aplikasi.

Untuk menentukan logika visibilitas, pilih perintah. Kemudian pilih Visibilitas di panel properti perintah kanan dan pilih Tampilkan kondisi dari rumus. Anda dapat memilih Terlihat di sebelah kiri bilah rumus lalu menulis ekspresi Power Fx menggunakan bilah rumus.

Properti yang dipilih

Bidang Tipe Description
Item Rekaman DataSource Salah satu rekaman yang dipilih dari DataSource.
AllItems Tabel rekaman dari DataSource Semua rekaman yang dipilih dari DataSource.
Provinsi Enum Status kontrol yang dipilih. Edit (=0), Baru (=1), Tampilan (=2)
Belum disimpan Boolean Menghasilkan true jika Selected atau SelectedItems memiliki perubahan yang tidak disimpan. Jika tidak, menghasilkan false. Selalu menghasilkan false jika AutoSave diatur ke true (pilihan default) dalam pustaka komponen perintah.
  • Properti Selected disediakan oleh host perintah.
  • Nama item dan AllItems agak konsisten dengan kontrol ComboBox dan kontrol Galeri, tetapi ini adalah pola baru.
  • Jika tidak ada rekaman yang dipilih, Item mengembalikan Kosong (IsBlank mengembalikan true) dan AllItems mengembalikan tabel kosong (IsEmpty mengembalikan true).
  • DataSource Nihil untuk referensi rekaman (jenis rekaman polimorfik). Fungsi generik dapat dipanggil, seperti Save atau IsType/AsType dapat digunakan.
  • Item selalu kosong jika SelectionMax<> 1. Tindakan ini mencegah penulisan rumus ke hanya satu item dan tidak menskalakan ke lebih dari satu.

Simpan Otomatis

  • Banyak perintah JavaScript dimulai dengan menyimpan buffer formulir. Ini karena membuat sisa kode lebih mudah dikerjakan.
  • Secara default, buffer formulir disimpan atas nama pembuat aplikasi.
    • Formulir disimpan sebelum perintah dimulai.
    • Setiap masalah yang terjadi selama operasi penyimpanan ditangani dalam UI formulir.

Fungsi Patch

Patch (update) untuk rekaman yang dipilih saat ini

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

Catatan

Jika tabel terkait belum ada di pustaka komponen perintah, Anda perlu membukanya di canvas studio dan menambahkan sumber data di sana.

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

Memeriksa dan mengedit properti tanggal

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

Properti yang terlihat: Hanya tampilkan perintah jika satu atau beberapa rekaman dipilih dalam tampilan kisi

CountRows(Self.Selected.AllItems) > 0

Mengontrol visibilitas berdasarkan data rekaman

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

Catatan

Untuk opsi tambahan, lihat referensi API klien untuk menggunakan JavaScript. Informasi selengkapnya: navigateTo (Referensi API klien)

Navigasi ke halaman kustom

Untuk menavigasi ke halaman kanvas kustom dalam aplikasi berdasarkan model, berikan nama halaman sebagai argumen pertama.

Navigate( myCustomPage )

Untuk menavigasi ke tampilan default tabel, teruskan nama tabel sebagai argumen pertama.

Navigate( Accounts )

Untuk menavigasi ke tampilan sistem tertentu dari tabel, teruskan enum tabel Views .

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

Untuk menavigasi ke formulir default tabel, teruskan rekaman sebagai argumen pertama.

Navigate( Gallery1.Selected )

Untuk menavigasi ke formulir default tabel, teruskan Dataverse rekaman yang dibuat dari fungsi Default. Formulir default akan terbuka dengan rekaman sebagai rekaman baru. Fungsi Default mengambil nama tabel untuk membuat rekaman.

Navigate( Defaults( Accounts ) )

Mengoptimalkan pengalaman pengguna dengan sumber data dan informasi rekaman

Gunakan fungsi DataSourceInfo dan fungsi RecordInfo untuk mengoptimalkan pengalaman pengguna dengan informasi tentang data yang ditampilkan dan dimanipulasi.

Misalnya, gunakan RecordInfo untuk menentukan apakah pengguna saat ini memiliki izin untuk mengubah rekaman dan menampilkan atau menyembunyikan tombol "Edit" dengan tepat menggunakan properti Terlihat :

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

Misalnya, gunakan DataSourceInfo untuk menentukan apakah pengguna saat ini memiliki izin untuk membuat rekaman dan menampilkan atau menyembunyikan tombol "Buat" dengan tepat menggunakan properti Terlihat :

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

Minta konfirmasi sebelum mengambil tindakan

Gunakan fungsi Konfirmasi untuk menampilkan kotak dialog di atas layar saat ini.

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

Menampilkan pemberitahuan true jika tombol Ya ditekan, dan pemberitahuan false jika tombol Tidak ditekan.

Beri tahu pengguna

Notifikasi dapat ditampilkan kepada pengguna aplikasi dengan memanggil fungsi Notifikasi.

Catatan

NotificationType.Success saat ini tidak didukung dan menghasilkan jenis pemberitahuan informasi.

Notify( "Model-driven app notification message" )

Contoh lainnya

Jalankan URL

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

Properti 1:N Akses

Self.Selected.Item.'Recurring Appointments'

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

Fungsi yang tersedia dengan perintah

Untuk informasi tentang rumus yang didukung dengan perintah di aplikasi berbasis model, buka Referensi rumus - aplikasi berbasis model.

Fungsi tidak didukung

Fungsi Power Fx berikut saat ini tidak didukung dengan perintah di aplikasi berbasis model.

  • Back()
  • Clear()
  • Collect()
  • Salin ()
  • Disable()
  • Enable()
  • Keluar()
  • InvokeControl()
  • Language()
  • LoadData()
  • Param()
  • Cetak()
  • ReadNFC()
  • RequestHide()
  • ResetForm()
  • Revert()
  • SaveData()
  • ScanBarcode()
  • Set()
  • SubmitForm()
  • UpdateContext()
  • User()
  • ViewForm()

Enum Tidak didukung

  • Perataan
  • AlignInContainer
  • BarcodeType
  • BorderStyle
  • Warna
  • Arah
  • DisplayMode
  • Font
  • FontWeight
  • FormPattern
  • GridStyle
  • ImagePosition
  • ImageRotation
  • LabelPosition
  • Tata letak
  • LayoutAlignItems
  • LayoutDirection
  • LayoutJustifyContent
  • LayoutMode
  • LayoutOverflow
  • ListItemTemplate
  • MapStyle
  • Luapan
  • PDFPasswordState
  • PenMode
  • RemoveFlags
  • ScreenTransition
  • TeamsTheme
  • TextFormat
  • TextMode
  • TextPosition
  • Tema
  • Transisi
  • VerticalAlign
  • VirtualKeyboardMode
  • Perbesar

Area lain yang tidak didukung

  • Akselerasi
  • App
  • Compass
  • Connection
  • Dataverse Kolom jenis file
  • Lingkungan
  • Host
  • Tata letak
  • Lokasi
  • ScreenSize

Baca juga

Memahami rumus perilaku

Referensi rumus

Sekilas tentang Power Fx

  • Last updated on