السابق

التالي

التمرين - إنشاء قالب ويب قابل للتمديد

مكتمل

الغرض من هذا المعمل العملي هو تقديم مفهوم بناء وتوسيع قوالب Liquid.

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

الأهداف التعليمية

الهدف من هذه التمارين هو مساعدتك على تعلم كيفية:

• قم بتوسيع قوالب Liquid باستخدام علامتي extend وblock.
• إعادة استخدام قوالب Liquid باستخدام علامة include.
• تطبيق أذونات الجدول على نتائج القالب الجديد.

المتطلبات الأساسية

في هذا التمرين، سوف تحتاج إلى إعداد المعلمات التالية فِي بيئتك:

• موقع ويب Power Pages متوفر. إذا لم يكن لديك موقع ويب Power Pages متاح، فاتبع إنشاء موقع به تعليمات Power Pages لإنشاء موقع.
• الوصول إلى تطبيق إدارة المدخل.

‏‫الخطوات عالية المستوى

لإنهاء التمرين، تحتاج إلى إكمال المهام عالية المستوى التالية:

• قم بإنشاء قالب جزئي عن طريق الوصول إلى بيانات Dataverse لاستخدامه ككتلة تخطيط.

• قم بإنشاء قالب جديد يمتد إلى قالب ويب تخطيط من عمودين.

• الكتابة فوق اللوحة الجانبية لتضمين القالب الجزئي.

• تغيير قالب صفحة ويب موجودة.

• قم بإعداد أذونات الجدول لعرض البيانات للمستخدمين المجهولين.

الخطوات المفصَّلة

لإكمال التمرين، سوف تقوم بإنشاء قالب صفحة جديد يتضمن لوحة جانبية تسرد جميع الحسابات فِي Dataverse.

قم بإنشاء قالب جزئي

تتمثل هامتك الأولى فِي إنشاء قالب جزئي لن يُستخدم لعرض صفحة ولكن سيتم إدراجه فِي قالب آخر بدلاً من ذلك.

1. سجّل الدخول إلى الصفحة الرئيسية لـ Power Pages.

2. حدّد البيئة المستهدفة فِي الزاوية العلوية اليمنى.

3. حدّد موقع الويب الخاص بك، وقم بتوسيع قائمة الامتداد (علامة القطع)، ثم حدّد إدارة المدخل لفتح تطبيق إدارة المدخل.

4. حدّد قوالب الويب.

5. حدّد جديد.

6. أدخل القيم التالية:

   • الاسم - الدليل

   • الموقع الإلكتروني - حدّد موقع الويب الحالي الخاص بك

   • المصدر - أدخل المحتوى التالي:

   {% fetchxml accounts %}
   <fetch>
     <entity name="account">
       <attribute name="name" />
     </entity>
   </fetch>
   {% endfetchxml %}
   
   {% if accounts.global_permission_granted %}
     <ul>
       {% for account in accounts.results.entities %} 
       <li>{{ account.name }}</li>
       {%- endfor -%}
     </ul>
   {% else %}
     <div class="alert alert-warning">You do not have permissions to access the directory.</div>
   {% endif %}
   

7. حدّد حفظ وإغلاق.

توسيع قالب موجود

بعد ذلك، سوف تنشئ قالباً جديداً يمد نموذج Liquid موجوداً ثم تقوم بإدراج القالب الذي قمت بإنشائه مسبقاً.

1. حدّد قوالب الويب.

2. حدّد جديد.

3. أدخل القيم التالية:

   • الاسم - نموذج الدليل

   • الموقع الإلكتروني - حدّد موقع الويب الحالي الخاص بك

   • المصدر - أدخل المحتوى التالي:

   {% extends "Layout 2 Column Wide Left" %}
   
   {% block aside %}
     <h2>Directory</h2>
     {% include 'Directory' %}
   {% endblock %}
   

4. حدّد حفظ وإغلاق.

قم بإنشاء قالب صفحة وقم بإقرانه بتلك الصفحة

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

1. حدّد قوالب الصفحة.

2. حدّد جديد.

3. أدخل القيم التالية:

   • الاسم - قالب صفحة الدليل

   • الموقع الإلكتروني - حدّد الموقع الحالي

   • النوع - حدّد قالب الويب

   • قالب الويب - حدّد قالب الدليل

   • اسم الجدول - حدّد صفحة الويب

4. خياري: أضف عنصرًا نصيًا إلى محتوى الصفحة ثم أدخل نصًا من اختيارك.

5. حدّد حفظ وإغلاق.

اختبار

خطوتك التالية هي اختبار عمل القالب الجديد:

1. ارجع إلى علامة التبويب الصفحة الرئيسية من Power Pages أو افتح واحدة جديدة.

2. حدّد موقع الويب ثم حدّد تحرير لفتح استوديو تصميم Power Pages.

3. حدّد مزامنة لمزامنة التغييرات.

4. حدّد مساحة العمل الصفحات.

5. حدّد + صفحة. في مربع حوار إضافة صفحة، أكمل الخطوات التالية:

   1. أدخل الدليل كاسم الصفحة.

   2. حدّد التنسيقات المخصصة ثم حدّد قالب صفحة الدليل.

   3. حدّد إضافة.

سيتم عرض الصفحة الفارغة مع الرسالة "ليس لديك أذونات للوصول إلى الدليل" فِي اللوحة اليمنى.

أضف أذونات الجدول

التحذير

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

اتبع هذه الخطوات لإضافة أذونات الجدول.

1. حدّد إعداد مساحة العمل ثم حدّد أذونات الجدول.

2. حدّد + جديد.

3. أدخل القيم التالية:

   • الاسم - دليل الحساب

   • الجدول - حدّد جدول الحساب (الحساب)

   • نوع الوصول - حدّد وصول عمومي

   • الإذن بـ - حدّد القراءة

4. حدّد إضافة أدوار.

5. حدّد المستخدمون المجهولون والمستخدمون المصدقون.

6. حدّد حفظ.

اختبار

هامتك الأخيرة هي اختبار قالبك الجديد:

1. حدّد مساحة عمل الصفحات ثم حدّد صفحة الدليل.

2. حدّد إصدار أولي > سطح المكتب.

   ‏‫ملاحظة

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

يجب الآن عرض الصفحة وتضمين قائمة الحسابات فِي اللوحة اليمنى.

متابعة