إنشاء تعبيرات باستخدام Power Fx

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

ملحوظة

تستخدم صيغ Power Fx في Copilot Studio الترقيم بنمط الولايات المتحدة. أي أن الفاصل العشري هو نقطة، كما هو الحال في 12,567.892. وهذا يعني أنك يجب أن تستخدم الفواصل (,) كفواصل بين المعلمات في صيغ Power Fx الخاصة بك.

المتطلبات المسبقه

• إنشَاء المواضيع وتحريرهَا
• نظرة عامة على المتغيرات

استخدام المتغيرات في صيغة

لاستخدام متغير في صيغة Power Fx، يجب إضافة بادئة إلى اسمه للإشارة إلى نطاق المتغير:

• بالنسبة لمتغيرات النظام، استخدم System.
• بالنسبة للمتغيرات العمومية، استخدم Global.
• بالنسبة لمتغيرات الموضوع، استخدم Topic.
• بالنسبة لمتغيرات البيئة، استخدم Environment.

على سبيل المثال، لاستخدام متغير Conversation.Id النظام في صيغة، ارجع إلى متغير النظام ك System.Conversation.Id.

استخدام القيم الحرفية في صيغة

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

النوع	أمثلة على التنسيق
السلسلة	"hi"، "hello world!"، "copilot"
بوليان	فقط true أو false
الرقم‬	1، ، 532، 5.258-9201
السجل والجدول	[1]، [45, 8, 2]، ["cats", "dogs"]، { id: 1 }، ، { message: "hello" }{ name: "John", info: { age: 25, weight: 175 } }
التاريخ والوقت	Time(5,0,23)، Date(2022,5,24)، DateTimeValue("May 10, 2022 5:00:00 PM")
الاختيار	غير مدعوم
فارغ	فقط Blank()

صيغ Power Fx الشائعة

يسرد الجدول التالي أنواع البيانات وصيغ Power Fx التي يمكنك استخدامها مع كل نوع بيانات.

النوع	صيغ Power Fx
السلسلة	دالة النص دالة الجمع ودالة الدمج دالة لين الوظائف السفلى والعليا والصحيحة دوال IsMatch وMatch وMatchAll دالتي النهاية والبداية إيجاد دالة وظيفة الاستبدال والاستبدال
بوليان	الدالة البوليانية دوال "و"، و"أو"، و"ليس" الدالتان If وSwitch
الرقم‬	الدوال العشرية، والعشرية العائمة، والقي دوال Int و Round و RoundDown و RoundUp و Trunc
السجل والجدول	دالة الجمع ودالة الدمج دوال Count، وCountA، وCountIf، وCountRows دالة ForAll أولا، دوال FirstN، Index، Last، وLastN وظائف التصفية، والبحث، والاسترجاع دالة JSON دالة ParseJSON
التاريخ والوقت	دوال التاريخ والتاريخ والوقت دوال DateValue وTimeValue وDateTimeValue اليوم، الشهر، السنة، الساعة، الدقيقة، الثانية، وأيام الأسبوع الآن، اليوم، وظيفة IsToday، وظیفة UTCNow، وظیفة UTCToday، وظیفة IsUTCToday دوال DateAdd وDateDiff وTimeZoneOffset دالة النص
فارغ	دوال Blank و Coalesce و IsBlank و IsEmpty Error، IfError، IsError، IsBlankOrError دوال

استخدام Power Fx لتعيين متغير

في هذا المثال، يقوم تعبير Power Fx بتخزين اسم العميل وإخراجه بأحرف كبيرة.

1. إنشاء موضوع وإضافة عقدة سؤال .

2. بالنسبة إلى إدخال رسالة، أدخل "ما هو اسمك؟".

3. ضمن تحديد، حدد الكيان اسم الشخص.

4. حدد المربع ضمن حفظ استجابة المستخدم باسم، ثم حدد المتغير Var1 وقم بتسمية .customerName

5. ضمن عقدة السؤال ، حدد + ثم حدد تعيين قيمة متغيرة.

6. حدد المربع ضمن تعيين متغير، ثم حدد إنشاء جديد وقم بتسمية .capsName

7. في مربع إلى قيمة حدد السهم >، ثم حدد علامة التبويب صيغة.

8. في مربع fx ، أدخل Upper(Text(Topic.customerName))، ثم حدد إدراج.

   

9. ضمن عقدة السؤال ، حدد + ثم حدد إرسال رسالة.

10. أدخل "HELLO "، وحدد {x}، ثم حدد capsName.

    

استخدام صيغة Power Fx كشرط

لتقييم تعبيرات أكثر تعقيدا، قم بإعداد عقد الشرط لاستخدام صيغ Power Fx.

في هذا المثال، يحدد العامل ما إذا كان تاريخ الحجز مؤهلا للحصول على خصم. للقيام بذلك، فإنه يتحقق مما إذا كان تاريخ الحجز الذي يقدمه العميل هو 14 يوما أو أكثر من التاريخ الحالي.

1. إنشاء موضوع وإضافة عقدة سؤال .

2. بالنسبة إلى إدخال رسالة، أدخل "تاريخ الحجز؟".

3. ضمن تحديد، حدد الكيان التاريخ والوقت.

4. حدد المربع ضمن حفظ استجابة المستخدم باسم، ثم حدد المتغير Var1 وقم بتسمية .bookingDate

   

5. حدد أيقونة إضافة عقدة أسفل عقدة السؤال، ثم حدد إضافة شرط.

6. حدد النقاط الثلاث (...) لعقدة الشرط ، ثم حدد تغيير إلى صيغة.

7. في المربع دالة ، حدد السهم > ، ثم حدد علامة التبويب صيغة .

8. استبدل محتويات مربع fx بالصيغة Topic.bookingDate > (DateAdd (Now(), 14))، ثم حدد إدراج.

9. ضمن عقدة الشرط ، أضف عقدة رسالة وأدخل الرسالة "أنت مؤهل للحصول على خصم. "

10. ضمن عقدة جميع الشروط الأخرى ، أضف عقدة رسالة وأدخل الرسالة، "عذرا، أنت غير مؤهل للحصول على خصم."