Power Apps uygulamasındaki Collect, Clear ve ClearCollect işlevleri

Koleksiyonlar oluşturup temizler ve herhangi bir veri kaynağına kayıtlar ekler.

Açıklama

Collect

Collect işlevi bir veri kaynağına kayıtlar ekler. Eklenecek öğeler şunlar olabilir:

  • Tek bir değer: Değer, yeni bir kaydın Value alanına yerleştirilir. Diğer tüm özellikler blank bırakılır.
  • Kayıt: Her bir adlandırılmış özellik, yeni bir kaydın karşılık gelen özelliğine yerleştirilir. Diğer tüm özellikler boş bırakılır.
  • Tablo: Tablonun her kaydı, yukarıda açıklandığı gibi veri kaynağının ayrı bir kaydı olarak eklenir. Tablo bir kayda iç içe geçmiş tablo olarak eklenmez. Bunu yapmak için öncelikle bir kayıttaki tabloyu kaydırın.

Koleksiyonla kullanıldığında gerektiği şekilde ek sütunlar oluşturulur. Diğer veri kaynakları için sütunlar, veri kaynağı tarafından düzeltilir ve yeni sütunlar eklenemez.

Veri kaynağı yoksa bir koleksiyon oluşturulur.

Koleksiyonlar bazen genel değişkenleri tutmak veya bir veri kaynağının geçici kopyasını oluşturmak için kullanılır. Tuval uygulamaları, kullanıcı bir uygulama ile etkileşim kurdukça otomatik olarak yeniden hesaplanan formülleri temel alır. Koleksiyonlar bu avantaja sahip değildir ve bunların kullanılması, uygulamanızın oluşturulmasını ve anlaşılmasını zorlaştırabilir. Bir koleksiyonu bu şekilde kullanmadan önce değişkenlerle çalışma bölümünü inceleyin.

Ayrıca bir veri kaynağında kayıtlar oluşturmak için Patch işlevini de kullanabilirsiniz.

Collect , değiştirilen veri kaynağını tablo olarak döndürür. Collect yalnızca bir davranış formülünde kullanılabilir.

Clear

Clear işlevi bir koleksiyonun tüm kayıtlarını siler. Koleksiyonun sütunları kalır.

Clear işlevinin yalnızca koleksiyonlarda çalıştığını ve diğer veri kaynaklarında çalışmadığını unutmayın. Bunun için RemoveIf( VeriKaynağı , doğru ) sözdizimini kullanabilirsiniz. Veri kaynağının depolama alanındaki tüm kayıtlar kaldırılacağından ve diğer kullanıcılar etkilenebileceğinden bu işlem konusunda dikkatli olun.

Kayıtları seçerek kaldırmak için Remove işlevini kullanabilirsiniz.

Clear bir değer döndürmez. Yalnızca bir davranış formülünde kullanılabilir.

ClearCollect

ClearCollect işlevi bir koleksiyondan tüm kayıtları siler. Ve ardından, aynı koleksiyona farklı bir kayıt kümesi ekler. ClearCollect tek bir işlevle Clear ve ardından Collect işlevlerinin birleşimini sunar.

ClearCollect , değiştirilen koleksiyonu tablo olarak döndürür. ClearCollect yalnızca bir davranış formülünde kullanılabilir.

Temsilci

Veri kaynağıyla birlikte kullanıldığında, bu işlevler temsilci atanamaz. Veri kaynağının yalnızca ilk kısmı alınır ve işlev uygulanır. Sonuç, tüm hikayeyi temsil etmeyebilir. Yazma sırasında size bu sınırlamayı anımsatmak ve mümkün olduğunda temsilci atanabilir alternatiflere geçmenizi önermek üzere bir uyarı görüntülenebilir. Daha fazla bilgi için bkz. temsilci atamaya genel bakış.

Sözdizimi

Collect ( VeriKaynağı , Öğe , ... )

  • DataSource : Gerekli. Veri eklemek istediğiniz veri kaynağı. Yoksa yeni bir koleksiyon oluşturulur.
  • Öğeler : Gerekli. Veri kaynağına eklenecek bir veya daha fazla kayıt ya da tablo.

Clear ( Koleksiyon )

  • Koleksiyon : Gerekli. Temizlemek istediğiniz koleksiyon.

ClearCollect ( Koleksiyon , Öğe , ... )

  • Koleksiyon : Gerekli. Temizleyip veri eklemek istediğiniz koleksiyon.
  • Öğeler : Gerekli. Veri kaynağına eklenecek bir veya daha fazla kayıt ya da tablo.

Örnekler

Veri kaynağını temizleme ve veri kaynağına kayıt ekleme

Bu örneklerde, Dondurma adlı bir koleksiyondan kayıt silip kayıtlar ekleyeceksiniz. Veri kaynağı şu içeriklerle başlar:

Örnek veri kaynağı

Formül Açıklama Sonuç
ClearCollect( Dondurma, { Aroma: "Çilek", Miktar: 300 } ) Dondurma koleksiyonundaki tüm verileri temizler ve ardından bir miktar çilekli dondurma içeren bir kayıt ekler. Tek bir kayıt içeren tablo

Dondurma koleksiyonu da değiştirilmiştir.
Collect( Dondurma, { Aroma: "Antep Fıstığı", Miktar: 40 }, { Aroma: "Portakal", Miktar: 200 } ) Dondurma koleksiyonuna bir miktar antep fıstıklı ve portakallı dondurma içeren iki kayıt ekler. İki kaydı olan tablo

Dondurma koleksiyonu da değiştirilmiştir.
Clear( IceCream ) Dondurma koleksiyonundaki tüm kayıtları kaldırır. Boş tablo

Dondurma koleksiyonu da değiştirilmiştir.

Koleksiyonun nasıl oluşturulacağına ilişkin adım adım örnekler için bkz. Koleksiyon oluşturma ve koleksiyonları güncelleştirme.

Kayıtlar ve tablolar

Bu örnekler, Collect ve ClearCollect için kayıt ve tablo bağımsız değişkenlerinin nasıl işlendiğini inceler.

Formül Açıklama Sonuç
ClearCollect( Dondurma, { Aroma: "Çikolata", Miktar: 100 }, { Aroma: "Vanilya", Miktar: 200 } ) Tüm verileri temizler ve ardından bir miktar çikolatalı ve vanilyalı dondurma içeren Dondurma koleksiyonuna iki kayıt ekler. Eklenecek kayıtlar, işleve bağımsız değişkenler olarak sağlanır. Çikolata ve Vanilya kayıtları koleksiyona eklendi

Dondurma koleksiyonu da değiştirilmiştir.
ClearCollect( Dondurma, Table( { Aroma: "Çikolata", Miktar: 100 }, { Aroma: "Vanilya", Miktar: 200 } ) ) Kayıtların bir tabloda birleştirilmesi ve tek bir bağımsız değişken üzerinden geçirilmesi dışında önceki örnekle aynı. Tablonun içeriğindeki kayıtlar Dondurma koleksiyonuna eklenmeden önce tek tek ayıklanır. Çikolata ve Vanilya kayıtları koleksiyona eklendi

Dondurma koleksiyonu da değiştirilmiştir.
ClearCollect( Dondurma,
{ Favorilerim: Table( { Aroma: "Çikolata", Miktar: 100 }, { Aroma: "Vanilya", Miktar: 200 } ) } )
Tablonun bir kayıtta kaydırılması dışında önceki örnekle aynıdır. Tablonun kayıtları ayıklanmaz ve bunun yerine tablonun tamamı kaydın bir hücresi olarak eklenir. Çikolata ve Vanilya kayıtları koleksiyona eklendi

Dondurma koleksiyonu da değiştirilmiştir.