Fungsi AddColumns, DropColumns, RenameColumns, dan ShowColumns

Berlaku untuk: Aplikasi kanvas Alur desktop Aplikasi berdasarkan Power Platform model CLI

Membentuk tabel dengan menambahkan, mengecualikan, mengubah nama, dan memilih kolom nya.

**Fungsi ForAll juga dapat digunakan untuk membentuk tabel, dengan mengembalikan tabel rekaman baru yang dibuat dari kolom yang ada.

Gambaran Umum

Fungsi ini membentuk tabel dengan menyesuaikan kolomnya:

• Kurangi tabel yang berisi beberapa kolom menjadi satu kolom untuk digunakan dengan fungsi kolom tunggal, seperti Lower atau Sqrt.
• Tambahkan kolom terhitung ke tabel (misalnya, kolom Harga total yang menampilkan hasil mengalikan Kuantitas dengan Harga Satuan).
• Ubah nama kolom menjadi sesuatu yang lebih bermakna, untuk ditampilkan kepada pengguna atau untuk digunakan dalam formula.

Tabel adalah nilai dalam Power Apps, seperti string atau angka. Anda dapat menentukan tabel sebagai argumen dalam rumus, dan fungsi dapat mengembalikan tabel sebagai hasilnya.

Catatan

Fungsi yang dijelaskan topik ini tidak akan memodifikasi tabel asli. Sebagai gantinya, fungsi ini mengambil tabel sebagai argumen dan mengembalikan tabel baru dengan transformasi diterapkan. Untuk informasi selengkapnya, lihat bekerja dengan tabel.

Anda tidak dapat memodifikasi kolom sumber data menggunakan fungsi ini. Anda harus memodifikasi data pada sumbernya. Anda dapat menambahkan kolom ke kumpulan dengan fungsi Collect. Untuk informasi selengkapnya, lihat bekerja dengan sumber data.

Description

Fungsi AddColumns menambahkan kolom ke tabel, dan rumus mendefinisikan nilai pada kolom tersebut. Kolom yang ada tetap tidak dimodifikasi.

Rumus dievaluasi untuk setiap rekaman tabel.

Bidang rekaman yang sedang diproses tersedia dalam formula. Menggunakan operator ThisRecord atau hanya bidang referensi berdasarkan nama seperti nilai lainnya. Operator As juga dapat digunakan untuk menamai rekaman yang sedang diproses yang dapat membantu membuat formula lebih mudah dipahami dan membuat rekaman bersarang dapat diakses. Untuk informasi selengkapnya, lihat contoh di bawah ini dan menggunakan cakupan rekaman.

Fungsi DropColumns mengecualikan kolom dari tabel. Semua kolom lainnya tetap tidak dimodifikasi. DropColumns mengecualikan kolom, dan ShowColumns menyertakan kolom.

Gunakan fungsi RenameColumns untuk mengganti nama satu atau beberapa kolom dari tabel dengan memberikan setidaknya satu pasangan argumen yang menentukan nama kolom yang terdapat di tabel (nama lama, yang ingin Anda ganti) dan nama kolom yang tidak terdapat di tabel (nama baru, yang ingin Anda gunakan). Nama lama harus sudah ada dalam tabel, dan nama baru tidak boleh ada. Setiap nama kolom mungkin hanya muncul sekali dalam daftar argumen sebagai nama kolom lama atau nama kolom baru. Untuk mengubah nama kolom ke nama kolom yang ada, pertama kecualikan kolom yang ada dengan DropColumns, atau ubah nama kolom yang ada dengan menumpuk satu fungsi RenameColumns di dalam yang lain.

Fungsi ShowColumns menyertakan kolom pada tabel dan mengecualikan semua kolom lainnya. Anda dapat menggunakan ShowColumns untuk membuat tabel kolom tunggal dari tabel multi-kolom. ShowColumns menyertakan kolom, dan DropColumns mengecualikan kolom.

Untuk semua fungsi ini, hasilnya adalah tabel baru dengan transformasi diterapkan. Tabel asli tidak dimodifikasi. Anda tidak dapat memodifikasi tabel yang ada dengan rumus. SharePoint, Microsoft Dataverse, SQL Server, dan sumber data lainnya menyediakan alat untuk memodifikasi kolom daftar, tabel, dan tabel yang sering dirujuk sebagai skema. Fungsi dalam artikel ini hanya mengubah tabel input, tanpa memodifikasi aslinya, menjadi tabel output untuk digunakan lebih lanjut.

Argumen untuk fungsi ini mendukung delegasi. Misalnya, fungsi Filter yang digunakan sebagai argumen untuk menarik pencarian rekaman terkait melalui semua cantuman, meskipun sumber data '[dbo].[AllListings]' berisi jutaan baris:

AddColumns( RealEstateAgents,
   Listings,
   Filter(  '[dbo].[AllListings]', ListingAgentName = AgentName )
)

Namun, output dari fungsi ini tunduk pada batas rekaman non-delegasi. Dalam contoh ini, hanya 500 rekaman dikembalikan bahkan jika sumber data RealEstateAgents memiliki 501 atau lebih rekaman.

Jika Anda menggunakan AddColumns dengan cara ini, Filter harus melakukan panggilan terpisah ke sumber data untuk masing-masing rekaman pertama di RealEstateAgents, yang menyebabkan banyak obrolan jaringan. Jika[ dbo](.[AllListings] cukup kecil dan tidak sering berubah. Anda dapat memanggil fungsi Collect di OnStart untuk menyimpan sumber data dalam cache di aplikasi Anda saat dimulai. Sebagai alternatif, Anda dapat mengubah struktur aplikasi Anda sehingga Anda menarik rekaman terkait hanya ketika pengguna memintanya.

Catatan

Sebelum Power Apps versi 3.24042, nama kolom ditentukan dengan string teks menggunakan tanda kutip ganda, dan jika terhubung ke sumber data mereka juga harus menjadi nama logis. Misalnya, nama logis "cr43e_name" dengan tanda kutip ganda digunakan sebagai pengganti nama tampilan Nama tanpa tanda kutip. Untuk dan SharePoint sumber data Excel yang berisi nama kolom dengan spasi, setiap spasi ditentukan dengan "_x0020_", misalnya "Nama Kolom"sebagai "Column_x0020_Name". Setelah versi ini, semua aplikasi secara otomatis diperbarui ke sintaks baru yang dijelaskan dalam artikel ini.

Sintaks

AddColumns(Tabel,Nama Kolom1,Rumus1 [, Nama Kolom2,Rumus2 , ... ] )

• Tabel - Wajib. Tabel yang difungsikan.
• ColumnNames - Wajib. Nama kolom yang akan ditambahkan.
• Rumus- Wajib. Rumus untuk dievaluasi untuk setiap rekaman. Hasilnya ditambahkan sebagai nilai kolom baru yang sesuai. Anda dapat mereferensikan kolom lain di tabel dalam rumus ini.

DropColumns(Tabel,Nama Kolom1 [, Nama Kolom2, ... ] )

• Tabel - Wajib. Tabel yang difungsikan.
• ColumnNames - Wajib. Nama kolom yang akan dijatuhkan.

RenameColumns(Tabel,OldColumnName1,NewColumnName1 [, OldColumnName2,NewColumnName2 , ... ] )

• Tabel - Wajib. Tabel yang difungsikan.
• OldColumnNames - Wajib. Nama kolom yang akan diganti namanya dari tabel asli. Elemen ini muncul pertama di pasangan argumen (atau pertama di setiap pasangan argumen jika rumusnya mencakup lebih dari satu pasangan).
• NewColumnNames - Wajib. Nama pengganti. Elemen ini muncul terakhir di pasangan argumen (atau terakhir di setiap pasangan argumen jika rumusnya mencakup lebih dari satu pasangan).

Tampilkan Kolom( Tabel,Nama Kolom1[ , Nama Kolom2, ... ] )

• Tabel - Wajib. Tabel yang difungsikan.
• ColumnNames - Wajib. Nama kolom yang akan disertakan.

Contoh

Contoh di bagian ini menggunakan sumber data IceCreamSales, yang berisi data dalam tabel ini:

Tidak satu pun dari contoh ini memodifikasi sumber data IceCreamSales. Setiap fungsi mentransformasi nilai sumber data sebagai tabel dan mengembalikan nilai sebagai hasilnya.

Rumus	Description	Hasil
AddColumns( IceCreamSales, Revenue, UnitPrice * QuantitySold )	Menambahkan kolom Pendapatan ke hasil. Untuk setiap rekaman, UnitPrice * QuantitySold dievaluasi, dan hasilnya ditempatkan pada kolom baru.
DropColumns(Penjualan Es Krim, Harga Satuan)	Mengecualikan kolom UnitPrice dari hasil. Gunakan fungsi ini untuk mengecualikan kolom, dan menggunakan ShowColumns untuk menyertakannya.
ShowColumns(Penjualan Es Krim, Rasa)	Hanya menyertakan kolom Flavor pada hasilnya. Gunakan fungsi ini untuk menyertakan kolom, dan menggunakan DropColumns untuk mengecualikannya.
RenameColumns(IceCreamSales, UnitPrice, Price)	Mengganti nama kolom UnitPrice dalam hasil.
RenameColumns(IceCreamSales, UnitPrice, Price, QuantitySold, Number)	Mengganti nama kolom UnitPrice dan QuantitySold dalam hasil.
DropColumns( RenameColumns( AddColumns( IceCreamPenjualan, Pendapatan, UnitPrice * QuantitySold ), Harga Unit, Harga), Kuantitas)	Melakukan transformasi tabel berikut secara berurutan, mulai dari bagian dalam rumus: Menambahkan kolom Pendapatan berdasarkan perhitungan per rekaman Harga Satuan * Kuantitas. Mengganti nama UnitPrice menjadi Price. Mengecualikan kolom Quantity. Pesanan itu penting, misalnya kita tidak dapat menghitung dengan UnitPrice setelah diganti namanya.

Langkah demi langkah

Mari kita coba beberapa contoh dari sebelumnya di artikel ini.

1. Buat kumpulan dengan menambahkan kontrol Tombol dan mengatur properti OnSelect-nya ke rumus ini:

   ClearCollect( IceCreamSales,
      Table(
          { Flavor: "Strawberry", UnitPrice: 1.99, QuantitySold: 20 },
          { Flavor: "Chocolate", UnitPrice: 2.99, QuantitySold: 45 },
          { Flavor: "Vanilla", UnitPrice: 1.50, QuantitySold: 35 }
      )
   )
   

2. Jalankan rumus dengan memilih tombol sambil menahan tombol Alt.

3. Tambahkan kontrol Tombol kedua dan atur properti OnSelect-nya ke rumus ini, lalu jalankan:

   ClearCollect( FirstExample,
      AddColumns( IceCreamSales, Revenue, UnitPrice * QuantitySold )
   )
   

4. Pada menu File, pilih Kumpulan, lalu pilih IceCreamSales untuk menampilkan kumpulan tersebut.

   Seperti yang ditunjukkan grafis ini, rumus kedua tidak memodifikasi kumpulan ini. Fungsi AddColumns yang menggunakan IceCreamSales sebagai argumen hanya baca; fungsi ini tidak memodifikasi tabel yang dirujuk argumen tersebut.

   

5. Pilih FirstExample.

   Seperti yang ditunjukkan grafis ini, rumus kedua mengembalikan tabel baru dengan kolom tambahan. Fungsi ClearCollect mengambil tabel baru dalam koleksi FirstExample, menambahkan sesuatu ke tabel asli saat diteruskan melalui fungsi tanpa memodifikasi sumber:

   

Memetakan kolom dalam komponen

Lihat Petakan kolom.