Collect, Clear ve ClearCollect işlevleri

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

Collect

Şunlar için geçerlidir: Tuval uygulamaları Kartlar Dataverse az kodlu eklentileri Power Platform CLI

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 önce tabloyu kayıtta paketleyin.

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

Şunlar için geçerlidir: Tuval uygulamaları

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

Şunlar için geçerlidir: Tuval uygulamaları Model temelli uygulamalar

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 edinmek için bkz. temsilci atamaya genel bakış.

Sözdizimi

Collect( DataSource, Öğ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 )

• Toplama – Gerekli. Temizlemek istediğiniz koleksiyon.

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

• Toplama – 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, IceCream adlı bir koleksiyondan kayıt silip kayıtlar ekleyeceksiniz. Veri kaynağı şu içeriklerle başlar:

Formül	Açıklama	Sonuç
ClearCollect( IceCream, { Flavor: "Strawberry", Quantity: 300 } )	IceCream koleksiyonundaki tüm verileri temizler ve ardından bir miktar çilekli dondurma içeren bir kayıt ekler.	IceCream koleksiyonu da değiştirilmiştir.
Collect( IceCream, { Flavor: "Pistachio", Quantity: 40 }, { Flavor: "Orange", Quantity: 200 } )	IceCream koleksiyonuna bir miktar antep fıstıklı ve portakallı dondurma içeren iki kayıt ekler.	IceCream koleksiyonu da değiştirilmiştir.
Clear( IceCream )	IceCream koleksiyonundaki tüm kayıtları kaldırır.	IceCream 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( IceCream, { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } )	Tüm verileri temizler ve ardından bir miktar çikolatalı ve vanilyalı dondurma içeren IceCream koleksiyonuna iki kayıt ekler. Eklenecek kayıtlar, işleve bağımsız değişkenler olarak sağlanır.	IceCream koleksiyonu da değiştirilmiştir.
ClearCollect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 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 IceCream koleksiyonuna eklenmeden önce tek tek ayıklanır.	IceCream koleksiyonu da değiştirilmiştir.
ClearCollect( IceCream, { MyFavorites: Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 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.	IceCream koleksiyonu da değiştirilmiştir.