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

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

Collect

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

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

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

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

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

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

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

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

Clear

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

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

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

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

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

ClearCollect

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

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

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

تفويض

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

بناء الجملة

جمع ( مصدر البيانات ، البند ، ...)

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

مسح ( مجموعة )

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

ClearCollect ( مجموعة ، عنصر ، ...)

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

الأمثلة

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

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

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

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

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

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

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