استخدَام Power Fx
Power Fx هي لغة منخفضة التعليمَات البرمجية سيتم استخدَامهَا عبر Microsoft Power Platform. قد تكون معتَادًا عَلى Power Fx إذا كنت قد أنشأت تَطبِيق اللوحة من Power Apps. يمكن أيضًا استخدَام Power Fx لتنفيذ منطق مخصص باستخدَام أوامر شريط الأوامر الذي يستند إلى النموذج من Power Apps. يمكن أن يستخدم منطق شريط الأوامر مجموعة فرعية من الإمكَانيَات كَاملة للغة Power Fx.
يوجد مكَانَان يمكنك استخدَام Power Fx عند تخصيص أمر مَا:
OnSelect - يتم تنفيذ هذا المنطق عند تحديد زر أمر من قبل المستخدم.
مرئي - يتم تنفيذ هذا المنطق لتقييم مَا إذا كَان الأمر يجب أن يكون مخفيًا أم مرئيًا للمستخدم الذي يقوم بتشغيل التَطبِيق.
تكوين OnSelect
لاستخدَام منطق Power Fx عند تحديد الأمر، تأكد من تكوين خَاصية الإجرَاء لتشغيل المعَادلة. يمكنُك العُثور عَلى الإجرَاء فِي جُزءِ الأوامِر عَلى الجَانبِ الأيسَر مِن الشَاشَة.
عند التكوين، يتم تمكين شريط المعَادلة ويمكن توفير منطق Power Fx. هذا الخيَار هو الخيَار الافترَاضي للأوامر الجديدة. ومع ذلك، إذا تم تعطيل شريط المعَادلة، فمن المحتمل أنك تعمل باستخدَام أمر يستخدم JavaScript للمنطق.
باستخدَام شريط المعَادلة فِي أعلى الصفحة، يمكنك تقديم منطقك المخصص.
المعَادلة الافترَاضية هي ببسَاطة "true" ولا ينتج عنهَا حدوث أي إجرَاء. يجب عليك توفير المنطق الخَاص بك للأمر لأدَاء أي إجرَاء عند تحديده.
يمكنك أيضًا تحديد شريط المعَادلة المفتوح فِي جُزء الأمر، والذي سيركز عَلى شريط المعَادلة لإجرَاء التغييرَات.
عندمَا يحدد المستخدم الأمر، يتم حفظ أي تغييرَات معلقة فِي بيَانَات النموذج ثم يتم تنفيذ الأمر OnSelect logic. يضمن هذا الأمر حَالة متسقة من البيَانَات فِي وقت تنفيذ الأمر.
تكوين الرؤية
بشكل افترَاضي، ستكون الأوامر الجديدة المضَافة إلى شريط الأوامر مرئية. عن طريق تغيير خَاصية رؤية الأمر إلى إظهَار معَادلة شرطية، يمكنك توفير معَادلة يتم تقييمهَا لتحديد مَا إذا كَان الأمر يجب أن يكون مرئيًا. يُمكنُ العُثور عَلى الرؤية وتَغيِيرهَا فِي جُزءِ الأوامِر الأيسَر.
بإمكَانك توفير منطق رؤية مخصص للأمر باستخدَام شريط المعَادلة الموجود فِي الجُزء العلوي من الصفحة.
تذكر أن المعَادلة الافترَاضية هي "true"، مَا يجعل الأمر مرئيًا دَائمًا. لتَغيِير الإعدَاد الافتِرَاضِي، يجبُ عَليكَ تَقدِيم مَنطِق الصواب/الخَطأ الخَاص بك. إذا أدت معَادلتك إلى نتيجة خَاطئة، فلن يكون الأمر مرئيًا.
إذا تغير أي من قيمهَا التَابعة، تتم إعَادة تقييم معَادلة الرؤية. يتيح هذا الأمر رؤية الأمر للاستجَابة للحَالة الحَالية للبيَانَات وإجرَاءَات المستخدم. على سبيل المثَال، قد يكون الزر مرئيًا بعد تحديد جميع الصفوف فِي الشبكة.
البيَانَات النشطة حَاليًا
القدرة عَلى الرجوع إلى البيَانَات النشطة حَاليًا الميزة القيمة عند كتَابة المعَادلات للأوامر. على سبيل المثَال، البيَانَات النشطة الحَالية هي الصف إذا كَان شريط الأوامر موجودًا فِي النموذج الرئيسي لصف جدول. تكون البيَانَات النشطة الحَالية هي جدول الصفوف المعروضة عَلى الشبكة إذا كَان شريط الأوامر موجودًا عَلى الشبكة الرئيسية.
باستخدَام الخَاصية المحددة، يمكنُك الوصول إلى البيَانَات النشطة الحَالية. يتم ملء الخَاصية المحددة تلقَائيًا فِي وقت التشغيل. تحتوي الخَاصية المحددة عَلى حقول متعددة متَاحة؛ وتعتمد الحقول المتَاحة عَلى مَا إذا كَان تم تحديد عنصر واحد أو جدول عنَاصر.
| الحَقل | النَوع | الوَصف |
|---|---|---|
| الصنف | سجل من DataSource | متَاح فقط عند تحديد صف واحد أو عند عرض صف واحد فِي نموذج. سيتم تعيينهَا إلى فارغة عندمَا لا يتم ملؤهَا بالسكَان. على سبيل المثَال، ستتحقق المعَادلة التَالية من قيمة عمود تصنيف الحسَاب. Self.Selected.Item.'Account Rating'>20 |
| AllItems | جدول السجلات من DataSource | جميع الصفوف المحددة من DataSource. على سبيل المثَال، ستتحقق المعَادلة التَالية من العدد المحدد. CountRows(Self.Selected.AllItems) > 0 |
| الحَالة | التعدَاد | يشير إلى مَا إذا كَان عنصر تحكم الاستضَافة فِي الحَالة Edit (=0) أو New (=1) أو View (=2). |
| غير محفوظ | قيمة منطقية | يعود صَحِيحًا إذا كَانت Selected أو SelectedItems بهَا تغييرَات غير محفوظة. وإلا ترجع خطأ. |
البيَانَات من مصَادر البيَانَات
بالإضَافة إلى العَمَل مع البيَانَات من الخَاصية Selected، يمكنك أيضًا الاستعلام عن البيَانَات وحفظهَا فِي جدَاول Microsoft Dataverse أخرى. على سبيل المثَال، يؤدي الأمر التَالي إلى تغيير الاسم فِي صف الحسَاب إلى "اسم الحسَاب الجديد".
Patch(Accounts, Self.Selected.Item, {'Account Name': "New Account name"})
يمكنك أيضًا استخدَام العلاقَات بين الجدَاول للوصول إلى الصفوف ذات الصلة. على سبيل المثَال، تقوم المعَادلة التَالية بالوصول إلى المواعيد المتكررة ذات الصلة للعنصر المحدد حَاليًا.
Self.Selected.Item.'Recurring Appointments'
حَاليًا، Microsoft Dataverse هو مصدر البيَانَات الوحيد المتَاح لاستخدَام منطق الأوامر.
السينَاريوهَات الشَائعة
يتيح استخدَام منطق Power Fx فِي الأمر التعَامل مع مجموعة واسعة من حَالات الاستخدَام التي ستواجههَا. فيمَا يلي بعض الأمثلة عَلى حَالات الاستخدَام الشَائعة التي يمكنك تنفيذهَا:
قم بإنشَاء صفوف ذات صلة بنَاءً عَلى البيَانَات الحَالية. على سبيل المثَال، قم بإنشَاء سلسلة من مكَالمَات المتَابعة المجدولة بنَاءً عَلى قيمة الفرصة المحتملة.
انتقل إلى مواقع الويب الدَاخلية أو الخَارجية. على سبيل المثَال، يمكنك إجرَاء بحث عَلى موقع إخباري عن الشركة الحَالية بتمرير اسم شركة الصف كمعَامل بحث.
تعديل البيَانَات فِي الصف الحَالي. على سبيل المثَال، قد يكون لديك جدول خدمة يتتبع عملاء الخدمة النشطين. يمكنك تحديد أمر فِي صف غير نشط لإعَادة تنشيط الخدمة للعميل عن طريق تعيين قيم مختلفة فِي الصف لتعكس حَالة الخدمة الجديدة.
استخدم RecordInfo للتأكد من ظهور الأوامر فِي الوقت المنَاسب. يمكن استخدَام RecordInfo للحصول عَلى معلومَات حول سجل معين لمصدر البيَانَات. على سبيل المثَال، يمكنك التحقق ممَا إذا كَان المستخدم لديه إذن تحرير الأمر وإظهَاره فقط إذا كَان يفعل ذلك.
عندمَا تبدأ فِي تنفيذ منطق أوامر Power Fx، سيتم إلهَامك لإنشَاء حَالات استخدَام فريدة أخرى لتَطبِيقَاتك الخَاصة.