Memetakan bidang input komponen

Komponen dapat menerima nilai input untuk memancarkan atau memproses data dengan properti input kustom. Di artikel ini, Anda akan mempelajari tentang cara menggunakan komponen tersebut yang memengaruhi satu atau beberapa properti input dengan skema tertentu untuk tabel atau rekaman tertentu, dan cara memetakan bidang input komponen ke kolom sumber data.

Tip

Untuk mempelajari tentang apa properti input dan output kustom dalam komponen, lihat Properti kustom dalam komponen.

Kolom peta

Gunakan fungsi RenameColumns() untuk mengganti nama satu atau beberapa kolom tabel agar sesuai dengan skema properti input untuk pemilihan kolom input.

Contohnya, pertimbangkan komponen yang memperkirakan input tabel dengan format berikut:

Rasa Harga satuan KuantitasTerjual
Stroberi 1.99 20
Coklat 2.99 45

Properti input mengharapkan jenis data tabel:

Properti input kustom mengharapkan jenis data Tabel.

Skema properti input terlihat seperti rumus berikut:

Table({Flavor: "Strawberry",UnitPrice: 1.99, QuantitySold:20})

Rumus properti input kustom didefinisikan sebagai nilai tabel dan sampel.

Aplikasi yang menggunakan komponen ini memiliki tabel IceCreams berikut yang tidak cocok dengan skema komponen:

Nama Rasa Harga Nomor Penjualan
Stroberi 1.99 20
Coklat 2.99 45

Skema tabel Es Krim.

Untuk memetakan bidang yang benar, gunakan fungsi RenameColumn() untuk mengganti nama kolom yang diharapkan.

RenameColumns(IceCreams,"cra56_flavorname","Flavor","cra56_price","UnitPrice","cra56_salenumber","QuantitySold")

Aplikasi menggunakan komponen yang menggunakan pemetaan properti input kustom dengan kolom yang benar menggunakan fungsi RenameColumns.

Bidang input yang diharapkan komponen sekarang dipetakan dengan kolom yang cocok dari kolom sumber data.

Petakan data kasus

Gunakan fungsi With() untuk memetakan satu rekaman.

Misalnya, melanjutkan dari contoh sebelumnya untuk kolom pemetaan, properti input kustom komponen di dalam aplikasi mengharapkan jenis rekaman dengan skema berikut:

{Flavor: "Strawberry",UnitPrice: 1.99, QuantitySold: 20}

Rumus properti input kustom yang didefinisikan sebagai nilai rekaman dan sampel.

Karena sumber data IceCreams mengharapkan nama kolom sebagai FlavorName,Price, dan SaleNumber, kita harus mengubah pemetaan untuk rekaman setelah komponen ditambahkan ke aplikasi.

Gunakan fungsi With() untuk memilih kolom tabel IceCreams , dan memetakannya ke bidang input komponen:

With(Gallery3.Selected,{Flavor:FlavorName,UnitPrice:Price,QuantitySold:SaleNumber})

Rekaman komponen dalam aplikasi dipetakan ke skema sumber data.

Animasi berikut menampilkan contoh komponen yang ditambahkan ke aplikasi yang menampilkan rekaman yang dipilih dari galeri (di atas komponen):

Animasi yang menunjukkan pemilihan rekaman dari galeri di atas mengubah teks instans komponen di bawah ini.

Tabel peta

Gunakan ForAll() untuk memetakan tabel rekaman dengan rekaman yang diharapkan oleh komponen yang ditambahkan ke aplikasi.

Misalnya, di akhir contoh kolom peta, Anda dapat menggunakan fungsi ForAll() untuk memetakan seluruh tabel dengan kolom tertentu untuk menunjuk ke bidang dari komponen untuk setiap baris:

ForAll(IceCreams,{Flavor:FlavorName,UnitPrice:Price,QuantitySold:SaleNumber})

Petakan tabel menggunakan fungsi ForAll() untuk semua catatan.

Peta menggunakan dropdown (tidak digunakan lagi)

Anda dapat menggunakan tab Lanjutan untuk komponen yang ditambahkan ke aplikasi yang mengharapkan properti input dari jenis tabel atau rekaman, dan memilih pemetaan bidang menggunakan opsi dropdown. Pemetaan ini ditetapkan secara default, dan kecuali Anda memilih bidang pemetaan yang sesuai secara manual, pemetaan mungkin tidak menghasilkan hasil yang diharapkan.

Contohnya, animasi berikut menampilkan rumus yang sedang diperbarui untuk mengganti nama kolom. Komponen pada layar tidak mengubah pemetaan bidang karena pilihan bidang default menggunakan dropdown ini harus diperbarui secara manual.

Metode yang tidak digunakan lagi untuk memilih pemetaan bidang menggunakan dropdown di bagian properti lanjutan dari komponen yang ditambahkan ke aplikasi.

Metode memilih pemetaan menggunakan dropdown ini tidak digunakan lagi. Sebagai gantinya, gunakan metode pemetaan kolom, rekaman, atau tabel seperti yang dijelaskan sebelumnya dalam artikel ini.

Anda tetap dapat menggunakan pilihan dropdown untuk memilih pemetaan untuk aplikasi yang ada, namun tidak disarankan. Untuk aplikasi baru, pilihan ini tidak akan tersedia secara default. Untuk mengaktifkan atau menonaktifkan kemampuan yang tidak digunakan lagi ini, buka Pengaturan>Fitur>Mendatang Dihentikan, dan pilih Izinkan penetapan bidang otomatis untuk input komponen.

Izinkan penetapan bidang otomatis untuk pengaturan input komponen.

Saat mengaktifkan pengaturan, pastikan Anda menyimpan dan membuka kembali aplikasi dalam Power Apps Studio. Setelah dibuka kembali, perbarui rumus properti input untuk memicu validasi rumus sehingga pilihan dropdown mulai muncul di panel Properti tingkat lanjut.

Baca juga

  • Last updated on