Bagikan melalui

Fungsi Collect, Clear, dan ClearCollect

  • Artikel

Membuat dan menghapus kumpulan dan menambahkan rekaman ke sumber data.

Collect

Berlaku untuk: Aplikasi kanvas Kartu Dataverse low-code plug-in Power Platform CLI Desktop alur

Fungsi Collect menambahkan rekaman ke sumber data. Item yang ditambahkan dapat berupa:

  • Nilai tunggal: Nilai ditempatkan di bidang Value rekaman baru. Semua properti lainnya dibiarkan blank.
  • Rekaman: Setiap properti bernama ditempatkan di properti rekaman baru yang sesuai. Semua properti lainnya dibiarkan kosong.
  • Tabel: Setiap rekaman tabel ditambahkan sebagai rekaman sumber data terpisah sebagaimana dijelaskan di atas. Tabel tidak ditambahkan sebagai tabel bertumpuk ke rekaman. Untuk melakukannya, bungkus tabel di rekaman terlebih dulu.

Jika digunakan bersama kumpulan, kolom tambahan akan dibuat sesuai kebutuhan. Kolom untuk sumber data lain ditetapkan oleh sumber data dan kolom baru tidak dapat ditambahkan.

Jika sumber data belum ada, kumpulan akan dibuat.

Kumpulan terkadang digunakan untuk menahan variabel global atau membuat salinan sementara sumber data. Aplikasi kanvas didasarkan pada rumus yang secara otomatis menghitung ulang saat pengguna berinteraksi dengan aplikasi. Kumpulan tidak mendapatkan manfaat ini dan penggunaannya dapat membuat aplikasi Anda lebih sulit dibuat dan dimengerti. Sebelum menggunakan kumpulan dengan cara ini, tinjau bekerja dengan variabel.

Anda juga dapat menggunakan fungsi Patch untuk membuat rekaman di sumber data.

Collect mengembalikan sumber data yang dimodifikasi sebagai tabel. Collect hanya dapat digunakan dalam rumus perilaku.

Hapus

Berlaku untuk: Aplikasi kanvas

Fungsi Clear akan menghapus semua rekaman kumpulan. Kolom kumpulan akan tetap ada.

Perlu diingat, Hapus hanya berfungsi pada kumpulan dan bukan pada sumber data lainnya. Anda dapat menggunakan RemoveIf( DataSource, benar) untuk tujuan ini. Anda harus berhati-hati karena tindakan ini akan menghapus semua rekaman dari penyimpanan sumber data dan dapat memengaruhi pengguna lain.

Anda dapat menggunakan fungsi Remove untuk menghapus rekaman sesuai pilihan Anda.

Hapus tidak memiliki nilai pengembalian. Fungsi ini hanya dapat digunakan dalam rumus perilaku.

ClearCollect

Berlaku untuk: Aplikasi kanvas Aplikasi berdasarkan model

Fungsi ClearCollect akan menghapus semua rekaman dari suatu kumpulan. Kemudian menambahkan rangkaian rekaman yang berbeda ke kumpulan yang sama. Dengan suatu fungsi, ClearCollect menawarkan kombinasi Clear, kemudian Collect.

ClearCollect mengembalikan koleksi yang dimodifikasi sebagai tabel. ClearCollect hanya dapat digunakan dalam rumus perilaku.

Delegasi

Saat digunakan dengan sumber data, fungsi-fungsi ini tidak dapat didelegasikan. Hanya bagian pertama sumber data yang akan diambil, lalu fungsi diterapkan. Hasilnya mungkin tidak menunjukkan gambaran lengkapnya. Peringatan dapat muncul pada waktu penulisan untuk mengingatkan Anda akan batasan ini, serta untuk menyarankan pengalihan ke alternatif yang dapat didelegasikan, jika memungkinkan. Untuk informasi lebih lanjut, lihat ikhtisar delegasi.

Sintaks

Kumpulkan( Sumber Data, Item , ... )

  • Sumber Data– Wajib. Sumber data yang menjadi tujuan data akan ditambahkan. Jika sumber data belum ada, kumpulan baru akan dibuat.
  • Item - Wajib. Satu atau beberapa rekaman atau tabel yang akan ditambahkan ke sumber data.

Jelas( Koleksi )

  • Koleksi – Wajib. Kumpulan yang ingin Anda hapus.

ClearCollect(Koleksi, Item , ... )

  • Koleksi – Wajib. Kumpulan yang ingin Anda hapus, dan selanjutnya ditambahkan data.
  • Item - Wajib. Satu atau beberapa rekaman atau tabel yang akan ditambahkan ke sumber data.

Contoh

Menghapus dan menambahkan rekaman ke sumber data

Dalam contoh ini, Anda akan menghapus dan menambahkan data ke kumpulan bernama IceCream. Sumber data diawali dengan konten berikut:

Sumber data sampel.

Rumus KETERANGAN Hasil
ClearCollect( Es Krim, { Rasa: "Stroberi", Kuantitas: 300 } ) Menghapus semua data dari kumpulan IceCream, kemudian menambahkan rekaman yang menyertakan jumlah es krim stroberi. Tabel dengan satu catatan.

Kumpulan IceCream juga telah dimodifikasi.
Kumpulkan (Es Krim, { Rasa: "Pistachio", Jumlah: 40 }, Rasa { : "Jeruk", Jumlah: 200 } ) Menambahkan dua rekaman ke kumpulan IceCream yang menyertakan jumlah es krim pistachio dan jeruk. Tabel dengan dua catatan.

Kumpulan IceCream juga telah dimodifikasi.
Clear ( Es Krim ) Menghapus semua rekaman dari kumpulan IceCream. Meja kosong.

Kumpulan IceCream juga telah dimodifikasi.

Untuk contoh langkah demi langkah tentang cara membuat kumpulan, lihat Membuat dan memperbarui kumpulan.

Rekaman dan tabel

Contoh-contoh ini memeriksa bagaimana argumen rekaman dan tabel untuk Collect dan ClearCollect ditangani.

Rumus KETERANGAN Hasil
ClearCollect(IceCream, { Rasa: "Cokelat", Jumlah: 100 }, Rasa { : "Vanilla", Kuantitas: 200 } ) Menghapus semua data lalu menambahkan dua rekaman ke kumpulan IceCream yang menyertakan jumlah es krim cokelat dan vanila. Rekaman yang akan ditambahkan disajikan sebagai argumen tunggal untuk fungsinya. Rekaman cokelat dan vanila ditambahkan ke koleksi.

Kumpulan IceCream juga telah dimodifikasi.
ClearCollect( Es Krim, Meja ( { Rasa: "Cokelat", Jumlah: 100 }, Rasa { : "Vanilla", Kuantitas: 200 } ) ) Sama seperti contoh sebelumnya kecuali rekaman digabungkan dalam tabel dan diteruskan melalui satu argumen. Konten tabel adalah rekaman yang diekstrak berdasarkan rekaman sebelum ditambahkan ke kumpulan IceCream. Rekaman cokelat dan vanila ditambahkan ke koleksi dan dimodifikasi.

Kumpulan IceCream juga telah dimodifikasi.
ClearCollect(Es Krim,
{ MyFavorites: Table( { Rasa: "Cokelat", jumlah: 100 }, { Rasa: "Vanila", Jumlah: 200 } ) } )		 Sama seperti contoh sebelumnya kecuali tabel dibungkus dalam rekaman. Rekaman tabel tidak diekstrak dan sebaliknya, seluruh tabel ditambahkan sebagai sel rekaman. Rekaman cokelat dan vanila ditambahkan ke koleksi yang dimodifikasi dengan meja yang dibungkus dalam rekaman.

Kumpulan IceCream juga telah dimodifikasi.