الدالات Collect وClear وClearCollect

تقوم بإنشاء ومسح وإضافة سجلات سجلاتإلى أي مصدر بيانات .

Collect

تنطبيق على: Canvas apps البطاقات Dataverseالبرنامج المساعد ذو التعليمات البرمجية المنخفضة Power Platform CLI تدفقات سطح المكتب

تضيف دالة Collect السجلات إلى مصدر البيانات. يمكن أن تكون العناصر المراد إضافتها هي:

• قيمه مفردة: يتم وضع القيمة في حقلValueالخاص بسجل جديد. يتم ترك كافة الخصائص الأخرى blank.
• سجل: يتم وضع كل خاصية مسماة في الخاصية المناظرة للسجل الجديد. يتم ترك كافة الخصائص الأخرى فارغة .
• جدول : تتم إضافة كل سجل من الجدول كسجل منفصل لمصدر البيانات كما هو موضح أعلاه. لا تتم إضافة الجدول كجدول متداخل إلى سجل. للقيام بذلك، قم بإجراء التفاف للجدول في سجل أولا.

وعند استخدامها مع إحدى المجموعات، سيتم إنشاء الأعمدة الإضافية حسب الحاجة. يتم إصلاح الأعمدة الخاصة بمصادر البيانات الأخرى من خلال المصدر البيانات ولا يمكن إضافة أعمدة جديدة.

إذا لم يكن مصدر البيانات موجودا بالفعل، يتم إنشاء مجموعة.

ويتم استخدام مجموعات في بعض الأحيان للاحتفاظ بالمتغيرات العامة أو عمل نسخة مؤقتة لمصدر البيانات. تستند تطبيقات اللوحة إلى الصيغ التي تقوم تلقائيا بإعادة حسابها أثناء تفاعل المستخدم مع أحد التطبيقات. لا تتمتع المجموعات بهذه الميزة ويمكنهم جعل تطبيقك أكثر صعوبة في الإنشاء والفهم. قبل استخدام مجموعة بهذه الطريقة، راجع العمل مع المتغيرات .

يمكنك أيضا استخدام دالة Patch لإنشاء سجلات في مصدر البيانات.

Collectترجع مصدر البيانات المعدلة كجدول. يمكن استخدام وظيفة Collect فقط في صيغ السلوك.

Clear

ينطبق على: تطبيقات اللوحة

تعمل الدالةClear على حذف كافة السجلات الخاصة بالمجموعة. ستبقى أعمدة المجموعة.

لاحظ أن الدالة Clearتعمل على المجموعات فقط وليست مصادر البيانات الأخرى. يمكنك استخدام RemoveIf ( DataSource , true) لهذا الغرض. توخ الحذر لأن هذا سيؤدي هذا إلى إزالة جميع السجلات من مساحة التخزين المصدر البيانات ويمكن أن يؤثر ذلك على المستخدمين الآخرين.

يمكنك استخدام دالة Remove لإزالة السجلات بشكل انتقائي.

لا تقوم دالة Clear بإرجاع قيمة. يمكن استخدامها فقط في صيغ السلوك.

ClearCollect

ينطبق على: تطبيقات اللوحة التطبيقات المستندة إلى النموذج

تعمل الدالة ClearCollect على حذف كافة السجلات الخاصة بالمجموعة. ثم يقوم بإضافة مجموعة مختلفة من السجلات لنفس المجموعة. باستخدام دالة واحدة، تعرض ClearCollect مجموعة من Clearوبعد ذلك Collect.

ClearCollect ترجع المجموعة المعدلة كجدول. يمكن استخدام الدالة ClearCollect فقط في صيغ السلوك.

تفويض

عند استخدام هذه الوظائف مع مصدر بيانات، لا يمكن تفويضها. سيتم استرداد الجزء الأول من مصدر البيانات وعندئذٍ يتم تطبيق الوظيفة. قد لا تمثل النتيجة القصة الكاملة. ربما يظهر تحذير في وقت التأليف لتذكيرك بهذا التقييد وكذلك لاقتراح التبديل إلى بدائل قابلة للتفاوض، إن أمكن. لمزيد من المعلومات، راجع نظرة عامة على التفويض.

بناء الجملة

Collect( DataSource, Item, ... )

• DataSource – مطلوب. مصدر البيانات الذي تريد إضافة بيانات إليه. إذا لم يكن مصدر البيانات موجودا بالفعل، يتم إنشاء مجموعة جديدة.
• Item(s) - مطلوب. واحد أو أكثر من السجلات أو الجداول المراد اضافتها إلى المصدر البيانات.

Clear( Collection )

• Collection – مطلوبة. المجموعة التي تريد مسحها.

ClearCollect( Collection, Item, ... )

• Collection – مطلوبة. المجموعة التي تريد مسحها ثم إضافة البيانات اليها.
• Item(s) - مطلوب. واحد أو أكثر من السجلات أو الجداول المراد اضافتها إلى المصدر البيانات.

الأمثلة

مسح السجلات وإضافتها إلى مصدر بيانات

في هذه الامثلة، ستقوم بمحو وإضافة إلى مجموعة تسمى IceCream. يبدأ المصدر البيانات بهذه المحتويات:

الصيغة	الوصف	النتيجة
ClearCollect( IceCream, { Flavor: "Strawberry", Quantity: 300 } )	تقوم بمسح كل البيانات من مجموعة IceCream ثم إضافة سجل يتضمن كمية من آيس كريم الفراولة.	تم تعديل مجموعة IceCream أيضًا.
Collect( IceCream, { Flavor: "Pistachio", Quantity: 40 }, { Flavor: "Orange", Quantity: 200 } )	يضيف سجلين إلى مجموعة IceCreamالتي تشتمل على كمية من البيستاتشيو وآيس كريم البرتقال.	تم تعديل مجموعة IceCream أيضًا.
Clear( IceCream )	إزالة جميع السجلات من مجموعة IceCream.	تم تعديل مجموعة IceCream أيضًا.

للحصول على أمثلة خطوة بخطوة حول كيفية إنشاء مجموعة، راجع إنشاء مجموعة وتحديثها .

الجداول والسجلات

وتعمل هذه الأمثلة على فحص كيفية معالجة وسيطات السجل والجدول للدالتين Collect وClearCollect.

صيغة	‏‏الوصف	نتيجة
ClearCollect( IceCream, { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } )	تقوم بمسح كل البيانات، ثم تضيف سجلين إلى مجموعة IceCream تتضمن كمية من آيس كريم الشيكولاتة والفانيلا. يتم توفير السجلات المراد إضافتها كوسائط فردية للدالة.	تم تعديل مجموعة IceCream أيضًا.
ClearCollect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) )	مثل المثال السابق باستثناء أن يتم دمج السجلات في جدول ويتم تمريرها من خلال وسيطة واحدة. وتتم استخراج محتويات الجدول كسجل واحد في كل مرة قبل إضافته إلى مجموعة IceCream.	تم تعديل مجموعة IceCream أيضًا.
ClearCollect( IceCream, { MyFavorites: جدول( { النكهة: "شوكولاتة"، الكمية: 100 }, { النكهة: "فانيلا"، الكمية: 200 } ) } )	نفس المثال السابق باستثناء أن الجدول ملتف في سجل. لا يتم استخراج سجلات الجدول وبدلا من ذلك تتم إضافة الجدول بالكامل كخلية من السجل.	تم تعديل مجموعة IceCream أيضًا.