Fungsi Collect, Clear dan ClearCollect

Cipta dan kosongkan koleksi dan tambah rekod kepada sebarang sumber data.

Collect

Digunakan untuk: Aplikasi kanvas Kad Dataverse pemalam Power Platform kod asas CLI Aliran Desktop

Fungsi Collect menambah rekod kepada sumber data. Item yang akan ditambah adalah:

• Nilai tunggal: Nilai diletakkan dalam medan Nilai rekod baharu. Semua sifat lain ditinggalkan blank.
• Rekod: Setiap sifat yang dinamakan diletakkan dalam sifat rekod baharu yang sepadan. Semua sifat lain ditinggalkan kosong.
• Jadual: Setiap rekod jadual ditambahkan sebagai rekod yang berasingan daripada sumber data seperti yang diterangkan di atas. Jadual tidak ditambahkan sebagai jadual bersarang kepada rekod. Untuk melakukan ini, kemaskan jadual dalam rekod terlebih dahulu.

Apabila digunakan dengan koleksi, tambahan lajur akan dicipta mengikut keperluan. Lajur untuk sumber data lain diperbaiki oleh sumber data dan lajur baharu tidak boleh ditambahkan.

Jika sumber data belum wujud, koleksi akan dicipta.

Koleksi kadang-kadang digunakan untuk menyimpan pemboleh ubah global atau membuat salinan sementara sumber data. Aplikasi kanvas berdasarkan pada formula yang dikira semula secara automatik semasa pengguna berinteraksi dengan aplikasi. Koleksi tidak menikmati faedah ini dan penggunaannya boleh menjadikan aplikasi anda lebih sukar untuk dicipta dan difahami. Sebelum menggunakan koleksi dengan cara ini, semak kerja dengan pemboleh ubah.

Anda juga boleh menggunakan fungsi Patch untuk mencipta rekod dalam sumber data.

Kumpulkan mengembalikan sumber data yang diubah suai sebagai jadual. Kumpulkan hanya boleh digunakan dalam formula tingkah laku.

Clear

Digunakan untuk: Apl kanvas

Fungsi Clear memadam semua rekod koleksi. Lajur koleksi akan kekal.

Perhatikan bahawa Clear hanya beroperasi pada koleksi dan bukan sumber data lain. Anda boleh menggunakan RemoveIf( DataSource, benar) untuk tujuan ini. Berhati-hati kerana ini akan mengalih keluar semua rekod dari storan sumber data dan boleh mempengaruhi pengguna lain.

Anda boleh menggunakan fungsi Remove untuk membuang rekod secara selektif.

Jelas tidak mempunyai nilai pulangan. Ia hanya boleh digunakan dalam formula tingkah laku.

ClearCollect

Digunakan untuk: Aplikasi kanvas Aplikasi dipacu model

Fungsi ClearCollect memadam semua rekod dari koleksi. Dan kemudian menambah set rekod yang berbeza dengan koleksi yang sama. Dengan fungsi tunggal, ClearCollect menawarkan gabungan Clear dan kemudian Collect.

ClearCollect mengembalikan koleksi yang diubah suai sebagai jadual. ClearCollect hanya boleh digunakan dalam formula tingkah laku.

Perwakilan

Apabila digunakan dengan sumber data, fungsi ini tidak boleh ditugaskan. Bahagian pertama sumber data sahaja yang akan diambil, kemudian fungsi ini digunakan. Hasil ini mungkin tidak mewakili gambaran yang lengkap. Amaran mungkin terpapar semasa mengarang untuk mengingatkan anda tentang had ini dan mencadangkan agar beralih kepada alternatif boleh ditugaskan jika boleh. Untuk mendapatkan maklumat lanjut, rujuk ikhtisar penugasan.

Sintaks

Kumpulkan( Sumber Data, Item, ... )

• Sumber Data– Diperlukan. Sumber data yang anda mahu menambahkan data. Jika ia tidak wujud, koleksi baharu akan dicipta.
• Item - Diperlukan. Satu atau lebih rekod atau jadual untuk ditambahkan pada sumber data.

Jelas( Koleksi )

• Koleksi – Diperlukan. Koleksi yang ingin anda kosongkan.

ClearCollect(Koleksi, Item , ... )

• Koleksi – Diperlukan. Koleksi yang ingin anda kosongkan dan kemudian tambahkan data.
• Item - Diperlukan. Satu atau lebih rekod atau jadual untuk ditambahkan pada sumber data.

Contoh

Mengosongkan dan menambahkan rekod kepada sumber data

Dalam contoh ini, anda akan memadamkan dan menambahkan koleksi yang dinamakan Ais Krim. Sumber data bermula dengan kandungan ini:

Formula	Penerangan	Hasil
ClearCollect( Ais Krim, { Rasa: "Strawberi", Kuantiti: 300 } )	Kosongkan semua data dari koleksi Ais Krim dan kemudian menambahkan rekod yang termasuk kuantiti ais krim strawberi.	Koleksi Ais Krim juga telah diubah suai.
Kumpulkan ( Ais Krim, { Perisa: "Pistachio", Kuantiti: 40 }, Perisa { : "Oren", Kuantiti: 200 } )	Menambah dua rekod kepada koleksi Ais Krim yang termasuk kuantiti ais krim pistasio dan oren.	Koleksi Ais Krim juga telah diubah suai.
Clear ( Ais Krim )	Alih keluar semua rekod dari koleksi Ais Krim.	Koleksi Ais Krim juga telah diubah suai.

Untuk contoh langkah demi langkah bagi cara mencipta koleksi, lihat Cipta dan kemas kini koleksi.

Rekod dan jadual

Contoh ini memeriksa cara rekod dan jadual argumen untuk Collect dan ClearCollect akan dikendalikan.

Formula	Penerangan	Hasil
ClearCollect( Ais Krim, { Perisa: "Coklat", Kuantiti: 100 }, { Perisa: "Vanilla", Kuantiti: 200 } )	Kosongkan semua data dan kemudian tambahkan dua rekod kepada koleksi Ais Krim yang termasuk kuantiti ais krim coklat dan vanila. Rekod yang akan ditambahkan disediakan sebagai argumen individu untuk fungsi itu.	Koleksi Ais Krim juga telah diubah suai.
ClearCollect( Ais Krim, Jadual ( { Perisa: "Coklat", Kuantiti: 100 }, Perisa { : "Vanilla", Kuantiti: 200 } ) )	Sama seperti contoh sebelum kecuali rekod digabungkan dalam jadual dan diluluskan masuk melalui satu argumen. Kandungan jadual diekstrak oleh rekod mengikut rekod sebelum ditambahkan kepada koleksi Ais Krim.	Koleksi Ais Krim juga telah diubah suai.
ClearCollect( Ais Krim, { MyFavorites: Table( { Perisa: "Coklat", Kuantiti: 100 }, { Perisa: "Vanila", Kuantiti: 200 } ) } )	Sama seperti contoh sebelum kecuali jadual dikemaskan dalam rekod. Rekod jadual tidak diekstrak dan sebaliknya keseluruhan jadual ditambahkan sebagai sel rekod.	Koleksi Ais Krim juga telah diubah suai.