Bagikan melalui

Memetakan bidang input komponen

  • Artikel

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 properti input dan output kustom pada komponen, lihat properti kustom dalam komponen.

Kolom peta

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

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

Rasa UnitPrice QuantitySold
Stroberi 1.99 20
Coklat 2.99 45

Properti input mengharapkan jenis data tabel:

Properti input kustom yang mengharapkan jenis data tabel.

Skema properti input terlihat seperti rumus berikut:

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

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

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

FlavorName Harga SaleNumber
Stroberi 1.99 20
Coklat 2.99 45

skema tabel IceCreams.

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 With() untuk memetakan satu rekaman.

Contohnya, 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, Harga, 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 yang dipetakan ke sumber data skema.

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

Animasi yang menampilkan pilihan rekaman dari galeri di atas mengubah teks instans komponen di bawah.

Tabel peta

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

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

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

Memetakan tabel menggunakan fungsi ForAll() untuk semua rekaman.

Peta menggunakan dropdown (tidak digunakan lagi)

Anda dapat menggunakan tab Tingkat Lanjut untuk komponen yang ditambahkan ke aplikasi yang mengharapkan properti input tabel atau jenis rekaman, dan memilih pemetaan bidang menggunakan pilihan 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 tingkat lanjut dari komponen yang ditambahkan ke aplikasi.

Metode untuk memilih pemetaan menggunakan dropdown ini telah tidak digunakan lagi. Sebagai gantinya, gunakan metode pemetaan kolom, rekaman, atau tabel seperti yang dijelaskan sebelumnya di 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 ditolak ini, buka Pengaturan > Fitur Mendatang > Dihentikan, dan pilih Bolehkan penetapan bidang otomatis untuk input komponen.

Pengaturan Izinkan penugasan bidang otomatis untuk 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