Bagikan melalui


fungsi Choices

Berlaku untuk: Aplikasi Kanvas Aplikasi berbasis model Power Pages

Menampilkan tabel kemungkinan nilai untuk kolom pencarian.

Description

Fungsi mengembalikan Choices tabel nilai yang mungkin untuk kolom pencarian.

Choices Gunakan fungsi untuk menyediakan daftar pilihan untuk dipilih pengguna Anda. Fungsi ini biasanya digunakan bersama kontrol Kotak kombo dalam edit formulir.

Untuk pencarian, tabel yang Choices kembali cocok dengan tabel asing yang terkait dengan pencarian. Dengan menggunakan Choices, Anda menghilangkan kebutuhan untuk menambahkan tabel asing sebagai sumber data tambahan. Choices mengembalikan semua kolom tabel asing.

Karena Choices mengembalikan tabel, Anda bisa menggunakan Filter, Sortir, AddColumns, dan semua fungsi manipulasi tabel lainnya untuk memfilter, mengurutkan, dan membentuk tabel.

Saat ini, Anda tidak dapat mendelegasikanChoices. Anda Jika pembatasan ini menimbulkan masalah dalam aplikasi, tambahkan tabel luar sebagai sumber data, dan gunakan secara langsung.

Choices tidak mengharuskan nama kolom menjadi string dan diapit dalam tanda kutip ganda, tidak seperti fungsi ShowColumns, Search, dan tabel lainnya. Berikan rumus seolah-olah Anda mereferensi kolom secara langsung.

Referensi kolom harus langsung ke sumber data. Misalnya, jika sumber data adalah Akun dan pencariannya adalah SLA, referensi kolom akan berupa Accounts.SLA. Referensi tidak dapat melewati suatu fungsi, variabel, atau kontrol. Melanjutkan contoh ini, jika Akun menjadi umpan ke kontrol Galeri, gunakan rumus Gallery.Selected.SLA agar merujuk SLA untuk akun yang dipilih. Namun, referensi ini telah melewati kontrol sehingga tidak dapat diteruskan ke fungsi Kolom - Anda harus tetap menggunakan Accounts.SLA.

Untuk saat ini, Anda hanya dapat menggunakan kolom pencarian dengan SharePoint dan Microsoft Dataverse.

Sintaks

Choices( referensi kolom [, filter teks ] )

  • column-reference - Wajib. Kolom pencarian sumber data. Jangan mencantumkan nama kolom dalam tanda petik. Referensi harus langsung ke kolom sumber data dan tidak melewati suatu fungsi atau kontrol.
  • text-filter - Opsional. Memfilter daftar pilihan dengan hanya mengembalikan pilihan yang dimulai dengan teks yang ditentukan dalam text-filter. Jika string kosong ditentukan, semua pilihan akan dikembalikan.

Contoh

Choices untuk pencarian

  1. Buat database di, Dataverse dan pilih kotak Sertakan aplikasi dan data sampel.

    Banyak tabel, seperti Akun, dibuat.

    Catatan: Nama tabel berbentuk tunggal pada make.powerapps.com dan jamak dalam Power Apps Studio.

    Daftar sebagian bidang dari tabel Akun di Dataverse for Apps, yang menyorot bahwa

    Tabel Akun memiliki kolom Kontak Utama, yang merupakan pencarian ke tabel Kontak.

    Daftar sebagian bidang dari tabel Kontak di Dataverse.

    Untuk setiap akun, suatu kontak ditetapkan sebagai kontak utama, atau kontak utama kosong.

  2. Buat aplikasi dari tabel Akun .

  3. Dalam daftar layar dan kontrol di dekat ujung kiri, gulir ke bawah hingga EditScreen1 muncul, lalu pilih EditForm1 di bawahnya.

    Di bilah navigasi kiri, pilih EditForm1 di EditScreen1.

  4. Pada tab Properti panel kanan, pilih Edit bidang.

    Membuka panel Data.

  5. Di panel Bidang, pilih Tambah bidang.

  6. Cari bidang Kontak Utama, pilih kotak centang, lalu pilih Tambah.

    Memilih Akun untuk membuka Panel data.

    Bidang Kontak Utama akan muncul di bagian bawah formulir. Jika bidang menampilkan kesalahan, pilih Sumber data pada tab Tampilan, pilih elipsis (...) untuk sumber data Akun, lalu pilih Segarkan.

  7. (opsional) Seret bidang Kontak Utama dari bagian bawah ke bagian atas daftar bidang.

  8. Pada kartu untuk Kontak Utama, pilih kontrol Kotak kombo.

    Properti Item kontrol tersebut ditetapkan ke rumus yang mengidentifikasi kolom berdasarkan nama tampilannya, seperti pada contoh pertama, atau nama logis, seperti pada contoh kedua:

    • Choices( Accounts.'Primary Contact' )

    • Choices( Accounts.primarycontactid )

      Layar kanvas dengan kontrol formulir. Kontrol kotak Kombo dalam kartu Kontak Utama dipilih, dan properti Item dengan rumus Choices( Akun.'Kontak Utama' muncul.

  9. Untuk tujuan ilustrasi, kita dapat melihat tabel lengkap yang dikembalikan oleh Choices fungsi dalam kontrol tabel Data . Di tab Beranda, pilih Layar baru, lalu pilih Kosong.

  10. Di tab Sisipkan, pilih Data tabel.

  11. Atur properti Item dari kontrol Tabel data ke rumus ini:

    Choices( Accounts.'Primary Contact' )

  12. Di bagian tengah kontrol Tabel data, pilih tautan yang memulai Pilih bidang..., lalu pilih kotak centang untuk bidang yang ingin ditunjukkan (misalnya, firstname dan lastname).

    Layar kanvas dengan kontrol tabel data. Properti Item diatur ke rumus Choices( Akun.'Kontak Utama' ), dan tabel memperlihatkan kolom nama depan dan nama belakang untuk kumpulan rekaman pertama dari tabel Kontak.