استخدام نماذج الجدول للتفاعل مع بيانات Microsoft Dataverse

مكتمل

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

يمكن لنماذج الجدول عرض معظم أنواع الأعمدة والشبكات الفرعية ولكن، حاليًا، لا يمكنها عرض عناصر تحكم إطار عمل مكونات Power Apps.

لقطة شاشة لنموذج الجدول بالبيانات العامة.

الاستخدامات الشائعة

يشرح الجدول التالي السيناريوهات الشائعة التي يمكن فيها استخدام نماذج الجدول.

السيناريو الوصف
التخطيط يمكن تكوين نماذج الجدول واستخدامها في وضع القراءة فقط كآلية تخطيط. فكّر في نماذج الجدول كصفحات إعلامية حول الموظفين، أو المنتجات، أو أي جدول Microsoft Dataverse آخر. على سبيل المثال، قد يكون لديك جدول مخصص في مثيل Dataverse الخاص بك يصف المواضع المفتوحة المتوفرة في مؤسستك. بدلاً من تصميم قالب خاص لعرض الصفحة، يمكنك إنشاء نموذج منفصل يستند إلى نموذج للجدول، وإنشاء صفحة ويب جديدة باستخدام استوديو المداخل، ثم إضافة مكون نموذج الجدول إلى الصفحة. سيتم تطبيق أي تغييرات منشورة في تخطيط نموذج في تطبيق يستند إلى نموذج على صفحة ويب هذه تلقائيًا.
التقاط المعلومات يمكن استخدام النماذج على المدخل لالتقاط البيانات من المستخدمين المجهولين أو المصادق عليهم. على سبيل المثال، قد يتم عرض نموذج جدول عميل متوقع بسيط في صفحة الاتصال بنا لتسجيل الطلبات المجهولة كعملاء متوقعين في Dynamics 365 Sales. بالنسبة إلى المستخدمين المصادق عليهم، قد يستخدم المدخل صفحة استطلاع لتجميع تعليقات المنتج من العملاء في جدول مخصص لتعليقات المنتج.
إدارة السجلات عادة ما تُستخدم نماذج الجدول في السيناريوهات المصادق عليها، وتتيح مجموعات متعددة من عمليات الإنشاء، والاسترداد، والتحديث، والحذف (CRUD) الموجودة في جدول ليتم تعريفها ضمن مجموعة من صفحات ويب المرتبطة. على سبيل المثال، يمكن للعملاء استرداد وقراءة الحالات الخاصة بهم وإنشاء حالات جديدة، ويمكن للشركاء تحرير ملفات تعريف شركتهم، كما يمكن للموظفين عرض قائمة بالأصول التي تم تخصيصها لهم بواسطة الشركة.
تطبيقات ويب تتيح نماذج الجدول، عند استخدامها جنبًا إلى جنب مع قوائم الجداول والشبكات الفرعية، ومع الوظيفة الممتدة بواسطة JavaScript، للمطورين إنشاء تطبيقات ويب كاملة.

إنشاء نموذج جدول

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

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

لقطة شاشة لنموذج الجدول في Portal Studio.

  • تعتبر نماذج المدخل أكثر إيجازًا مع عرض معلومات أقل، خاصة عند تضمين الجماهير الخارجيين.
  • وتختلف عمليات المدخل عن الاستخدام الداخلي لتطبيق يستند إلى النموذج وموجه إلى الموظفين، (بما في ذلك تطبيقات Dynamics 365). يسهل الحفاظ على نماذج المدخل المخصصة لأنه لا بد من تطبيق أي تغييرات في التطبيقات المستندة إلى النموذج يدويًا على نماذج المدخل، مما يعطيك فرصة لمراجعة المتطلبات وتقييم جوانب قابلية الاستخدام.
  • توجد قيود معينة على النموذج والأعمدة التي يتم عرضها، على سبيل المثال، لا يتم عرض عناصر تحكم PCF. لمزيد من المعلومات، راجع حول نماذج الجدول.
  • لن يتم تشغيل قواعد العمل من جانب العميل وJavaScript، التي تعد أجزاء أساسية من نموذج يستند إلى النموذج، في المدخل. من السهل الإغفال وقد يكون له عواقب غير مقصودة.
  • يجب الأخذ بعين الاعتبار أن هناك اعتبارات خاصة عند عرض مخطط زمني، وملاحظات، وسجلات مرتبطة لأنه ليست كل الجوانب الوظيفية مدعومة (أو مطلوبة) في المداخل.

الوضع

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

ملاحظة

سيتم عرض نموذج في وضع تحرير كوضع للقراءة فقط إذا لم يكن لدى المستخدم امتيازات الكتابة للسجل.

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

  • سلسلة استعلام - هذا الإعداد هو الإعداد الافتراضي عند إنشاء نموذج جدول في استوديو المداخل. عندما يتم عرض الصفحة التي تحتوي على النموذج، من المتوقع أن يكون معرف السجل جزءًا من سلسلة الاستعلام، على سبيل المثال https://contoso.powerappsportals.com/contacts/edit/?id=<contact guid>. عادة، يتم إجراء هذا الإعداد تلقائيًا عند ربط النموذج بقائمة جداول. وهذا الإعداد هو الأكثر شيوعًا إلى حد بعيد.
  • مستخدم المدخل الحالي - يتم تكوين هذا الخيار داخل تطبيق إدارة المدخل. عند تحديد هذا الخيار، سيقوم النموذج بتحميل المعلومات من سجل مستخدم المدخل الحالي دون استخدام معلومات إضافية من عنوان URL للصفحة. وبشكل عام، يستخدم هذا الخيار لعرض نموذج ملف تعريف مستخدم. في هذه الحالة، يجب تعيين عمود اسم الجدول إلى جهة اتصال لأنه يتم تمثيل مستخدمي المدخل بواسطة جدول جهة الاتصال.
  • ‏‫السجل المقترن بمستخدم المدخل الحالي‬ - يتم تكوين هذا الخيار داخل تطبيق إدارة المدخل. يتيح لك تحديد هذا الخيار إمكانية تحرير السجلات المقترنة، مثل تفاصيل الحساب الأصلي للمستخدم الحالي. يجب تحديد اسم العلاقة لتحديد السجل المراد تحريره. ويجب أن يتطابق نوع الجدول المحدد مع التحديد الموجود في عمود اسم الجدول. ويعتبر هذا الخيار مفيدًا في سيناريوهات الشركاء التي قد يكون فيها لمؤسسة الشركاء العديد من مستخدمي المدخل. قد يكون بعض هؤلاء المستخدمين مخولين لتحرير سجل الحساب الأصلي.

يعتبر الجدول، و النموذج، و الوضع هي التفاصيل المطلوبة لعرض النموذج.

تكوين نموذج الجدول

خيارات التكوين الإضافية للتحكم في مظهر النموذج وسلوكه متوفرة داخل استوديو المداخل.

لقطة شاشة لتكوين نموذج الجدول بإعدادات النموذج عند النجاح.

‏‫إعدادات النموذج عند النجاح‬

تحدد إعدادات النموذج عند النجاح الإجراءات التي يتم اتخاذها عند إرسال النموذج بنجاح إلى المدخل.

  • إظهار رسالة النجاح - يعرض رسالة عند إرسال نموذج.
  • ‏‫إعادة توجيه إلى صفحة ويب‬ - الانتقال تلقائيًا إلى صفحة ويب عند إرسال النموذج بنجاح.
  • ‏‫إعادة توجيه إلى URL‬ - يعيد التوجيه إلى عنوان URL (المدخل أو الخارجي).

الإعدادات المتقدمة

تحدد ميزة الإعدادات المتقدمة ما إذا كان يتم عرض captcha للمستخدمين المجهولين أو المصادق عليهم. ويساعد الإعداد أيضًا في تحديد ما إذا كانت أذونات الجدول ممكّنة للجدول المحدد.

إعدادات نموذج الجدول الإضافية

تتوفر إعدادات التكوين الإضافية لنماذج الجدول في تطبيق إدارة المدخل. للوصول إلى نموذج جدول في تطبيق إدارة المدخل:

  1. انتقل إلى Power Apps صانع البوابة.
  2. حدد البيئة المُستهدفة باستخدام مُحدد البيئة في الزاوية العلوية اليُسرى.
  3. من قائمة التطبيقات، اعثر على تطبيق إدارة المدخل وافتحه (سيكون النوع يستند إلى النموذج).
  4. حدد نماذج الجدول في جزء التنقل الأيمن.
  5. افتح النموذج الذي قمت بإنشائه مسبقًا في استوديو المداخل.

لقطة شاشة لبيانات تعريف إدارة مداخل نموذج الجدول.

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

رسم تخطيطي لبنية نموذج الجدول ونظرة عامة حولها.

التكوين

تصف الأقسام التالية الطرق المختلفة التي يمكنك استخدامها لتكوين نماذج الجدول.

خيارات النموذج

تدعم معظم خيارات النموذج تخصيص عناصر أوراق الأنماط المتتالية (CSS) لتغيير المظهر المرئي. يمكن تحديد عناصر النص مثل التسميات، والرسائل، والتلميحات بلغات متعددة. على سبيل المثال، يتم "حفظ" الرسالة الافتراضية بعد إرسال النموذج، ولكن يمكن تخصيصها لكل من لغات المدخل الممكّنة.

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

إعدادات إضافية

تحدد الإعدادات الإضافية الجوانب الأخرى لسلوك النموذج، مثل التصميم، وترجمة عناصر واجهة المستخدم (UI)، وما إلى ذلك.

تلميح

بعض الإعدادات وخيارات التكوين مخفية. حدد خانة الاختيار إعدادات متقدمة لعرض كل الخيارات المتوفرة.

‏‫إقران مستخدم المدخل الحالي عند الإدراج‬ - يمكن استخدام هذا الخيار لتتبع جهات اتصال المدخل التي قامت بإنشاء السجل أو تحديثه. ينشئ هذا الإعداد مكافئ مدخل لعمود ‏‫تم الإنشاء بواسطة‬‬‬‬ وعمود ‏‫تم التعديل بواسطة‬‬‬‬ في Dataverse. يمكنك أيضًا تعيين علاقات أبوية إن أمكن. على سبيل المثال، في حالة إنشاء سجل حساب جديد، قد ترغب في تعيين جهة الاتصال الحالية كجهة اتصال رئيسية تلقائيًا.

إضافة إرفاق ملف - يتوفر عدد من الخيارات لإضافة عنصر تحكم تحميل ملف إلى النموذج الخاص بك. يتميز التكوين بالمرونة ويدعم ملفات متعددة، وخيارات التخزين، ونوع mime، وقيود الحجم (على سبيل المثال، يمكنك تقييد تحميلات الصور بحجم يصل إلى 2 ميغابايت).

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

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

لقطة شاشة لنموذج الجدول مع تمكين الموقع الجغرافي.

مرجع الجدول

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

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

الإجراءات

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

تتضمن جميع الأوامر خيارات لإعادة تسمية الأزرار وتغيير مواضعها في النموذج.

بيانات تعريف نموذج الجدول

تتيح لك سجلات بيانات تعريف نموذج الجدول التحكم في مظهر وسلوك عناصر النموذج الفردية، بما في ذلك:

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

أضف نموذج جدول إلى المدخل الإلكتروني لديك

يحدد نموذج جدول السلوك المطلوب ولكن لا يتضمن معلومات حول طريقة عرض النموذج بالموقع ومكان هذا العرض. هناك طريقتان لعرض نموذج جدول في مدخل وهما:

  • يمكن تحديد نموذج الجدول بشكل صريح كهدف لإجراء قائمة جداول مثل إنشاء، أو تحديث، أو تحرير. في هذه الحالة، سيتم عرض النموذج في نافذة منبثقة مشروطة. تنطبق قيود معينة عند عرض النموذج في نافذة منبثقة، على سبيل المثال، لا تتوفر القدرة على إنشاء سجلات مرتبطة من الشبكات الفرعية.
  • وبشكل مماثل لقائم جداول، يمكن إضافة مكون نموذج جدول إلى صفحة ويب من استوديو المداخل. سيقوم هذا الإجراء بوضع علامة Liquid على نسخة صفحة ويب لعرض نموذج الجدول.
{% tableform name: '<<table form name>>' %}

لقطة شاشة لعلامة liquid لمحرر رمز نموذج الجدول.

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

يوضح الفيديو التالي كيفية توسيع وظائف قائمة الجداول مع نماذج الجدول وعرض سجل Dataverse في نافذة منبثقة أو على صفحة ويب منفصلة.