WHERE ER وظيفة

تُرجع الوظيفة WHERE القائمة المُحددة كقيمة قائمة السجلات بعد أن تمت تصفيتها وفقًا للشرط المُحدد.

بناء الجملة

WHERE (list, condition)

الوسائط

list: قائمة السجلات

مسار صالح لمصدر بيانات من نوع البيانات قائمة السجلات.

condition: منطقي

تعبير شرطي صالح يُستخدم لتصفية سجلات القائمة المُحددة.

إرجاع القيم

قائمة السجلات

قائمة السجلات الناتجة.

ملاحظات الاستخدام

تختلف هذه الوظيفة عن وظيفة FILTER ، لأن يتم تطبيق الشرط المُحدد على أي من مصادر بيانات التقارير الإلكترونية (ER) لنوع قائمة السجلات الموجودة في الذاكرة.

إذا كانت هذه الوسيطات المكونة لهذه الوظيفة (list وcondition) تسمح بترجمة هذا الطلب للاستدعاء المباشر لـ SQL، يتم طرح رسالة تحذيرية في وقت التصميم. تُعلم هذه الرسالة المستخدم أنه يُمكنه تحسين الأداء إذا تم استخدام الوظيفة FILTER بدلًا من WHERE.

مثال1

إذا تم تكوين Vendor كمصدر بيانات تقارير إلكترونية يشير إلى جدول VendTable، يُرجع التعبير WHERE (Vendors, Vendors.VendGroup = "40") قائمة المورّدين التي تنتمي إلى مجموعة الموردين 40.

مثال2

إذا أدخلت مصدر البيانات DS من النوع الحقل المحسوب ، ويحتوي على التعبير SPLIT ("A|B|C", "|") ، يُرجع التعبير WHERE( DS, DS.Value = "B") قائمة بسجل واحد فقط يحتوي على النص "B" في حقل القيمة.

الموارد الإضافية

دالات القائمة