AddColumns, DropColumns, RenameColumnsve ShowColumns işlevleri

Şunlar için geçerlidir: Tuval uygulamaları Copilot Studio Desktop akışları Model temelli uygulamalar Power Platform CLI Dataverse işlevleri

Tablo veya kaydısütunlarını ekleyerek, bırakarak, yeniden adlandırarak ve seçerek şekillendirir.

ForAll işlevi, varolan sütunlardan oluşturulan yeni kayıtların bir tablosunu döndürerek tabloyu şekillendirmek için de kullanılabilir.

Genel bakış

Bu işlevler, sütunlarını ayarlayarak bir tabloyu veya kaydı şekillendiriyor:

• Birden çok sütun içeren bir tabloyu veya kaydı , Lower veya Sqrt gibi tek sütunlu işlevlerle kullanmak üzere tek bir sütuna küçültün.
• Tabloya veya kayda hesaplanan sütun ekleyin (örneğin, Miktar ile Birim Fiyat çarpımının sonuçlarını gösteren bir ToplamFiyat sütunu).
• Kullanıcılara göstermek veya formüllerde kullanmak için daha anlamlı olacak şekilde sütunu yeniden adlandırın.

Power Apps'te tablo, tıpkı dize veya sayı gibi bir değerdir. Formülde tabloyu bir bağımsız değişken olarak belirtebilirsiniz ve işlevler tabloyu sonuç olarak döndürebilir.

Not

Bu konu başlığında açıklanan işlevler özgün tabloyu değiştirmez. Bunun yerine, tabloyu bir bağımsız değişken olarak kabul edip dönüştürme uygulanmış yeni bir tablo döndürür. Daha fazla bilgi için bkz. Tablolarla çalışma.

Bu işlevleri kullanarak bir veri kaynağının sütunlarını değiştiremezsiniz. Veriyi kaynağında değiştirmelisiniz. Collect işlevini kullanarak bir koleksiyona sütun ekleyebilirsiniz. Daha fazla bilgi için bkz. Veri kaynaklarıyla çalışma.

Description

İşlev, AddColumns tabloya veya kayda sütun ekler ve formül bu sütundaki değerleri tanımlar. Mevcut sütunlar değiştirilmemiş olarak kalır.

Formül, sağlanan kayıt veya sağlanan tablonun her kaydı için değerlendirilir.

İşlenmekte olan kayıt alanları formül içinde bulunur. ThisRecord işlecini kullanın veya başka bir değere olduğu gibi yalnızca adla başvuruda bulunun. As işleci, formülünüzü daha anlaşılır ve iç içe geçmiş kayıtları erişilebilir hale getirmenizi kolaylaştıracak şekilde, işlenen kaydı adlandırmak için de kullanılabilir. Daha fazla bilgi için aşağıdaki örneklere ve kayıt kapsamıyla çalışma bölümüne bakın.

İşlev, DropColumns sütunları bir tablo veya kayıttan dışlar. Diğer tüm sütunlar değiştirilmemiş olarak kalır. DropColumns sütunları dışlar ve ShowColumns sütunları içerir.

Tablo veya kaydın RenameColumns içerdiği bir sütunun adını (değiştirmek istediğiniz eski ad) ve tablo veya kaydın içermediği bir sütunun adını (yeni ad, kullanmak istediğiniz). Eski adın tablo veya kayıtta zaten mevcut olması ve yeni adın mevcut olmaması gerekir. Her sütun adı, bağımsız değişken listesinde yalnızca bir kez eski bir sütun adı veya yeni bir sütun adı olarak görünebilir. Bir sütunu var olan bir sütun adıyla yeniden adlandırmak için, önce mevcut sütunu ile DropColumnsbırakın veya bir işlevi başka bir RenameColumns işlevin içine yerleştirerek var olan sütunu aradan çıkararak yeniden adlandırın.

işlevi ShowColumns bir tablo veya kaydın sütunlarını içerir ve diğer tüm sütunları bırakır. Çok sütunlu bir tablo veya kayıttan tek sütunlu bir tablo veya kayıt oluşturmak için kullanabilirsiniz ShowColumns . ShowColumns sütunları içerir ve DropColumns sütunları dışlar.

Tüm bu işlevler için sonuç, dönüşüm uygulanmış yeni bir tablo veya kayıttır. Özgün tablo veya kayıt değiştirilmez. Var olan bir tabloyu veya kaydı formülle değiştiremezsiniz. SharePoint, Microsoft Dataverse, SQL Server ve diğer veri kaynakları, genellikle şema olarak adlandırılan liste ve tablo sütunlarını değiştirmeye yönelik araçlar sağlar. Bu konudaki işlevler, özgün tabloyu değiştirmeden yalnızca giriş tablosunu veya kaydını daha fazla kullanım için bir çıkış tablosuna veya kayda dönüştürür.

Bu işlevlerin bağımsız değişkenleri, temsilci atamayı destekler. Örneğin, '[dbo].[AllListings]' veri kaynağı bir milyon satır içerse bile bir Filter işlevi tüm listelerde arama yaparak ilgili kayıtları çekmek için bağımsız değişken olarak kullanılır:

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

Ancak bu işlevlerin çıkışı temsilci olmayan kayıt sınırına tabidir. Bu örnekte, RealEstateAgents veri kaynağında 501 veya daha fazla kayıt olsa bile yalnızca 500 kayıt döndürülür.

Bu şekilde kullanıyorsanız AddColumns,Filter,RealEstateAgents'taki bu ilk kayıtların her biri için veri kaynağına ayrı çağrılar yapmalıdır ve bu da çok fazla ağ sohbetine neden olur. [dbo](.[AllListings] yeterince küçükse ve sık sık değişmiyorsa. Uygulamanız başlatıldığında veri kaynağını önbelleğe almak için OnStart'ta Collect işlevini çağırabilirsiniz. Alternatif olarak, uygulamanızı yalnızca kullanıcı istediği zaman ilgili kayıtları alacak şekilde yeniden yapılandırabilirsiniz.

Not

3.24042 sürümünden önce Power Apps'te, sütun adları çift tırnak kullanılarak metin dizesiyle belirtilirdi ve bir veri kaynağına bağlıysa bunların ayrıca mantıksal adlar olması da gerekiyordu. Örneğin, çift tırnaklı "cr43e_name" mantıksal adı, tırnaklar olmadan Ad görünen adının yerine kullanılıyordu. Boşluklar bulunan sütun adlarını içeren SharePoint ve Excel veri kaynakları için her boşluk, "_x0020_" ile belirtilirdi: Örneğin, "Sütun Adı", "Sütun_x0020_Adı" olarak. Bu sürümden sonra tüm uygulamalar bu makalede açıklanan yeni sözdizimi şeklinde otomatik olarak güncelleştirildi.

Sözdizimi

AddColumns( TableOrRecord, ColumnName1, Formül1 [, ColumnName2, Formül2, ... ] )

• TableOrRecord - Gerekli. Üzerinde çalışacak tablo veya kayıt.
• ColumnNames - Gerekli. Eklenecek sütunların adları.
• Formüller - Gerekli. Her bir kayıt için değerlendirilecek formüller. Sonuç, karşılık gelen yeni sütunun değeri olarak eklenir. Bu formülde tablonun veya kaydın diğer sütunlarına başvurabilirsiniz.

DropColumns( TableOrRecord, ColumnName1 [, ColumnName2, ... ] )

• TableOrRecord - Gerekli. Üzerinde çalışacak tablo veya kayıt.
• ColumnNames - Gerekli. Dışlanacak sütunların adları.

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

• TableOrRecord - Gerekli. Üzerinde çalışacak tablo veya kayıt.
• OldColumnNames - Gerekli. Özgün tablo veya kayıttan yeniden adlandıracak sütunların adları. Bu öğe, bağımsız değişken çiftinde (veya formülde birden fazla bağımsız değişken çifti varsa her bağımsız değişken çiftinde) ilk olarak görünür.
• NewColumnNames - Gerekli. Yerini alacak adlar. Bu öğe, bağımsız değişken çiftinde (veya formülde birden fazla bağımsız değişken çifti varsa her bağımsız değişken çiftinde) en son görünür.

ShowColumns( TableOrRecord, ColumnName1 [, ColumnName2, ... ] )

• TableOrRecord - Gerekli. Üzerinde çalışacak tablo veya kayıt.
• ColumnNames - Gerekli. Dahil edilecek sütunların adları.

Örnekler

Bu bölümdeki örneklerde, bu tablodaki verileri içeren IceCreamSales veri kaynağı kullanılır:

Bu örneklerin hiçbiri IceCreamSales veri kaynağını değiştirmez. Her bir işlev, tablo olarak veri kaynağı değerini dönüştürür ve bu değeri sonuç şeklinde döndürür.

Formül	Description	Result
AddColumns( IceCreamSales, Revenue, UnitPrice * QuantitySold )	Sonuca Gelir sütunu ekler. Her kayıt için UnitPrice * QuantitySold değerlendirilir ve sonuç yeni bir sütunda verilir.
DropColumns( IceCreamSales, UnitPrice )	UnitPrice sütununu sonuçtan dışlar. Sütunları dışlamak için bu işlevi kullanın ve bunları dahil etmek için kullanın ShowColumns .
ShowColumns( IceCreamSales, Flavor )	Yalnızca Aroma sütununu sonuca ekler. Bu işlevi sütunları dahil etmek için kullanın ve bunları dışlamak için kullanın DropColumns .
RenameColumns( IceCreamSales, UnitPrice, Price)	Sonuçta UnitPrice sütununu yeniden adlandırır.
RenameColumns( IceCreamSales, UnitPrice, Price, QuantitySold, Number)	UnitPrice ve QuantitySold sütunlarını yeniden adlandırır.
DropColumns( RenameColumns( AddColumns( IceCreamSales, Revenue, UnitPrice * QuantitySold ), UnitPrice, Price ), Miktar )	Formülün içinden başlayarak sırasıyla aşağıdaki tablo dönüştürmelerini gerçekleştirir: Kayıt başına UnitPrice * Miktar hesaplamasına göre Gelir sütununu ekler. UnitPrice sütununu Fiyat olarak yeniden adlandırır. Miktar sütununu dışlar. Sıra önemlidir. Örneğin, UnitPrice yeniden adlandırıldıktan sonra bununla hesaplama yapamayız.

Adım adım

Bu makalenin önceki bölümlerinden bazı örnekleri deneyelim.

1. Button denetimi ekleyerek ve OnSelect özelliğini aşağıdaki formüle ayarlayarak bir koleksiyon oluşturun:

   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. Alt tuşunu basılı tutarken düğmeyi seçerek formülü çalıştırın.

3. İkinci bir Button denetimi ekleyin, OnSelect özelliğini bu formüle ayarlayın ve çalıştırın:

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

4. Oluşturduğunuz koleksiyonu göstermek için Dosya menüsünde Koleksiyonlar'ı ve ardından IceCreamSales'nı seçin.

   Bu grafikte görüldüğü gibi ikinci formül, bu koleksiyonu değiştirmedi. AddColumns İşlev salt okunur bağımsız değişken olarak IceCreamSales kullandı; işlev bu bağımsız değişkenin başvurduğu tabloyu değiştirmedi.

   

5. FirstExample öğesini seçin.

   Bu grafikte görüldüğü gibi ikinci formül, eklenen sütunu içeren yeni bir tablo döndürdü. ClearCollect işlevi, FirstExample koleksiyonundaki yeni tabloyu yakaladı ve özgün tabloya, kaynakta değişiklik yapmadan işlev ile geçerken bir şeyler ekledi:

   

Bileşen içindeki sütunları eşleme

Bkz. Sütunları eşleme.