Collect, Clear, dan ClearCollect fungsi

Function	Berlaku pada
Clear	Aplikasi Kanvas Desktop mengalir fungsi Power Platform CLI Dataverse
ClearCollect	Aplikasi Kanvas Desktop mengalir Power Platform CLI
Collect	Aplikasi Kanvas Desktop mengalirkan fungsi Power Platform CLI Dataverse aplikasi berbasis model

Membuat dan menghapus kumpulan dan menambahkan rekaman ke sumber data.

Collect

Fungsi ini 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.

Clear

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

Perhatikan bahwa Clear hanya beroperasi pada koleksi dan bukan 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.

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

ClearCollect

Fungsi menghapus ClearCollect semua rekaman dari koleksi. Kemudian menambahkan rangkaian rekaman yang berbeda ke kumpulan yang sama. Dengan satu fungsi, ClearCollect menawarkan kombinasi dan 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

Collect( 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.

Clear( 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:

Rumus	KETERANGAN	Hasil
ClearCollect( IceCream, { Flavor: "Strawberry", Kuantitas: 300 } )	Menghapus semua data dari kumpulan IceCream, kemudian menambahkan rekaman yang menyertakan jumlah es krim stroberi.	Kumpulan IceCream juga telah dimodifikasi.
Collect( IceCream, { Flavor: "Pistachio", Kuantitas: 40 }, { Flavor: "Orange", Kuantitas: 200 } )	Menambahkan dua rekaman ke kumpulan IceCream yang menyertakan jumlah es krim pistachio dan jeruk.	Kumpulan IceCream juga telah dimodifikasi.
Clear(IceCream)	Menghapus semua rekaman dari kumpulan IceCream.	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 ditangani Collect dan ClearCollect ditangani.

Rumus	KETERANGAN	Hasil
ClearCollect( IceCream, { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } )	Clear semua data lalu menambahkan dua rekaman ke koleksi IceCream yang mencakup jumlah cokelat dan es krim vanila. Rekaman yang akan ditambahkan disajikan sebagai argumen tunggal untuk fungsinya.	Kumpulan IceCream juga telah dimodifikasi.
ClearCollect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 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.	Kumpulan IceCream juga telah dimodifikasi.
ClearCollect(IceCream, { 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.	Kumpulan IceCream juga telah dimodifikasi.