Blank Coalesceالدالات IsBlankو IsEmpty

Functions	ينطبق على
Blank	تطبيقات Canvas Copilot Studio Desktop تتدفق أعمدة صيغة Dataverse التطبيقات المستندة إلى النموذج وظائف Power Platform CLI Dataverse
Coalesce IsEmpty	تعمل تطبيقات Canvas Copilot Studio Desktop على تدفقات التطبيقات المستندة إلى نموذج Power Platform CLI Dataverse لوظائف Power Pages
IsBlank	تطبيقات Canvas Copilot Studio Desktop تتدفق أعمدة صيغة Dataverse التطبيقات المستندة إلى النموذج وظائف Power Platform CLI Dataverse Power Pages

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

النظرة العامة

Blankهو عنصر نائب ل "بلا قيمة" أو "قيمة غير معروفة". على سبيل المثال، تكون الخاصية Selected لعنصر تحكم مربع التحرير والسردفارغة إذا لم يقم المستخدم بإجراء تحديد. يمكن للعديد من مصادر البيانات تخزين قيم فارغة وإرجاعها، والتي يتم تمثيلها في Power Apps باعتبارها فارغة.

أي خاصية أو قيمة محسوبة في Power Apps قد تكون فارغة. على سبيل المثال، تحتوي القيمة المنطقية عادةً على إحدى القيمتين: صواب أو خطأ. ولكن بالإضافة إلى هذين الاثنين، يمكن أن يكون فارغا أيضا مما يشير إلى أن الحالة غير معروفة. يشبه هذا Microsoft Excel، حيث تبدأ خلية ورق عمل كفارغة دون أي محتيات ولكن يمكنها الاحتفاظ بقيمتي صواب أو خطأ (من بين قيم أخرى). في أي وقت، يمكن مسح محتويات الخلية مرة أخرى ، وإعادتها إلى الحالة فارغة.

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

في سياق الدالة، تكون فارغةIsEmpty خاصة بالجداول التي لا تحتوي على سجلات. وقد تكون بنية الجدول دون تغيير وكاملة مع أسماء الأعمدة، ولكن لا توجد بيانات في الجدول. قد يبدأ الجدول فارغًا ، ويحتفظ بالسجلات ولم يعد فارغًا ، ثم يُزال السجلات ثم يكون فارغًا مرة أخرى.

Blank

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

IsBlank

تختبر IsBlank الدالة قيمة فارغة أو سلسلة فارغة. يتضمن الاختبار سلاسل فارغة لتسهيل إنشاء التطبيق نظرا لأن بعض مصادر البيانات وعناصر التحكم تستخدم سلسلة فارغة عندما لا تكون هناك قيمة موجودة. للاختبار خصيصا لقيمة فارغة ، استخدم if(Value = Blank(), ... بدلا من IsBlank. IsBlank تعتبر الدالة الجداول الفارغة غير فارغةIsEmpty، ويجب استخدامها لاختبار جدول.

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

القيمة المرجعة ل IsBlank هي قيمة منطقية صحيحة أو خاطئة.

Coalesce

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

Coalesce( value1, value2 ) هو المكافئ If( Not IsBlank( value1 ), value1, Not IsBlank( value2 ), value2 ) الأكثر إيجازا ولا يتطلب تقييم value1 و value2 مرتين. ترجع الدالة Ifفارغة إذا لم تكن هناك صيغة "أخرى" كما هو الحال هنا.

يجب أن تكون كافة الوسيطات من Coalesce نفس النوع؛ على سبيل المثال، لا يمكنك خلط الأرقام مع السلاسل النصية. القيمة المرجعة من Coalesce هي من هذا النوع الشائع.

IsEmpty

تختبر IsEmpty الدالة ما إذا كان الجدول يحتوي على أي سجلات. إنها مكافئة لاستخدام وظيفة CountRows وتتحقق من الصفر. يمكنك التحقق من وجود أخطاء مصدر البيانات عن طريق الجمع IsEmpty مع الدالة Errors .

القيمة المرجعة ل IsEmpty هي قيمة منطقية صحيحة أو خاطئة.

بناء الجملة

Blank()

Coalesce( Value1 [, Value2, ... ] )

• القيم - مطلوب. القيم المُراد اختبارها. يتم تقييم كل قيمة بالترتيب حتى يتم العثور على قيمة غير فارغة وليست سلسلة فارغة. لا يتم تقييم القيم بعد هذه النقطة.

IsBlank( قيمة )

• القيمة - مطلوبة. القيمة المراد اختبارها لقيمة فارغة أو سلسله فارغة.

IsEmpty( جدول )

• الجدول - مطلوب. الجدول المراد اختباره للسجلات.

الأمثلة

Blank

1. أنشئ تطبيقًا من البداية، وأضف عنصر تحكم Button.

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

   ClearCollect( Cities, { Name: "Seattle", Weather: "Rainy" } )
   

3. قم بمعاينة تطبيقك، وانقر أو اضغط على الزر الذي أضفته، ثم أغلق المعاينة.

4. في قائمة الملف، انقر فوق أو اضغط على المجموعات.

   تظهر مجموعة المدن، مع عرض سجل واحد لمدينة "سياتل" و"ممطر":

   

5. المس أو انقر فوق سهم للخلف للرجوع إلى مساحة العمل الافتراضية.

6. أضف عنصر تحكم Label، وقم بتعيين خاصية Text الخاص بها إلى هذه الصيغة:

   IsBlank( First( Cities ).Weather )
   

   تُظهر التسمية خطأ لأن حقل الطقس يحتوي على قيمة ("ممطر").

7. أضف زرًا ثانيًا، وقم بتعيين خاصية OnSelect الخاصة به إلى هذه الصيغة:

   Patch( Cities, First( Cities ), { Weather: Blank() } )
   

8. قم بمعاينة تطبيقك، وانقر أو اضغط على الزر الذي أضفته، ثم أغلق المعاينة.

   يتم استبدال حقل الطقس الخاص بالسجل الأول في المدن بـ فارغ، مما يؤدي إلى إزالة "ممطر" التي كانت موجودة من قبل.

   

   تُظهر التسمية صواب لأن حقل الطقس لم يعد يحتوي على قيمة.

Coalesce

صيغة	‏‏الوصف	نتيجة
Coalesce( ، Blank1 )	يختبر القيمة المرجعة من الدالة Blank التي تقوم دائما بإرجاع قيمة فارغة . ونظرًا لأن الوسيطة الأولى فارغة، يستمر التقييم مع الوسيطة التالية إلى أن يتم العثور على قيمة غير فارغة وسلسلة غير فارغة.	1
Coalesce( "", "2" )	اختبار الوسيطة الأولى، وهي سلسلة فارغة. ونظرًا لأن الوسيطة الأولى عبارة عن سلسلة فارغة، يستمر التقييم مع الوسيطة التالية إلى أن يتم العثور على قيمة غير فارغة وسلسلة غير فارغة.	2
Coalesce( Blank)، ""، Blank()، ""، "3"، "4" )	Coalesce يبدأ في بداية قائمة الوسيطات ويقيم كل وسيطة بدورها حتى يتم العثور على قيمة غير فارغة وسلسلة غير فارغة. في هذه الحالة، تُرجع جميع الوسيطات الأربعة الأولى قيمة فارغة أو سلسلة فارغة، لذا يستمر التقييم للوسيطة الخامسة. الوسيطة الخامسة هي قيمة غير فارغة وسلسلة غير فارغة، لذا تتوقف عمليه التقييم هنا. يتم إرجاع قيمة الوسيطة الخامسة، ولا يتم تقييم الوسيطة السادسة.	3
Coalesce( "" )	اختبار الوسيطة الأولى، وهي سلسلة فارغة. لأن الوسيطة الأولى عبارة عن سلسلة فارغة، ولم يعد هناك وسيطات، تُرجع الوظيفة فارغ.	خلبي

IsBlank

1. أنشئ تطبيقًا من البداية، وأضف عنصر تحكم في إدخال النص، وقم بتسميته FirstName.

2. أضف تسمية، وعيِّن خاصية Text على هذه الصيغة:

   If( IsBlank( FirstName.Text ), "First Name is a required field." )
   

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

3. قم بإزالة كافة الأحرف من عنصر تحكم إدخال النص، بما في ذلك أي مسافات.

   نظرا لأن الخاصية Text لم تعد تحتوي على أي أحرف، فهي سلسلة فارغة، و IsBlank( FirstName.Text )صحيحة. يتم عرض رسالة الحقل المطلوبة.

للحصول على معلومات حول كيفية إجراء التحقق باستخدام أدوات أخرى، راجع وظيفة Validate والتعامل مع مصادر البيانات.

الأمثلة الأخرى:

صيغة	‏‏الوصف	نتيجة
IsBlank( Blank() )	يختبر القيمة المرجعة من الدالة Blank التي تقوم دائما بإرجاع قيمة فارغة .	صحيح
IsBlank( "" )	سلسلة لا تحتوي على أي أحرف.	صحيح
IsBlank( "مرحبا")	سلسلة تحتوي على حرف واحد أو أكثر.	خطأ
IsBlank( AnyCollection )	نظرًا لأن المجموعة موجودة، فإنها لا تكون فارغة، حتى لو لم تحتوي على أي سجلات. للتحقق من وجود مجموعة فارغة، استخدم IsEmpty بدلا من ذلك.	خطأ
IsBlank( Mid( "Hello", 17, 2 ) )	يقع حرف البداية في Mid بعد نهاية السلسلة. والنتيجة هي سلسلة فارغة.	صحيح
IsBlank( if( false, false ) )	وظيفة If دون أي ElseResult. نظرًا لأن الشرط دائمًا ما يكون خطأ، غالبًا ما تُرجع وظيفة If هذه قيمة فارغة.	صحيح

IsEmpty

1. أنشئ تطبيقًا من البداية، وأضف عنصر تحكم Button.

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

   جمع( IceCream, {Flavor: "الفراولة", الكمية: 300}, {Flavor: "Chocolate", Quantity: 100} )

3. قم بمعاينة تطبيقك، وانقر أو اضغط على الزر الذي أضفته، ثم أغلق المعاينة.

   يتم إنشاء مجموعة تسمى IceCream وتحتوي على هذه البيانات:

   

   تشتمل هذه المجموعة على سجلين ولا تكون فارغة. IsEmpty( IceCream ) ترجع false، و CountRows( IceCream ) ترجع 2.

4. أضف زرًا ثانيًا، وقم بتعيين خاصية OnSelect الخاصة به إلى هذه الصيغة:

   كلير (آيس كريم)

5. قم بمعاينة تطبيقك، وانقر أو اضغط على الزر الثاني، ثم أغلق المعاينة.

   المجموعة فارغة الآن:

   

   تقوم وظيفة Clear بإزالة جميع السجلات من مجموعة، مما يؤدي إلى مجموعة فارغة. IsEmpty( IceCream ) ترجع true، و CountRows( IceCream ) ترجع 0.

يمكنك أيضا استخدام IsEmpty لاختبار ما إذا كان الجدول المحسوب فارغا، كما تظهر هذه الأمثلة:

صيغة	‏‏الوصف	نتيجة
IsEmpty( [ 1, 2, 3 ] )	يحتوي الجدول ذو العمود الواحد على ثلاثة سجلات، وبالتالي فهو ليس فارغًا.	خطأ
IsEmpty( [ ] )	لا يحتوي الجدول ذو العمود الواحد على أي سجلات، وبالتالي فهو فارغ.	صحيح
IsEmpty( Filter( [ 1, 2, 3 ], Value > 5 ) )	لا يحتوي الجدول ذو العمود الواحد على قيم أكبر من 5. لا تحتوي نتيجة التصفية على أي سجلات وهي فارغة.	صحيح