تخزين جدول

مكتمل

في الأمثلة السابقة، كانت الجداول مُعدة للاستخدام في السياق الحالي فقط بالنسبة للجدول البيانات أو عنصر التحكم Dropdown. ستحتاج غالبًا إلى تخزين هذه الجداول في تطبيقك، واستخدامها في أماكن مُتعددة داخل التطبيق. لفعل ذلك، يحتوي Power Apps على مُتغير جدول يُسمى مجموعة.

تُعد المجموعات نوع مُتغير في Power Apps

تُعد المجموعات مُتغيرات جدول، حيث يُمكنك تخزين البيانات بتنسيق مُنظم، كما قد تفعل في مصدر بيانات جدولي، دون الكتابة إلى مصدر بيانات. بمعنى آخر،تُخزن القيم في صفوف وأعمدة. يُمكنك استخدام المجموعات مع دالات table كما قد تفعل مع أي مصدر بيانات آخر. ومع ذلك، لا يُمكنك استخدام مجموعة مع عنصر التحكم Form. إذا كانت لديك خلفية مُطور، فيُمكنك التفكير في المجموعة باعتبارها مصفوفة. ليس عليك تهيئة مجموعة، أو تحديدها مُسبقًا. عندما تُنشئ القيم وتعينها، يقوم Power Apps بإعدادها لك.

إنشاء مجموعة

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

Collect(collectMyFirstCollection, {Name: "Shane", FavoriteColor:"Orange"})

قد تحتوي المجموعة على عمود يُسمى Name وعمود آخر يُسمى FavoriteColor. قد تحتوي المجموعة على سجل واحد (صف) من البيانات تُمثل لفظة Shane فيه قيمة Name ولفظة Orange قيمة FavoriteColor. لاحظ أن بناء الجملة مشبه للدلة Table في جزء سابق من هذه الوحدة.

يُمكنك إضافة سجل آخر إلى المجموعة باستخدام هذه الصيغة.

Collect(collectMyFirstCollection, {Name: "Nicola", FavoriteColor:"Purple"})

يُمكنك أيضًا إضافة أكثر من سجل في المرة الواحدة باستخدام هذه الصيغة.

Collect(collectMyFirstCollection, {Name: "Jeff", FavoriteColor:"Blue"}, {Name: "Chewy", FavoriteColor: "Red"})

إذا قمت بتشغيل كل هذه الأوامر، فستبدو مجموعتك مثل هذا الجدول:

الاسم FavoriteColor
Shane Orange
Nicola Purple
Jeff Blue
Chewy Red

يُمكنك بعد ذلك استخدام هذه المجموعة كمصدر بيانات لعنصر تحكم المعرض أو القائمة المنسدلة.

إزالة البيانات من مجموعتك

لمسح البيانات الموجودة من مجموعتك قبل إضافتك للبيانات، يُمكنك استخدام الدالة ClearCollect. إذا أخذت المجموعة الموجودة من المثال السابق، يُمكنك استخدام هذه الصيغة:

ClearCollect(collectMyFirstCollection, {Name: "Fausto", FavoriteColor:"Green"})

ستبدو مجموعتك الآن مثل هذا الجدول:

Name FavoriteColor
Fausto Green

يُمكنك أيضًا إزالة جميع السجلات من مجموعة باستخدام الدالة Clear. تزيل هذه الصيغة جميع السجلات من مجموعتك ولكنها تترك أعمدتك كما هي:

Clear(collectMyFirstCollection)