Collect, Clearve ClearCollect işlevleri

İşlev	Şunlar için geçerlidir:
Clear	Tuval uygulamaları Masaüstü akışları Power Platform CLI Dataverse işlevleri
ClearCollect	Tuval uygulamaları Masaüstü akışları Power Platform CLI
Collect	Tuval uygulamaları Masaüstü akışları Model temelli uygulamalar Power Platform CLI Dataverse işlevleri

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

Collect

Collect işlevi bir veri kaynağına kayıt 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 davranış formülünde kullanılabilir.

Clear

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

Clear Diğer veri kaynakları üzerinde değil yalnızca koleksiyonlarda çalıştığı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 dönüş değeri yok. Yalnızca bir davranış formülünde kullanılabilir.

ClearCollect

işlevi bir ClearCollect koleksiyondaki tüm kayıtları siler. Ve ardından, aynı koleksiyona farklı bir kayıt kümesi ekler. Tek bir işlevle ve ClearCollect sonra Collectbirleşimini Clear sunar.

ClearCollect değiştirilen koleksiyonu tablo olarak döndürür. ClearCollect yalnızca 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( 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, 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 örneklerde, kayıt ve tablo bağımsız değişkenlerinin Collect nasıl ClearCollect işlendiği incelenir.

Formül	Açıklama	Sonuç
ClearCollect( IceCream, { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } )	Clear tüm verileri ve ardından IceCream koleksiyonuna bir miktar çikolata ve vanilyalı dondurma içeren 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.