تَمرين - التعَامُل معَ البيَانَاتِ الخَارجيةِ فِي أحد تَطبِيقَات اللوحة

مكتمل

فِي هَذَا التَمرين، ستعمل معَ البيَانَاتِ الخَارجيةِ فِي تَطبِيق اللوحة، عَن طريق إضَافَة مصدر بيَانَات إلى تَطبِيقك، وإنشَاء/تعديل البيَانَات باستِخدَام المجموعات، وتعديل البيَانَات عبر دَالة Patch.

تحتَاج إلى تنزيل جدول بيَانَات لإكمَال هَذَا التَمرين. حدد تنزيل بمجرد فتح الارتباط. قم باستخرَاج جدول بيَانَات Excel وتحميل جدول البيَانَات إلى OneDrive لديك.

إضَافَة مصدر بيَانَات

1. سجّل الدخول إلى Power Apps.

2. قم بإنشَاء تَطبِيق اللوحة Power Apps جَدِيد‎ مِن البدَاية وأطلق عليه اسم ExternalData. وحدد التنسيق Tablet.

3. تأكد مِن أنك قمتَ بإضَافَة ورقة Excel (الارتباط أعلاه) إلى OneDrive الخَاص بك.

4. مِن الزر إدرَاج فِي شريط الرأس، حدد المعرض العمودي.

5. فِي جزء تحديد مصدر بيَانَات فِي معرضك، اكتب "OneDrive" فِي حقل البحث، حدد OneDrive for Business مِن القَائمة. بدلا مِن ذلك، يمكنك أيضًا توسيع المُوصِّلِات والتمرير عبر المُوصِّلِات المتَاحة حتى تجد OneDrive for Business.

   

6. ضمِن إضَافَة اتصَال، حدد الاتصَال الذي تريد استخدَامه لـ OneDrive for Business (سيكون لهَا عنوان بريد إلكتروني مدرج تحته).

7. أسفَل OneDrive for Business، حدد اتصَال.

8. عندمَا يُطلب مِنك اختيَار مَلف Excel، ابحَث عَن مِلَفِ Excel الذي نزّلته فِي الخطوةِ 3 أو مرِّر إليه وحدده.

9. ضمِنَ لوحةِ اختيَار جدول، تحقَّق مِن جدولِ العنَاصر ثمَّ حدد اتصَال.

معرضُك متصلٌ الآن بجدولِ Excel الخَاص بك المُسمَّى "العنَاصر" فِي OneDrive for Business. تأكَّد مِن أنَّ خَاصيةِ العَنَاصِر فِي المَعرضِ الخَاص بك مرتبطةٌ بالجدولِ Items، ويجب أن يعرض المعرض بَعد ذلك الإدخَالات الثلاثة فِي الجدول.

عَرض البَيَانَات والتفَاعل معَهَا فِي معرض

1. تأكَّد مِن تحديدِ عنصرِ تحكمِ المَعرضِ الذي أضَفته.

2. فِي جزءِ الخَصَائصِ عَلى اليَسَار، حدد القَائمَة المُنسدِلة لخَاصِية Layout. بدلا مِن ذلك، عندَ التَمريرِ فَوق عُنصرِ التحكُّم المُحدَّد، سترى زرَ تخطيطِ قَابل للتحديد بنفسِ الخَيَارَات.

3. حدد التخطيطَ الصورة والعنوان وشريط الترجمة والنص الأسَاسِي.

4. فِي جزء الخصَائص عَلى اليسَار، حدد زر تحرير للخَاصية Fields وقم بتعيين الحقول عَلى النحو التَالِي (لاحظ أن عنَاصر التحكم لهَا أرقَام خلفهَا، عَلى سَبِيل المِثَال، سيكون النص الأسَاسِي "Body1"، انظر الصورة أدنَاه للرجوع إليهَا):

   • النص الأسَاسِي: الوصف

   • الصورة: الصورة

   • الترجمة:‏ UnitPrice

   • العنوان: الاسم

   بدلا مِن ذَلك، يمكنُك التَمريرُ فوقَ عنصرِ التحكمِ المُحدَّدِ وتَحديد زرِّ الحقول فِي قَائمةِ التمريرِ التي تظهر فوق عنصر التحكم. بمجردِ إجرَاء التعدِيلاتِ، مَا عَليك سوَى إعَادةِ تحديدِ زرِّ الحقول لإغلاقِ الخَيَار.

   

5. أغلق مربع حوار البيَانَات.

6. فِي المَعرضِ، حدد السعرَ فِي الصفِّ الأول. لاحِظ زرَّ Copilot عِند التَمريرِ فَوق تسميةِ سعرِ الوِحدةِ لـ UnitPrice. هيَا نستخدم Copilot مِن أجل مسَاعدتنَا فِي جعل هَذَا يبدو وكأنه سعر. حدد زر Copilot، ثم حدد تنسيق النص.

7. فِي لوحة تنسيق النص باستِخدَام الأمثلة التي تظهر عَلى الجَانب الأيمَن مِن الشَاشة لديك، حدد حقل الإدخَال لـ التنسيق المطلوب. يجب أن ترى الآن بعض خيَارَات التنسيق. ابحث عَن/حدد الخيَار الذي يعرض $6.19.

   

8. فور أن تفعل ذلك، ستشَاهد اقترَاحًا لحَقل UnitPrice يظهر فِي اللوحة. قَام Copilot بكتَابة معَادلة تحوّل قيمة سعر الوحدة إلى شيء يشبه السعر. يتطلب مِنك Copilot تحديد الاقترَاح، ومِن ثم يمكنك تحديد زر تَطبِيق أسفل اللوحة.

   يُرسل إليك Power Apps إعلامَا بأنه قد قَام بتحديث حَقل UnitPrice نيَابةً عنك، ومِن المفترض أن تبدو القيم الموجودة فِي معرض الصور لديك الآن مِثلَ قيم العملات.

9. فِي المعرض، حدد الصورة الموجودة فِي الصف الأول.

10. فِي الجزء خصَائص عَلى الجَانب اليمين، حدد القَائمة المِنسدلة لخَاصية موضع الصورة.

11. قُم بتغييرِ الخَاصية مِن Fit إلى Fill وسَتَرى أنَّ الصورةَ تتسعُ لتعبئةِ أبعَادِ عنصرِ تحكمِ الصُورة.

لقد أضفنَا الآن البيَانَات وخصصنَاهَا وكونَاهَا فِي معرض الصور الخَاص بك.

نقل البيَانَات بين المجموعات ومصَادر البيَانَات

1. حدد Screen1 (فِي أي مكان خَارج المعرض).

2. هيَا نضيف زرَا عَن طريق تحديد الزر إدرَاج فِي شريط التَطبِيق. حدد الزر وضع عنصر تحكم الزر الجَدِيد‎ أسفل معرض الصور الخَاص بك.

3. قم بتغيير النص الموجود عَلى الزر إلى إضَافَة إلى المَجموعة، وقم بتعيين حجم الخط مِن 15 إلى 12 بحيث يتلاءم النص معَ الزر فِي سطر واحد.

4. حدد زر وفِي شريط الصيغة، استبدل القيمة OnSelect لـ خطأ بهَذَا التعبير:

    ClearCollect(colItemsCollection, Items)
   

   colItemsCollection: يشير إلى اسم المَجمُوعة

   العَنَاصر: يشيرُ إلى اسمِ مَصدرِ البيَانَات

   ClearCollect: مسحُ أيِّ عنَاصر موجودةٍ ثمَّ نسخ جميعِ السجلاتِ مِن العنَاصر إلى مجموعة colItemsCollection

   

5. حدد زرَّ إصدَار أولي فِي الجزءِ العُلوي الأيسَر مِن محررِ Power Apps (أو اضغَط عَلى F5) للدخولِ فِي حَالةِ الإصدَار الأولي. حدد زرَّ إضَافَة إلى مجموعة، وقم بإنهَاء وضع الإصدَار الأولي. وبدلا مِن ذلك، اضغَط معَ الاستمرَار عَلى مُفتَاح Alt، وحدد زر إضَافَة إلى المجموعة.

6. فِي الشريط الأيسر، حدد زر Variables، وقم بتوسيع الخيَار Collections، وحدد علامة القطع بجوار colItemsCollection التي قمت بإنشَائهَا. حدد خيَار عرض الجدول.

   

7. يجب أن تشَاهد الآن نَافذة مِنبثقة تعرض الجدول المخزن فِي مجموعتك. لاحظ أنه قد تمت إضَافَة السجلات الثلاثة مِن مصدر بيَانَات العنَاصر إلى مجموعة colItemsCollection. يمكنك عرض أيّ مِن مجموعات تَطبِيقك والمتغيرَات الأخرى باستِخدَام هذه التقنية.

   

8. حدد إلغاء لإغلاق العَرض المِنبثق والعودة إلى لوحة التَطبِيق.

استكشف الدَالات الأخرى التي يمكن استخدَامهَا معَ المجموعات

1. مِن طريقة عرض الشجرة، حدد شَاشة جَدِيد‎ة>فَارغ.

2. حدد زرَّ إدرَاج وابحَث عَن البيَانَات، وحدد جَدول البيَانَات. يسمحُ لنَا عنصرُ التحكمِ فِي جدولِ البيَانَات بعرضِ البيَانَات الجدولية بسرعةٍ.

   

3. انتقِل الآن إلى لوحةِ الخصَائص عَلى اليَمينِ وحدد جدولَ العنَاصر الخَاص بك كمصدرٍ للبيَانَات. سترَى Name وUnitPrice وUnitsSold تظهر كأعمدةٍ فِي عُنصرِ التحكُّم.

4. فِي خَاصِية Items للتحكُّمِ فِي جدولِ البيَانَات، احذِف Items وأدخل: colItemsCollection

5. أدرج زرَا عَن طريق تحديد إدرَاج مِن الشريط، وحدد الزر، ثم حدد موضع الزر الخَاص بك أسفل الجدول. أضف ثلاثة أزرَار أخرى مِن اليسَار إلى اليمين أسفل عنصر التحكم فِي جدول البيَانَات عَلى شَاشتك.

6. قم بتغيير النص عَلى كل الأزرَار الأربعة لـ إضَافَة عمود، أو إسقَاط عمود، أو إظهَار عمود، أو إعادة تسمية عمود عَلى التوالي. يمكنك القيَام بذلك ببسَاطة عَن طريق النقر المزدوج عَلى كل زر وكتَابة الاسم الجَدِيد‎. قم بتعيين حجم خط الزر إعادة تسمية العمود إلى 12، بحيث يتلاءم معَ سطر واحد.

7. حدد زر إضَافَة عمود وقم بتحديث الخَاصية OnSelect لهَذَا التعبير:

   Collect(colAddCollection, AddColumns(colItemsCollection, Revenue, UnitPrice * UnitsSold))
   

   أثنَاء هَذَا التَمرين، ربمَا لاحظتَ أيقونة Copilot فِي شريط المعادلة لديك. يمكن أن يقدّم لك Copilot تفسيرَا لمَا يحدث فِي المعادلة لديك.

8. حدد أيقونة Copilot فِي شريط المعادلة لخَاصية OnSelect الخَاصة بالزر "إضَافَة عمود". ثم حدد شرح هذه المعادلة.

   يجب أن تشَاهد الآن شرح المعادلة مشَابهَا لهذه الصورة. لاحظ أيضًا أن دَالة Copy التي يُمكنك استخدَامهَا لإضَافَة الملاحظَات إلى المعادلة لديك.

   

   يحصل مثَالنَا عَلى هَذَا الشرح مِن Copilot: يضيف هَذَا التعبير عمودًا جَدِيد‎ًا باسم "Revenue" إلى جدول "colItemsCollection" عَن طريق ضرب عمودي "UnitPrice" و"UnitsSold"، ثم يجمعَ الجدول المحدث فِي مجموعة "colAddCollection".

   كمَا يمكنك نسخ شرح Copilot وإضَافته إلى المعَادلة لديك كسطر "ملاحظَات". مَا عليك سوى إضَافَة شرطة مَائلة مزدوجة للأمَام أمَام الكود "//" والذي يُخبر Power Apps أن السطر لديك ليس رمزًا قَابلا للتطبيق.

9. حدد زر إفلات العمود عَلى اللوحة القمَاشية، وقم بتحديث الخَاصية OnSelect لهَذَا التعبير:

   Collect(colDropCollection, DropColumns(colItemsCollection, UnitPrice))
   

   حَاول استخدَام Copilot - اشرح هذه المعادلة مجددَا.

10. حدد زر إظهَار العمود وقم بتحديث الخَاصية OnSelect لهَذَا التعبير:

    Collect(colShowCollection, ShowColumns(colItemsCollection, Name))
    

    يؤدي تحديد هَذَا الزر إلى إنشَاء مجموعة جَدِيد‎ة تسمى *colShowCollection، والتي تتضمِن جميع البيَانَات مِن مجموعة colItemsCollection، ولكنهَا تستخدم الدَالة ShowColumns لإظهَار عمود Name فقط.

11. حدد زر إعادة تسمية العمود وقم بتحديث الخَاصية OnSelect لهَذَا التعبير:

    Collect(colRenameCollection, RenameColumns(colItemsCollection, Name, Product))
    

    يؤدي تحديد هَذَا الزر إلى إنشَاء مجموعة جَدِيد‎ة تسمى colRenameCollection، والتي تتضمِن جميع البيَانَات مِن مجموعة colItemsCollection، ولكن باستِخدَام الدَالة RenameColumns، يغير عمود Name إلى Product.

12. حدد زرَّ الإصدَار الأولي (أو تَشغِيل) أعَلى يَمينِ مُحرِّرِ Power Apps لإدخَال وَضعِ الإصدَار الأولي. حدد جميع الأزرَار الأربعة. ثم اخرُج مِن وضع الإصدَار الأولي. مَا فعلنَاه للتو هو إنشَاء أربع مجموعات أخرى.

13. لنلق نظرة عَلى المجموعات الأربع الجَدِيد‎ة التي أنشأنَاهَا. حدد المتغيرَات>المجموعات (مجموعات المتغيرَات)، ثم حدد علامة الحذف بجوار colAddCollection، ثم عرض الجدول. لاحظ كيف تحتوي نَافذة المتغيرَات المِنبثقة الخَاصة بك عَلى قَائمة عَلى الجَانب الأيسر تعرض جميع المجموعات الأربع الجَدِيد‎ة التي أنشأنَاهَا، جنبًا إلى جنب معَ المجموعة الأصلية. يمكنك الاختيَار مِن خلال كل مِنهم لمعرفة التأثير عَلى المجموعة الأصلية التي تم عرضهَا فِي جدول البيَانَات الخَاص بنَا.

    colAddCollection

    colDropCollection

    colShowCollection

    colRenameCollection

    

    أغلق نَافذة المتغيرَات المِنبثقة بَعد أن تُلقي نظرة. تذكر أن المجموعات عبارة عَن جدَاول بيَانَات مؤقتة متَاحة فَقَط أثنَاء استخدَام التَطبِيق ومتَاحة فَقَط للمستخدم الحَالي. لذلك، بمجرد إغلاق التَطبِيق، يختفِي.

العمل معَ الدَالة Patch

1. ارجع إلى Screen 1 فِي تَطبِيقك.

2. أضف عنصر تحكم Text label (حدد زر إدرَاج وحدد Text label). أعد تسمية خَاصية Text إلى اسم المِنتج. يمكنك القيَام بذلك عَن طريق النقر المزدوج عَلى التسمية والكتَابة مباشرة فِي عنصر التحكم. ثم ضع التسمية بجوار المعرض.

   ‏‫نَصِيحة

   مِن الأسَاليب السهلة لنسخ عنصر تحكم ولصقه بسرعة تحديد عنصر التحكم والضغط معَ الاستمرَار عَلى مفتَاح Ctrl واضغط عَلى C؛ ثم (أثنَاء الضغط معَ الاستمرَار عَلى مفتَاح Ctrl) اضغط عَلى V. سترى العنصر الذي قمت بلصقه أسفل قليلا وعَلى يمين عنصر التحكم الذي نسخته للتو.

3. بَعد تحديد التسمية، انسخهَا، واجعل نص التسمية المِنسوخة وصفًا جَدِيد‎ًا.

4. استخدم الزر إدرَاج مرة أخرى لإدرَاج عنصر التحكم إدخَال النص. امسح الخَاصية default لجعلهَا فَارغة. بَعد ذلك، انسخ عنصر التحكم هَذَا وضع كلا مِن مدخلات النص بجوار التسميَات التي قمت بإنشَائهَا فِي الخطوات أعلاه. (إذَا كنت بحَاجة إلى مرَاجعة موضع عنَاصر التحكم، فِيمكنك التمرير لأسفل للوُصُول إلى الصورة الموجودة أسفل هَذه الوحدَة.)

5. ثم أدرج عنصر تحكم الزر وحدد موضعه أسفل "تسميَاتك". قم بتغيير الخَاصية Text إلى تحديث.

6. حدد إدخَال النص إلى يمين تسمية اسم المِنتج.

7. فِي شريط الصيغة، تأكد مِن تحديد الخَاصية Default، ثم قم بتغيير التعبير إلى مَا يلي (ضع فِي اعتبارك أن عنصر التحكم فِي المعرض قد يكون له اسم مختلف عَن Gallery1؛ قم بتغيير الصيغة وفقًا لذلك):

   Gallery1.Selected.Name
   

   تعرض هذه التسمية الآن اسم السجل المحدد مِن المعرض. يمكنك اختبار ذلك عَن طريق وضع التَطبِيق فِي وضع الإصدَار الأولي (بدلا مِن ذلك، اضغط معَ الاستمرَار عَلى Alt) واختيَار عنَاصر مختلفة مِن المعرض. لاحظ كيف يتغير اسم المِنتج المعروض أثنَاء تحديد عنَاصر المعرض المختلفة.

8. كرر هذه العملية لعنصر التحكم فِي إدخَال النص عَلى يسَار تسمية الوصف الجَدِيد‎. إنشَاء المعادلة Default:

   Gallery1.Selected.Description
   

   شيء آخر يجب ملاحظته هو الشريط العمودي الدَاكن الذي يتم عرضه عَلى الجَانب الأيسر مِن عنصر المعرض المحدد.

9. حدد زر تحديث.

10. قم بتغيير الخَاصية OnSelect للزر إلى هَذَا التعبير:

    Patch(Items,LookUp(Items, Name = TextInput1.Text), { Description: TextInput1_1.Text })
    

    ملاحظة

    قد يكون لعنَاصر التحكم فِي إدخَال النص أسمَاء مختلفة عَن هَذَا المثَال. اضبُط المُعَادَلة وفقَ ذلك.

هيَا نلخص مَا قمِنَا به. لقد أنشأنَا طريقةً بسيطةً لتحديث وصف المِنتج المحدد الخَاص بك.

• تصحيح - توفِير الوسَائل مِن أجل تعديل أو إنشَاء سجل فِي مصدر البيَانَات الخَاص بك، فِي هذه الحَالة نقوم بتعديل السجل.

• LookUp - يستخدم اسم المِنتج الخَاص بنَا للعثور عَلى السجل المحدد الذي نريد تعديله. يقوم LookUp بإرجَاع السجل الأول الذي يتطَابق معَ حَالتنَا: Name = TextInput1.Text.

• بمجرد أن تعثر Power Apps عَلى السجل المطَابق (عبر LookUp)، إنه يقوم بتحديث وصف الصنف فِي مصدر البيَانَات استنَادَا إلى مَا قمتَ بكتَابته فِي إدخَال نص الوصف الجَدِيد‎.

اختبر هَذَا مِن خلال معاينة التَطبِيق الخَاص بك. حدد عنصر Cinnamon فِي المعرض ثم استبدل الوصف الحَالي بـ "شَاي أخضر بنكهة القرفة"، ثم حدد تحديث. بَعد لحظة، يتغير الوصف الموجود فِي المعرض إلى الوصف المحدث.

تهَانينَا! لقد تعلمتَ تقنيةً بسيطةً لتحديثِ مصدرِ بيَانَاتك عبر تصحيح وكَيفِيةِ استخدَام/تعديل بيَانَاتك دَاخل التَطبِيق باستِخدَام المجموعَات.